> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/consent-management/knowledge-base/consent-cookie.md).

# Consent cookie

{% hint style="warning" %}
Le [Objet de consentement](/fr/fonctionnalites/consent-management/knowledge-base/consent-object.md) reçu via l’onsite API est désormais la méthode officielle pour accéder aux paramètres de consentement de Commanders Act Consent avec JavaScript. L’utilisation directe du consent cookie est obsolète.
{% endhint %}

Commanders Act Consent stocke le consentement des visiteurs du site web dans un 1st party cookie.

Cet article explique uniquement le consent cookie. [Ici](https://doc.commandersact.com/configure/cookies) vous pouvez trouver une liste de tous les cookie Commanders Act Consent.

## Nom

Le nom par défaut du consent cookie est `TC_PRIVACY`. Il peut être configuré dans `Data Governance > Consent > Settings`.

## Domaine

Le cookie est défini comme un 1st party cookie. Le sous-domaine/domaine du cookie peut être configuré dans `Data Governance > Consent > Settings`

## Valeur

La valeur se compose de plusieurs champs séparés par `@` symboles. Le séparateur peut être configuré dans `Data Governance > Consent > Settings` .

{% hint style="warning" %}
Le format du consent cookie n’est pas garanti à 100 % de rester stable. Nous essayons de garder le format aussi stable que possible et de l’étendre avec "append only approach (ajout de nouvelles informations avec un nouveau `@` )", mais des changements pourraient survenir dans un futur imprévisible en raison de l’espace de stockage limité dans les cookies.
{% endhint %}

La valeur du cookie suit le motif suivant (les éléments facultatifs sont encadrés par `[]`).

`<status>@<privacy_version>[|<tcf_version>]|<banner_id>|<site_id>@<consent_categories>@<blocked_on_categories>@<updated_timestamp>,<creation_timestamp>,<to_expire_timestamp>[@<tcf_vendor_consent_string>]`

| Champ                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                           | Valeur d'exemple                                                                          |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `<status>`                    | Statut qui indique si un visiteur a fourni son optin ou optout.                                                                                                                                                                                                                                                                                                                                                                                       | <p><code>1</code>: Le visiteur est optout</p><p><code>0</code>: Le visiteur est optin</p> |
| `<privacy_version>`           | Version de la bannière de confidentialité avec laquelle le visiteur a interagi.                                                                                                                                                                                                                                                                                                                                                                       | `008`                                                                                     |
| `<tcf_version>`               | Version du framework IAB TCF. Disponible uniquement si IAB est activé pour le compte et qu’une bannière IAB est utilisée pour gérer le consentement. Il suit ce format :`<tcf_global_vendor_list_specification_version>\|<tcf_policy_version>\|<tcf_global_vendor_list_version>`                                                                                                                                                                      | `2\|2\|42`                                                                                |
| `<banner_id>`                 | ID de la bannière de confidentialité avec laquelle le visiteur a interagi.                                                                                                                                                                                                                                                                                                                                                                            | 12                                                                                        |
| `<site_id>`                   | ID du site dans la Commanders Act Platform.                                                                                                                                                                                                                                                                                                                                                                                                           | 34                                                                                        |
| `<consent_categories>`        | Liste séparée par des virgules des catégories optin ou optout. La signification dépend du `<status>` champ. Par exemple, lorsque `<status>` est `0` alors le visiteur donne son consentement pour les catégories listées. La valeur est encodée en URL. Par conséquent, le séparateur de virgules est remplacé par `%2C`. Certaines anciennes versions de la bannière peuvent avoir la valeur `ALL` dans le cas où toutes les catégories sont optout. | `2%2C12%2C13`                                                                             |
| `<blocked_on_categories>`     | Liste séparée par des virgules des catégories blocked on. La valeur est encodée en URL. Par conséquent, le séparateur de virgules est remplacé par `%2C`. Ces catégories ne sont pas répétées dans le `<consent_categories>` champ.                                                                                                                                                                                                                   | `2%2C12`                                                                                  |
| `<updated_timestamp>`         | Horodatage UNIX indiquant quand le consentement a été mis à jour pour la dernière fois                                                                                                                                                                                                                                                                                                                                                                |                                                                                           |
| `<creation_timestamp>`        | Horodatage UNIX en millisecondes indiquant quand le consentement a été fourni.                                                                                                                                                                                                                                                                                                                                                                        | `1592900933049`                                                                           |
| `<to_expire_timestamp>`       | Horodatage UNIX indiquant quand le consentement expirera                                                                                                                                                                                                                                                                                                                                                                                              |                                                                                           |
| `<tcf_vendor_consent_string>` | Informations de consentement des fournisseurs (par ex. pour les fournisseurs IAB TCF). Disponible uniquement lorsque les fournisseurs sont activés pour le compte et dans le cas où des fournisseurs sont utilisés dans la bannière. La valeur est compressée et encodée pour conserver une petite taille de cookie.                                                                                                                                  | `AAAAAjkb23...`                                                                           |

## Exemples

### Exemple 1 : Optin pour certaines catégories

`0@002|12|3441@1%2C3@4@1592900933049@1592900933049`

| Champ           | Description                                                   |
| --------------- | ------------------------------------------------------------- |
| `0`             | Le visiteur est optin.                                        |
| `002`           | Le visiteur a fourni optin sur la version 002 de la bannière. |
| `12`            | L’ID de la bannière est 12.                                   |
| `3441`          | L’ID du site est 3441.                                        |
| `1%2C3`         | Le visiteur a fourni optin pour les catégories 1 et 3.        |
| `4`             | La catégorie 4 est blocked on.                                |
| `1592900933049` | Le visiteur a fourni optin le mar. 23 juin 2020 08:28:53.     |

### Exemple 2 : Optout pour toutes les catégories

`1@012|26|4221@@4@1592900933049@1592900933049`

| Champ           | Description                                                   |
| --------------- | ------------------------------------------------------------- |
| `1`             | Le visiteur est optout                                        |
| `012`           | Le visiteur a fourni optin sur la version 012 de la bannière. |
| `26`            | L’ID de la bannière est 26.                                   |
| `4221`          | L’ID du site est 4221.                                        |
|                 | Le visiteur a fourni optout pour toutes les catégories.       |
| `4`             | La catégorie 4 est blocked on.                                |
| `1592900933049` | Le visiteur a fourni optout le mar. 23 juin 2020 08:28:53.    |

{% hint style="info" %}
Bon à savoir : les caractères spéciaux tels que "@" ou "|" sont encodés dans la valeur du cookie\
%2C = ","\
%7C = "|"\
%40 = "@"
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/consent-management/knowledge-base/consent-cookie.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
