# Consent Object

L’objet Consent est une manière standardisée de représenter le consentement à travers toutes les méthodes de l’API JavaScript onsite (similaire au Consent String TCF de l’IAB). L’objet contient une `meta` propriété qui inclut des métadonnées comme la validité du cookie et un `consentement` propriété qui contient les paramètres de consentement actuels stockés dans le navigateur. L’API onsite et l’objet Consent sont la manière officielle d’accéder aux paramètres de consentement de Commanders Act CMP avec JavaScript. L’utilisation directe du [Consent Cookie](/fr/fonctionnalites/consent-management/knowledge-base/consent-cookie.md) est obsolète.

### Exemple d’objet Consent <a href="#example-consent-object" id="example-consent-object"></a>

```
{
    meta: {
        version: "1.0",
        tcfPolicyVersion: "2",
        siteId: "1234",
        bannerId: "12",
        bannerVersion: "50",
        consentId: "183049723840253",
        dateCreated: 1614174067000,
        dateUpdated: 1614185078030,
        dateExpires: 1614236789942
    },
    consent: {
        status: "all-on|all-off|mixed|unset",
        categories: {
            "1": {
                status: "on",
                required: true
            },
            "2": {
                status: "on|off|unset"
            },
            "tcf2_1": {
                status: "on|off|unset"
            },
            "tcf2_2": {
                status: "on|off|unset",
                legIntStatus: "on|off|unset"
            },
            "tcf2_sf_1": {
                status: "on|off|unset"
            }
        },
        vendors: {
          "1": {
                status: "on|off|unset"
          },
          "tcf2_1": {
                status: "on|off|unset"
          },
          "tcf2_2": {
                status: "on|off|unset",
                legIntStatus: "on|off|unset"
          },
          "acm_1": {
                status: "on|off|unset"
          }
        }
    }
}
```

### Propriétés meta <a href="#meta-properties" id="meta-properties"></a>

La `meta` la propriété inclut des métadonnées et le contexte du consentement qui a été fourni dans un navigateur.

| Property                | Description                                                                                             | Type   |
| ----------------------- | ------------------------------------------------------------------------------------------------------- | ------ |
| `meta.version`          | Version de l’objet Consent.                                                                             | String |
| `meta.tcfPolicyVersion` | Version du consentement TCF de l’IAB.                                                                   | String |
| `meta.siteId`           | ID du site Commanders Act associé au consentement.                                                      | String |
| `meta.bannerId`         | ID de la bannière associé au consentement.                                                              | String |
| `meta.bannerVersion`    | Version de la bannière associée au consentement.                                                        | String |
| `meta.consentId`        | ID du consentement stocké dans le `TCPID` cookie.                                                       | String |
| `meta.dateCreated`      | Horodatage auquel le consentement a été fourni (UNIX Epoch en millisecondes).                           | Number |
| `meta.dateUpdated`      | Horodatage auquel le consentement a été mis à jour pour la dernière fois (UNIX Epoch en millisecondes). | Number |
| `meta.dateExpires`      | Horodatage auquel le consentement expirera (UNIX Epoch en millisecondes).                               | Number |

### Propriétés du consentement <a href="#consent-properties" id="consent-properties"></a>

La propriété consent contient des informations détaillées sur le consentement fourni dans le navigateur.

| Property                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `consent.status`                           | Statut global du consentement, qui peut prendre l’une des valeurs suivantes : **all-on :** Toutes les catégories de consentement ont été acceptées.**all-off :** Toutes les catégories de consentement ont été refusées (sauf bloqué sur on).**mixed :** Certaines catégories de consentement ont été refusées.**unset :** Aucun consentement n’a encore été fourni.                                                          |
| `consent.categories[category_id].status`   | Statut d’une catégorie individuelle :**on :** Le consentement a été donné.**off :** Le consentement a été refusé.**unset :** Aucun consentement n’a encore été fourni (dans le cas où la position du bouton neutre est configurée, elle basculera vers la position du bouton neutre pour cette catégorie).​`category_id` est l’ID de catégorie configuré sous `Data Governance > Consent Management > Settings > Categories`. |
| `consent.categories[category_id].required` | La propriété a été définie sur bloqué sur on et le statut est toujours **on**.                                                                                                                                                                                                                                                                                                                                                |
| `consent.vendors[vendor_id].status`        | Statut d’un fournisseur individuel :**on :** Le consentement a été donné.**off :** Le consentement a été refusé.**unset :** Aucun consentement n’a encore été fourni (dans le cas où la position du bouton neutre est configurée, elle basculera vers la position du bouton neutre pour ce fournisseur).​`vendor_id` est l’ID du fournisseur configuré sous `Data Governance > Consent Management > Settings > Vendors`.      |

Les IDs de catégorie et de fournisseur sont précédés d’un identifiant s’ils sont gérés par un framework de consentement.

| Framework | Préfixe                                                                             |
| --------- | ----------------------------------------------------------------------------------- |
| `tcf2_`   | framework IAB TCF 2. Les fonctionnalités spéciales sont en plus préfixées par `sf_` |
| `acm_`    | les fournisseurs du mode de consentement supplémentaire de Google.                  |

​


---

# 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-object.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.
