> 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/best-practices/common-trigger-strategies.md).

# Stratégies courantes de Trigger

Stratégies de Data layer pour des configurations courantes.

Vous trouverez ci-dessous des configurations courantes de Trigger dans Commanders Act.

## Trigger de vue de page

Dans la plupart des cas, les événements de vue de page sont couverts par le Trigger intégré *Container loaded* et *DOM ready* de Commanders Act. Il suffit donc de configurer le Data Layer et le Container pour déclencher les Tags lors des vues de page. Dans le cas de pages Web pilotées par JavaScript, il est parfois nécessaire de suivre également les « vues de page virtuelles », par exemple lorsque les étapes d'un tunnel de vente (connexion, saisie des informations de livraison, saisie des informations de paiement, confirmation de la commande, succès de la commande) sont implémentées de manière fonctionnelle via des fonctions JavaScript et non via des pages distinctes dotées d'URL différentes.

Dans ce cas, il est courant de suivre la vue de page initiale avec le Trigger *Container loaded* ou *DOM ready* et les vues de page virtuelles suivantes avec un Trigger personnalisé. Pour ce scénario, les étapes suivantes doivent être effectuées à chaque vue de page virtuelle suivante.

#### **1. Mettre à jour `tc_vars` Data Layer**

Le Data Layer doit être mis à jour avec les nouvelles métadonnées de la vue de page virtuelle suivante.

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

**2. Recharger le Container**

Certaines fonctionnalités internes du Container (par exemple, les variables internes) ne sont calculées qu'au chargement initial du Container. Pour les recalculer avec le Data Layer mis à jour, il est nécessaire de recharger le Container à l'aide d'une fonction JavaScript.

```javascript
tC.container.reload();
```

**3. Exécuter les Triggers**

Après ces étapes, il est nécessaire de déclencher un Trigger personnalisé pour exécuter les Tags associés.

```javascript
cact('emit', 'page_view', {});
```

Pour utiliser les attributs de l'événement, vous pouvez spécifier l'événement ou l'élément comme premier argument.

```html
<a href="/home" onclick="cact('emit', 'pageview', { from: this, some_data: 'some_value' })">Accueil</a>
```

***Ancienne méthode***

```javascript
tC.event.pageview({}, {});
```

Pour utiliser les attributs de l'événement, vous devez spécifier l'événement ou l'élément comme argument. `event` est une variable spéciale toujours disponible dans les attributs `onclick` et `on*` .

```html
<a href="/home" onclick="tC.event.pageview(event, {}))">Accueil</a>
```

{% hint style="info" %}
Les étapes 2 et 3 sont souvent utilisées conjointement ; il est donc possible de les combiner en un seul appel, par exemple : `tC.container.reload({ events: { pageview: [{}, {}] } });`
{% endhint %}

## Trigger de clic

L'implémentation d'un Trigger de clic dépend du scénario. Par exemple : *L'utilisateur est-il redirigé vers un autre site lorsqu'il clique sur un élément ?* et *La page suivante s'ouvre-t-elle dans un nouvel onglet ?*.

Vous trouverez ci-dessous une liste de scénarios courants pour les Triggers de clic.

### Scénarios

#### Un clic mène à une page interne

Les liens ou interactions qui dirigent l’utilisateur vers une autre page interne sont difficiles à suivre. En effet, les tags ont généralement besoin de plus de temps pour s’exécuter que le navigateur pour accéder à la page suivante. L’exécution des tags peut alors être interrompue par inadvertance, ce qui empêche également le suivi associé.

Pour suivre efficacement ces scénarios, il est important de consulter le fournisseur du tag afin de trouver une solution. Voici quelques solutions courantes :

* Le tag retarde la navigation vers la page jusqu’à la fin de son exécution
* Le tag utilise l’API Beacon du navigateur, qui envoie les appels de suivi en arrière-plan

Ces options nécessitent généralement de configurer le code du tag d’événement.

#### Un clic mène à une page externe

Il est préférable d’ouvrir les liens externes dans un autre onglet du navigateur en utilisant l’option `target="_blank"` sur les liens d’ancrage. Les tags peuvent ainsi terminer leur exécution dans l’ancien onglet, tandis que les utilisateurs peuvent déjà accéder à la nouvelle page externe dans un nouvel onglet.

