> 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/web-container-setup.md).

# Configuration du Web container

Un conteneur web est un fichier JavaScript qui a deux fonctions :

· Permettre d’utiliser les fonctions et méthodes natives du TMS

· Exécuter les solutions des partenaires (tags) qu’il contient

Il est possible, comme c’est souvent le cas, d’avoir plusieurs conteneurs pour un même site, voire pour une même page.

L’URL de chaque fichier JavaScript Web Container vous sera communiquée avec les ID et les noms des conteneurs par un consultant Commanders Act lors de la phase de configuration.

### Implémentation des conteneurs sur la page

Les conteneurs web sont généralement installés en ajoutant un nœud HTML `<script>` sur chaque page de votre site web, avec un attribut `src` qui pointe vers l’URL du conteneur.

Les conteneurs peuvent être placés à différents endroits du code source de la page, selon leur utilisation et votre type d’activité.

Voici un exemple courant avec 3 conteneurs :

| Test A/B (facultatif) | Dans le \<head>      |
| --------------------- | -------------------- |
| Analytics             | Au début du \<body>  |
| Marketing             | À la fin du \</body> |

Le conteneur placé dans \<head> est généralement utilisé pour les tests A/B et doit être chargé de manière synchrone afin d’éviter l’effet de scintillement.

Nous recommandons d’implémenter tous les conteneurs \<body> de manière asynchrone. Pour cela, utilisez simplement l’attribut async dans l’élément \<script>.

{% hint style="info" %}
Important : le datalayer doit être déclaré avant les appels de vos conteneurs. Sinon, les tags du conteneur ne pourront pas utiliser les variables.
{% endhint %}

#### Installation du `<head>` conteneur

`<head>` Les conteneurs sont utilisés pour implémenter des tags de test A/B et de personnalisation qui ont généralement un impact sur le contenu visuel d’un site web avant qu’il ne soit présenté à l’utilisateur. Il est donc important de les placer aussi haut que possible dans la `<head>` section de votre site web.

```markup
<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8" />
        <script src="{{ head_container_URL }}"></script>
        (...)
    </head>
    (...)
</html>
```

Veuillez vous assurer que le fichier du conteneur `<head>` est chargé de manière synchrone afin d’éviter tout effet de scintillement du contenu.

#### Installation du `<body>` conteneur

`<body>` Les conteneurs sont utilisés pour implémenter des tags qui mesurent des informations. Ils sont donc placés à la fin de la `<body>` section afin de limiter leur impact sur le temps de chargement du contenu du site web.

```markup
<!DOCTYPE html>
<html>
    (...)
    <body>
        (...)
        <script src="{{ body_container_URL }}"></script>
    </body>
</html>
```

Contrairement au conteneur `<head>` il est possible d’implémenter `<body>` Container de manière asynchrone. Par exemple, il est possible de les charger via JavaScript lors de l'événement `onload` de la page, ou d'utiliser l'attribut `async` dans l'élément `<script>` .

{% hint style="info" %}
**Installation via des chargeurs JavaScript**

Il est possible d'implémenter des fichiers JavaScript Container avec des chargeurs JavaScript comme RequireJS ou HeadJS. En revanche, il n'est pas possible de regrouper les fichiers JavaScript Container à l'aide de bundlers comme Webpack ou ParcelJS, afin de garantir que les fichiers Container sont chargés dynamiquement depuis le CDN ou le serveur à chaque requête de page. Sinon, les utilisateurs ne pourront pas gérer eux-mêmes le Web Container Commanders Act.
{% endhint %}

### Tests

#### Via la console du navigateur

Il est possible d'afficher dans la console JavaScript du navigateur tous les fichiers Container chargés sur un site. L'objet JavaScript `tC.containersLaunched` fournit des informations sur chaque Web Container chargé.

Vous trouverez ci-dessous un exemple d'objet contenant les informations les plus pertinentes :

```javascript
{
    1234: { // ID du compte Commanders Act
        1: { // ID du 1er Container chargé
            g: 15,
            v: "5.15" // Version du 1er Container chargé
        },
        5: { // ID du 2e Container chargé
            g: 20,
            v: "55.16" // Version du 2e Container chargé
        }
}
```

### Définitions

| **ID du compte**             | ID de compte unique de votre espace de travail sur notre plateforme. Également appelé « Site ID ». Connectez-vous à votre compte Commanders Act et repérez la première valeur numérique dans la barre d'adresse. Par exemple, avec « <https://app.commandersact.com/en/1234/> », votre identifiant de compte est « 1234 ». |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ID du Container**          | ID unique du Container au sein de votre compte. Par exemple : « 15 ».                                                                                                                                                                                                                                                      |
| **Nom du Container**         | Libellé du Container. Peut être configuré dans les « paramètres du container » du TMS. Par exemple : « Header Container ».                                                                                                                                                                                                 |
| **Nom du fichier Container** | Nom du fichier JavaScript du Container, configurable dans les « paramètres du container » du TMS. Par exemple : « tc\_header\_21.js ».                                                                                                                                                                                     |
| **URL du Container**         | URL complète du Container utilisé pour l'installation. Elle dépend de la méthode d'hébergement. Par exemple : « //cdn.tagcommander.com/1234/tc\_footer\_main\_20.js ».                                                                                                                                                     |
| **Version du Container**     | <p>Instantané d'un fichier JavaScript Container.<br>Par exemple : « 55.16 ».</p>                                                                                                                                                                                                                                           |


---

# 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/web-container-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.
