> 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/user-guides-for-browser-side-platform/tags/configure-tags.md).

# Configurer les tags

Une fois un tag ajouté, vous pouvez le configurer à l’étape «**EDIT**».

La liste de vos tags s’affiche dans le menu de gauche de l’interface «**EDIT**». Les tags qui doivent être configurés ou validés sont précédés d’un symbole d’avertissement (/!\\).

Remarque : vous pouvez rechercher un tag dans la liste à l’aide du champ de recherche :[<br>](https://community.commandersact.com/wp-content/uploads/sites/2/2016/01/TAG_CONFIG_1.png)

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-700ab8af6e229a2a005a1204509a2a92891b7dc3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Pour chaque tag sélectionné, une fenêtre de configuration s’affiche au centre de l’interface et contient les éléments suivants :

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-1a874ce723765bb94f566add824b7c54027838ac%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**Expiration**: une date d’expiration peut être définie pour le tag

**Variable(s) du tag**: variables du tag auxquelles doivent être associées des données du data layer ou des informations statiques

**Code du tag**: code du tag sélectionné

**Utiliser** **Tag** **Cleaner**: outil de correction JavaScript et bouton d’aperçu permettant de visualiser le code du tag une fois ses variables associées aux variables du data layer

**Version(s)** **précédente(s)**: historique des versions du tag ;

«**supprimer**» et «**enregistrer**» boutons

**Règles**: raccourci vers la configuration des règles du tag

## Date d’expiration

### Définir une date d’expiration pour un tag

Vous pouvez définir une date d’ **expiration** personnalisée pour chaque tag. Cochez la case pour activer cette fonction, puis sélectionnez une date dans le calendrier ou saisissez-la dans le champ prévu à cet effet.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-6919e8417f14465f6d126040a226dde4b1b82786%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Lorsque vous activez la fonction d’expiration, le tag est automatiquement désactivé dans le container à la date d’expiration sélectionnée.

Cette fonction est utile si vous avez ajouté un tag pour une campagne spécifique et souhaitez le désactiver à la fin de celle-ci, afin d’éviter de surcharger inutilement votre container de tags.

## Associer les variables des tags

Rappel important : vous devez relier les informations demandées par les différents tags du container aux données disponibles dans le data layer. L’ajout de variables du data layer aux variables des tags s’appelle le «**mapping**».

Les variables des tags à associer sont appelées «**variables dynamiques**» et sont désignées de la manière suivante : **#variable#**.

Elles apparaissent en bleu et en gras dans le code du tag, ainsi qu’au-dessus de celui-ci.

Vous devez associer ces variables dynamiques aux variables du data layer disponibles dans les menus déroulants (exemple : e-mail de l’utilisateur, ID de l’utilisateur) ou à une valeur statique (exemple : méthode) :[<br>](https://community.commandersact.com/wp-content/uploads/sites/2/2016/01/MAPPING_TAGS_VARS.png)

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-4f174b3f6ffa7900e9c0e47a0230751472bfac21%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Informations complémentaires

Si le code du tag ne répond pas à vos besoins, vous pouvez le personnaliser directement dans la section «**JAVASCRIPT CODE**», ainsi que dans la section «**NOSCRIPT CODE**» pour les navigateurs où JavaScript n’est pas activé (cette fonction ne fonctionne que si vous appelez la version NOSCRIPT du container dans le code source de votre site) :

\\

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-6a53ed755ce34d65e3bdff915232e8116045c323%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous pouvez modifier directement votre tag en transformant les variables dynamiques du code en données de votre choix.

Exemple :

Si vous souhaitez coder en dur l’USER ID, remplacez simplement #user\_id# par la valeur de l’ID :\
\ <img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-d40971479bf16e03b65230b06f068e6a428da0e6%2Fimage.png?alt=media" alt="" data-size="original"> ![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-eac3a27281bed38d7577f52d20aff04e8fd2e048%2Fimage.png?alt=media)

Vous pouvez également personnaliser le code de votre tag en remplaçant les éléments statiques par des variables dynamiques.

Exemple :\\

Pour que toutes les valeurs à collecter dans un tag soient dynamiques, laissez-les simplement entre des signes dièse. Enregistrez ensuite le tag après cette modification : vous pourrez alors associer votre variable aux données de votre data layer :[<br>](https://community.commandersact.com/wp-content/uploads/sites/2/2016/01/MATCHING.png)

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-22588f32d8227efcdb842a5c12a04752b0821713%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Remarque : vous pouvez modifier votre tag à tout moment. Veillez toutefois à respecter sa structure JavaScript : les éléments dynamiques doivent être placés entre les ## et être précédés ou suivis d’un « + » s’ils sont associés à des éléments statiques. La coloration syntaxique du code du tag vous permet de vérifier qu’il ne comporte aucune erreur :

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-4082a236bf6eca40ebc1a64b60d1c2de4576e2e9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Configuration des tags personnalisés

Un tag «**Saisie libre (personnalisée)**» permet d’ajouter un tag à votre container, même s’il ne figure pas dans la bibliothèque de tags.

Pour configurer votre tag personnalisé, remplacez le code par défaut dans «**JAVASCRIPT** **CODE**» par le code fourni par votre solution partenaire, puis cliquez sur «**SAVE**».

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-a390ef40abdc873a0bfb300a28d62af223b4442e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Dans la grande majorité des cas, vous constaterez que votre tag est réécrit afin que sa structure soit compatible avec celle du container et qu’il soit appelé de manière asynchrone. Cela permet également d’éviter les erreurs liées à certaines structures de données JavaScript, comme « document.write ».

Les tags sont corrigés à l’aide de la fonctionnalité «**Use Tag Cleaner**» :

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-c64a56973cb6e3ade1a3d6f2e5fdf5d310cbc191%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-3144747347d4ff495554823aa4435b543cbe2d8d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Décochez la case «**Use Tag Cleaner**» si vous ne souhaitez pas que votre tag soit réécrit.

## Revenir à une version précédente d’un tag

À chaque génération d’un container, Commanders Act enregistre les tags qu’il contient, ce qui vous permet de revenir à une ancienne configuration de tag si nécessaire.

Vous pouvez afficher les versions précédentes d’un tag en cliquant sur «**PREVIOUS VERSION(S)**» :[<br>](https://community.commandersact.com/wp-content/uploads/sites/2/2016/01/PREVIOUS_VERSIONS.png)

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-db7d5e7eae0e8bd2ace005fc7902c78191e67fed%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

La fenêtre «**PREVIOUS VERSION(S)**» contient toutes les versions enregistrées de votre tag. La version affichée par défaut est la version précédente du tag.[<br>](https://community.commandersact.com/wp-content/uploads/sites/2/2016/01/PREVIOUS_V_DETAILS.png)

**Version du tag** : numéro de la dernière version du tag enregistrée, nom de l’utilisateur qui a généré cette version, ainsi que la date et l’heure de sa génération

«**Rollback**« : bouton permettant de revenir à la version du tag affichée

**Code du** **tag** : code du tag sélectionné (code JavaScript ou NoScript, selon l’option sélectionnée à l’étape (3))

**Versions du** **tag** : versions précédentes du tag

Pour revenir à une version précédente du tag, sélectionnez la version souhaitée et cliquez sur «**ROLLBACK**«.

## Appliquer une règle à la volée

Vous pouvez ajouter une règle d’activation de tag directement à l’étape «**EDIT**».

Deux options s’offrent à vous :

* Vous pouvez sélectionner un périmètre ou une contrainte créé précédemment en cliquant sur le menu déroulant :\
  \ <img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-061fda3043f368f02924ed531682b2fc79e3ac11%2Fimage.png?alt=media" alt="" data-size="original">
* Vous pouvez créer un nouveau périmètre ou une nouvelle contrainte en cliquant sur « + » ![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-a803c846262412916178fa784874a3bcad71707d%2Fimage.png?alt=media)

La fenêtre de création de règles s’affiche pour vous permettre de créer vos règles de la même manière qu’à l’étape « **RULES** ».

Pour en savoir plus sur la création de règles, consultez la section [Règles](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/tags/rules.md) .

### Afficher le récapitulatif des tags et des règles associées

Pour afficher un récapitulatif de tous les tags présents sur votre site, ainsi que leurs règles, accédez à l’onglet « **REPORTS** » > « **Tags’ Summary** » \*cette page est actuellement accessible uniquement depuis Platform v7.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-a18da6bc559597863abdc99c8f1f2e5fdcf71733%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous pouvez afficher le code, les règles et la date d’expiration de chaque tag.

Vous pouvez également filtrer les containers ou les tags que vous souhaitez analyser.

Ce rapport peut être utile pour afficher les tags présents sur votre site à un moment donné et partager ces informations avec d’autres personnes en interne. Il peut également vous aider à trouver un tag dans la liste des tags présents sur votre site.

## Enregistrer et supprimer un tag

Une fois la configuration de votre tag terminée, cliquez sur « **SAVE** » pour enregistrer vos modifications.

Vous pouvez également supprimer un tag dont vous n’avez plus besoin en cliquant sur « **DELETE** ».

Attention : un tag supprimé ne peut pas être récupéré.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-ca41f919ef77e7a9feea2eef0bd572c420b9a1c6%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Activation des tags et ordre d’exécution

Pour activer ou désactiver des tags à l’étape « **GENERATE** », cochez ou décochez chaque tag dans la colonne « **ACTIVATION** », puis générez une nouvelle version du container (bouton bleu en haut à droite de l’écran) :[<br>](https://community.commandersact.com/wp-content/uploads/sites/2/2016/01/MANAGING_ACTIVATION.png)

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-ed8dd7b312f197bf4274bf4dc86db9bb00a01cd2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Tous les tags cochés sont actifs et tous les tags décochés sont inactifs. L’avantage de désactiver un tag plutôt que de le supprimer définitivement est que vous conservez tous ses paramètres (mapping, règles) et pouvez le réactiver ultérieurement sans avoir à tout reconfigurer.

Remarque : un tag désactivé reste visible dans l’interface, mais pas dans le container appelé sur votre site. Votre container ne sera donc pas inutilement encombré.

Pour modifier l’ordre d’exécution des tags dans un container à l’étape « **GENERATE** », faites glisser chaque tag dans la colonne « **RANK** » et placez-les dans l’ordre d’exécution souhaité sur les pages de votre site, puis générez une nouvelle version du container (bouton bleu en haut à droite de l’écran) :\\

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-35e115c70d71f285599821bf86ebd3b283e7c0f4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Nous vous recommandons de placer les **tags les plus importants** en **haut** du container afin qu’ils aient toutes les chances de s’exécuter si vos visiteurs changent rapidement de page, sans attendre leur chargement complet.

## Définir un délai d’expiration pour un tag

Pour améliorer les performances de votre site, Commanders Act recommande de désactiver un tag si son chargement prend trop de temps. Vous pouvez définir une durée maximale, en millisecondes, pendant laquelle un tag peut s’exécuter. Si son exécution dépasse cette durée, il sera désactivé.

Pour ajouter un délai d’expiration aux tags à l’étape « **GENERATE** », saisissez une durée en millisecondes dans la colonne « **TIMEOUT MS”**  », puis générez une nouvelle version du container :[<br>](https://community.commandersact.com/wp-content/uploads/sites/2/2016/01/TIMEOUT.png)

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-4e31fc37ff0fc2ded3fec3ad6b2920ffe9b546c2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Personnaliser la bibliothèque de tags (liste blanche)

Vous pouvez personnaliser la bibliothèque de tags en limitant le nombre de modèles de tags disponibles dans la fenêtre d’ajout de tags, à partir des étapes « Sélectionner » et « Modifier ».

Cette fonctionnalité de « liste blanche de tags » est utile si vous souhaitez limiter l’accès aux solutions de la bibliothèque et n’en mettre que certaines à la disposition de votre équipe. Elle vise à empêcher les utilisateurs d’ajouter à vos conteneurs des tags que vous n’avez pas autorisés.

L’interface « Gestion de la bibliothèque » est accessible aux administrateurs ainsi qu’aux utilisateurs personnalisés auxquels l’accès à cette interface a été accordé. La liste blanche de tags se gère depuis l’interface « Administration » > « Gestion de la bibliothèque ». Cette page est actuellement disponible uniquement sur la plateforme v7.

Tous les tags sont sélectionnés par défaut.

Vous pouvez cliquer sur l’option « Tout désélectionner », puis choisir les tags que vous souhaitez rendre disponibles dans votre bibliothèque.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-e6f13ff160094e06e8ebde2af45bfeceaca92fc9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Sélectionnez dans le menu déroulant le site pour lequel vous souhaitez configurer la liste blanche de tags.

Vous pouvez cocher ou décocher les tags concernés.

Les boutons « Tout sélectionner » et « Tout désélectionner » vous permettent de cocher ou de décocher plusieurs tags simultanément.

Vous pouvez filtrer les tags par nom ou par ordre alphabétique.

Cliquez sur le bouton « ENREGISTRER » pour enregistrer vos paramètres.

**À savoir :**

* Lorsqu’un membre de l’équipe Commanders Act ajoute un nouveau tag à la bibliothèque de tags, celui-ci est automatiquement décoché si vous avez déjà créé au moins une liste blanche de tags pour votre site.
* Vous pouvez copier une liste blanche de tags d’un site à un autre depuis le menu « Administration » > « Gestion des copies ».&#x20;


---

# 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/user-guides-for-browser-side-platform/tags/configure-tags.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.