Si les liens externes ne peuvent pas s’ouvrir dans un nouvel onglet, il convient de suivre les mêmes recommandations que pour le scénario précédent.

#### Un clic ne mène pas à une autre page

Certains clics ne redirigent pas vers une nouvelle page. Les commandes de lecture vidéo ou les interactions avec les carrousels d’images en sont des exemples courants.

Ces clics peuvent généralement être suivis avec moins de risques, car les tags disposent de suffisamment de temps pour s’exécuter sur la même page.

### Configuration

#### Avec l’interface Commanders Act

Les utilisateurs de Commanders Act peuvent configurer facilement des déclencheurs de clic courants dans l’interface Web Containers en les sélectionnant à l’aide d’un chemin de sélecteur CSS.

Ce déclencheur fonctionne dans de nombreux cas, mais présente deux inconvénients :

1. La configuration d’un déclencheur à l’aide d’un chemin de sélecteur CSS générique est instable et peut être compromise par de futures mises à jour du code CSS du site Web.
2. Commanders Act ne peut identifier que les éléments chargés de manière synchrone sur le site Web. Les éléments chargés de manière asynchrone ne peuvent pas être surveillés par le déclencheur prédéfini de Commanders Act.

Voici des cas où il est pertinent de configurer des déclencheurs Commanders Act à l’aide de l’interface :

1. Une campagne onsite qui doit être mesurée pendant une courte période (quelques semaines)
2. Le suivi général des clics, jusqu’à ce que l’équipe de développement Web puisse implémenter un déclencheur personnalisé.

#### Avec un déclencheur personnalisé

Le personnel technique peut implémenter des déclencheurs personnalisés pour suivre les clics sur un site Web. Cette approche est plus stable que la configuration d’un déclencheur de clic à l’aide de l’interface, mais l’équipe de développement Web a généralement besoin d’un certain temps pour l’implémenter. Il est donc recommandé de configurer des déclencheurs provisoires dans l’interface en attendant leur implémentation sur le site.

Les déclencheurs personnalisés ne doivent pas être implémentés pour les campagnes à court terme, mais doivent être privilégiés pour les fonctionnalités essentielles à l’activité, comme *Ajouter au panier* ou *Inscription réussie*.

Une méthode courante pour configurer un déclencheur de clic consiste à ajouter des `data-attributes` à tous les éléments dont les clics doivent être suivis. Le CMS du site Web peut ensuite renseigner ces attributs avec des valeurs, afin que, par exemple, l’équipe marketing puisse configurer elle-même un « déclencheur de clic » pour un nouveau teaser. En HTML, cela pourrait ressembler à ceci :

```markup
<a href="..." class="btn btn--cta" data-tracking-action="click" data-tracking-label="My CTA" data-tracking-value="campaign-1234">Buy now!</a>
```

Dans la plateforme Commanders Act, il est ensuite possible d’intercepter les clics sur ces éléments pour déclencher un déclencheur personnalisé. Avec jQuery, cela pourrait ressembler à ceci :

```javascript
(function(){

    if (!$) {
        console.log("Commanders Act | Error | jQuery not available in Commanders Act Click Trigger!");
        return;
    }

    var eventActionSelector = '[data-tracking-action="click"]';
    var eventLabelAttribute = 'data-tracking-label';
    var eventValueAttribute = 'data-tracking-value';

    var eventHandler = function(event) {

        var eventData = {};
        eventData.event_action = "click";
        eventData.event_label = $(this).attr("data-tracking-label");
        eventData.event_value = $(this).attr("data-tracking-value");

      	if (tC.event && typeof tC.event[triggerName] === "function"){
            // old method
            // tC.event["my_click_trigger"](event, eventData);

            eventData.from = event; // necessary to use event attributes inside the tag
            cact('emit', 'my_click_trigger', eventData);
      	}

    }

    // Configurer le gestionnaire d’événements sur body via la délégation d’événements pour inclure les éléments asynchrones
    $("body").on("click", eventElementSelector, eventHandler);

}());
```

{% hint style="info" %}
Cette approche permet de bien séparer les responsabilités entre le code du site web et Commanders Act. Le site web est chargé de fournir les données de tracking et d’indiquer les éléments qui doivent être trackés. Commanders Act est chargé d’initialiser le code de suivi des clics et d’exécuter les Tags associés.
{% endhint %}


---

# 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/best-practices/common-trigger-strategies.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.
