Configuration des événements côté navigateur

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

Définitions

Métrique	Description
Libellé du Trigger	Libellé d'un événement utilisé par les utilisateurs de Commanders Act pour exécuter des tag. ex. add_to_basket
Trigger Data Layer	Un objet JavaScript qui peut être accessible par les tag exécutés sur le Trigger concerné. ex. product_id

Installation

Commanders Act permet de configurer des Trigger communs automatiquement sans l'intervention de l'équipe technique (par ex. Container loaded, DOM ready ou Vertical Scroll 25%). Dans les cas où les Trigger par défaut ne suffisent pas, il est possible pour le personnel technique d'implémenter des Trigger personnalisés. Les Trigger nécessaires sont définis lors du processus de configuration de Commanders Act, mais vous pouvez trouver une liste des Trigger natifs sur cette page.

Pour installer un Trigger personnalisé sur le site web, il est nécessaire d'appeler une fonction JavaScript avec le modèle suivant :

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

Un exemple typique est un Add to basket événement où l'id du produit sélectionné est envoyé avec l'événement :

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

Propriétés du Trigger Data Layer

Une approche courante pour le Trigger Data Layer est d'utiliser systématiquement les mêmes propriétés comme event_label, event_type et event_value—donc dans le cas d'un add_to_basket Le event_value contiendrait l'id du produit sélectionné et dans le cas d'un video_play événement le event_value contiendrait la position actuelle dans la timeline de la vidéo. Cela permet d'éviter de créer plusieurs noms de variables personnalisées pour chaque événement individuel et rend donc les Trigger plus génériques.

Gestion des erreurs de Trigger

Dans certaines situations il peut arriver qu'un utilisateur interagisse avec un Trigger personnalisé avant que le fichier Web Container de Commanders Act ne soit chargé. Dans ce cas, l'utilisation de la fonction Trigger provoquerait une erreur JavaScript ReferenceError. Par conséquent, il est recommandé de vérifier la disponibilité de la fonction Trigger avant de l'utiliser.

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

Test

Via le Tag Quality Assurance

Le template de tag Commanders Act - Event QA la bibliothèque de tag Commanders Act affiche automatiquement les informations du Data Layer de l'événement dans la console JavaScript lorsqu'elle est exécutée. L'affectation de ce tag au Trigger permet d'enregistrer un instantané du Data Layer lorsque le Trigger correspondant est exécuté. Autre méthode, plus technique : vous pouvez taper dans votre console tc_arrray_events lorsque l'événement est exécuté. Le Data Layer des variables de l'événement sera affiché.