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. p. ex. add_to_basket
Data Layer du Trigger	Un objet JavaScript accessible par les Tags exécutés sur le Trigger associé. p. ex. product_id

Installation

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

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

tC.event.{{ Libellé du Trigger }}(this, {{ Data Layer du Trigger }});

Un exemple typique est un Ajouter au panier é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 Data Layer du Trigger

Une approche courante pour le Data Layer du Trigger consiste à toujours utiliser les mêmes propriétés comme event_label, event_type et event_value—ainsi, dans le cas d’un add_to_basket Trigger, 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 chronologie de la vidéo. Cela permet d’éviter de créer plusieurs noms de variables personnalisés pour chaque événement individuel et rend ainsi le Trigger plus générique.

Gestion des erreurs de Trigger

Dans certaines situations, il peut arriver qu’un utilisateur interagisse avec un Trigger personnalisé avant que le fichier Commanders Act Web Container soit chargé. Dans ce cas, l’utilisation de la fonction Trigger provoquerait une erreur JavaScript ReferenceError. Il est donc 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 d’assurance qualité

Le template de tag Commanders Act - QA des événements dans la Tag library de Commanders Act affiche automatiquement les informations du Data Layer de l’événement dans la console JavaScript lorsqu’il est exécuté. L’association 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 saisir dans votre console tc_arrray_events lorsque l’événement est exécuté. Le Data Layer des variables de l’événement s’affichera.