> 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/sources/sources-catalog/web/containers/setup-guides-for-developers/datalayer-setup.md).

# Configuration du Datalayer

Un Data Layer Commanders Act est un objet JavaScript qui contient les métadonnées d’un site web sous forme de propriétés, afin de les rendre disponibles aux Tags. Dans la plateforme, ce Data Layer est appelé « External Variables » pour le distinguer des « Internal Variables » générées par script dans le JavaScript du Container.

### Installation

Pour installer un Data Layer Commanders Act, il est nécessaire de mettre en place un objet JavaScript global `tc_vars` qui contient les métadonnées de la page sous forme de propriétés directes. Les propriétés requises du Data Layer sont définies lors de la configuration de Commanders Act, mais vous trouverez une liste de propriétés courantes sur [cette page](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/data-layer-and-data-types/external-variables.md).

{% hint style="info" %}
**Réutiliser un Data Layer existant**

Si un site web possède déjà un Data Layer, il est possible de le transformer en Data Layer Commanders Act. Veuillez contacter un consultant Commanders Act pour mettre en œuvre cette transformation.
{% endhint %}

La méthode utilisée pour renseigner les propriétés du Data Layer dépend du framework technologique utilisé sur le site web et peut aller du web scraping en JavaScript au templating ou au codage en dur.

```markup
<script>
    window.tc_vars = {
        env_template: "homepage",
        env_work: "prod",
        page_name: "Homepage",
        page_keywords: ["homepage", "home", "entrypage", "index"],
        product_name: "",
        (…)
    };

    window.tc_vars.user_name = "myuser";
</script>
<script src="{{ container_URL }}"></script>
```

Le Data Layer doit être renseigné avant le chargement du fichier Web Container ; sinon, certaines informations risquent de ne pas être disponibles au moment de l’exécution du JavaScript du Container.

{% hint style="warning" %}
**Conditions de concurrence**

Les conditions de concurrence entre les propriétés du Data Layer et le JavaScript du Container peuvent être difficiles à repérer et à déboguer pour les utilisateurs de Commanders Act. Il est donc important de les éviter lors de l’installation !
{% endhint %}

Si plusieurs Containers sont utilisés sur la même page, il est possible de renseigner le Data Layer en plusieurs étapes. Les informations globales, comme le type de page, doivent être disponibles avant le chargement du premier Container. Les informations pertinentes uniquement pour un Container donné (par exemple, les informations sur les produits) peuvent être ajoutées avant le Container correspondant.

L’exemple suivant montre comment installer un Data Layer lorsqu’un Container est utilisé dans le `<head>` et un autre dans le `<body>` d’un site web.

```markup
<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <script>
            window.tc_vars = Object.assign({}, window.tc_vars, {
                env_template: "homepage",
                env_work: "prod"
            });
        </script>
        <script src="{{ head_container_URL }}"></script>
        (…)
    <head>
    <body>
        (…)
        <script>
            window.tc_vars = Object.assign({}, window.tc_vars, {
                page_name: "Homepage",
                page_keywords: ["homepage", "home", "entrypage", "index"]
            });
        </script>
        <script src="{{ body_container_URL }}"></script>
    </body>
</html>
```

{% hint style="info" %}
**Convention de nommage du Data Layer**

Comme l’illustre l’exemple ci-dessus, les propriétés du Data Layer sont généralement regroupées à l’aide d’un préfixe. Par exemple, `env_` sert à regrouper les informations relatives à l’environnement et `user_` sert à regrouper les informations relatives à l’utilisateur.

Lorsqu’une propriété n’est pas pertinente pour une page donnée (par exemple, `product_name` sur la page de la politique de confidentialité), il est recommandé de lui attribuer une valeur vide (par exemple, `""`, `0`, `[]` ou `{}`).
{% endhint %}

### Tests

#### Via la console JavaScript

Il est possible d’examiner le Data Layer dans la console JavaScript en affichant `tc_vars`.

Vous trouverez ci-dessous un exemple de sortie d’un `tc_vars` Data Layer dans la console JavaScript.

```javascript
{
    env_template: "homepage",
    env_work: "prod",
    page_name: "Homepage",
    page_keywords: ["homepage", "home", "entrypage", "index"],
    product_name: "",
    (…)
}
```

#### Via le tag d’assurance qualité

Le modèle de tag *Commanders Act - Data Layer QA* de la bibliothèque de tags Commanders Act affiche automatiquement les informations du Data Layer dans la console JavaScript sur chaque page. Cette approche présente l’avantage d’enregistrer un instantané du Data Layer au moment précis où le JavaScript du Container est exécuté. Cela permet d’identifier les conditions de concurrence entre les propriétés du Data Layer et le JavaScript du Container, afin de s’assurer que toutes les propriétés nécessaires sont disponibles à temps.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/setup-guides-for-developers/datalayer-setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
