# Consent Cookie

{% hint style="warning" %}
La [Objet de consentement](/fr/fonctionnalites/consent-management/knowledge-base/consent-object.md) reçu via l'API onsite 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 cookie de consentement est obsolète.
{% endhint %}

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

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

## Nom

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

## Domaine

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

## Value

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

{% hint style="warning" %}
Le format du cookie de consentement n'est pas garanti à 100 % comme restant stable. Nous essayons de garder le format aussi stable que possible et de l'étendre avec une "approche append only (ajout de nouvelles informations avec un nouveau `@`)", mais des modifications 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 modèle suivant (les éléments optionnels sont entourés de `[]`).

`<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>]`

| Field                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                   | Valeur d’exemple                                                                                |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `<status>`                    | Statut qui indique si un visiteur a fourni son optin ou son optout.                                                                                                                                                                                                                                                                                                                                                                           | <p><code>1</code>: Le visiteur est en optout</p><p><code>0</code>: Le visiteur est en 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. Elle 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 plateforme Commanders Act.                                                                                                                                                                                                                                                                                                                                                                                                 | 34                                                                                              |
| `<consent_categories>`        | Liste séparée par des virgules des catégories optin ou optout. La signification dépend du champ `<status>` . Par ex. 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 virgule est remplacé par `%2C`. Certaines anciennes versions de bannière peuvent avoir la valeur `ALL` dans le cas où toutes les catégories sont en optout. | `2%2C12%2C13`                                                                                   |
| `<blocked_on_categories>`     | Liste séparée par des virgules des catégories bloquées. La valeur est encodée en URL. Par conséquent, le séparateur virgule est remplacé par `%2C`. Ces catégories ne sont pas répétées dans le champ `<consent_categories>` .                                                                                                                                                                                                                | `2%2C12`                                                                                        |
| `<updated_timestamp>`         | Timestamp UNIX indiquant la dernière mise à jour du consentement                                                                                                                                                                                                                                                                                                                                                                              |                                                                                                 |
| `<creation_timestamp>`        | Timestamp UNIX en millisecondes indiquant quand le consentement a été donné.                                                                                                                                                                                                                                                                                                                                                                  | `1592900933049`                                                                                 |
| `<to_expire_timestamp>`       | Timestamp UNIX indiquant quand le consentement expirera                                                                                                                                                                                                                                                                                                                                                                                       |                                                                                                 |
| `<tcf_vendor_consent_string>` | Informations de consentement du vendor (par ex. pour les vendors IAB TCF). Disponibles uniquement lorsque les vendors sont activés pour le compte et dans le cas où des vendors 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`

| Field           | Description                                                      |
| --------------- | ---------------------------------------------------------------- |
| `0`             | Le visiteur est en optin.                                        |
| `002`           | Le visiteur a donné son 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 donné son optin pour les catégories 1 et 3.        |
| `4`             | La catégorie 4 est bloquée.                                      |
| `1592900933049` | Le visiteur a donné son optin le mar. juin 23 2020 08:28:53.     |

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

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

| Field           | Description                                                      |
| --------------- | ---------------------------------------------------------------- |
| `1`             | Le visiteur est en optout                                        |
| `012`           | Le visiteur a donné son 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 appliqué un optout à toutes les catégories.        |
| `4`             | La catégorie 4 est bloquée.                                      |
| `1592900933049` | Le visiteur a appliqué un optout le mar. juin 23 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
