> 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/browser-side-events-setup.md).

# Configuration des événements browser-side

Les Events Triggers de Commanders Act sont des événements onsite utilisés par les utilisateurs de Commanders Act pour exécuter dynamiquement des Tags.

### Définitions

| Métrique                  | Description                                                                                                                 |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Libellé du Trigger**    | Libellé d’un événement utilisé par les utilisateurs de Commanders Act pour exécuter des Tags. Par exemple : add\_to\_basket |
| **Data Layer du Trigger** | Objet JavaScript accessible aux Tags exécutés lors du Trigger associé. Par exemple : product\_id                            |

### Installation

Commanders Act permet de configurer automatiquement les Triggers courants sans intervention de l’équipe technique (par exemple : *Container chargé*, *DOM prêt* ou *Défilement vertical à 25 %*). Si les Triggers par défaut ne suffisent pas, le personnel technique peut implémenter des Triggers personnalisés. Les Triggers nécessaires sont définis lors du processus de configuration de Commanders Act, mais vous trouverez une liste des Triggers natifs sur [cette page](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/tags/rules/triggers.md).

Pour installer un Trigger personnalisé sur le site web, il faut appeler une fonction JavaScript selon le modèle suivant :

```javascript
tC.event.{{ Trigger Label }}(this, {{ Trigger Data Layer }});
```

Un exemple courant est un événement *Ajouter au panier* qui envoie l’ID du produit sélectionné avec l’événement :

```javascript
tC.event.add_to_basket(this, { product_id: "12345" });
```

{% hint style="info" %}
**Propriétés du Data Layer du Trigger**

Une approche courante consiste à toujours utiliser les mêmes propriétés dans le Data Layer du Trigger, comme `event_label`, `event_type` et `event_value`—ainsi, dans le cas d’un Trigger `add_to_basket` , le `event_value` contiendrait l’ID du produit sélectionné, tandis que dans le cas d’un événement `video_play` le `event_value` contiendrait la position actuelle dans la timeline de la vidéo. Cela évite de créer plusieurs noms de variables personnalisés pour chaque événement et rend ainsi les Triggers plus génériques.
{% endhint %}

{% hint style="warning" %}
**Gestion des erreurs de Trigger**

Dans certaines situations, un utilisateur peut interagir avec un Trigger personnalisé avant le chargement du fichier Web Container de Commanders Act. Dans ce cas, l’utilisation de la fonction Trigger provoquerait une erreur JavaScript `ReferenceError`. Il est donc recommandé de vérifier que la fonction Trigger est disponible avant de l’utiliser.

```javascript
if (tC && tC.event && typeof tC.event.add_to_basket === "function") {
    tC.event.add_to_basket(this, { product_id: "12345" });
}
```

{% endhint %}

### Tests

#### Via le Tag Quality Assurance

Le modèle de Tag *Commanders Act - Event QA* dans la bibliothèque de Tags Commanders Act affiche automatiquement les informations du Data Layer de l’événement dans la console JavaScript lors de son exécution. Associer ce Tag au Trigger permet de consigner un instantané du Data Layer lorsque le Trigger correspondant est exécuté.\
\
Autre méthode, plus technique : vous pouvez saisir tc\_arrray\_events dans la console au déclenchement de l’événement. Le Data Layer des variables de l’événement s’affichera.


---

# 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/browser-side-events-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.
