Variables d'événement

Variables d’événement sont les variables présentes dans les events browser-side de Commanders Act. Elles sont principalement utilisées pour le suivi des actions utilisateur (clics sur des boutons, liens, etc.).

Les variables d’événement sont utiles si vous souhaitez envoyer des données spécifiques à un event sans avoir ces données sur les pages de votre site en tant que variables externes.

Exemple : vous souhaitez associer un event au bouton “Send” de votre formulaire. Les variables d’événement pourraient être le nom de famille, le prénom, l’adresse e-mail et le numéro de téléphone de l’utilisateur. Ce sont des données qui ne sont pas disponibles lorsque la page est chargée ; elles ne deviennent disponibles qu’après que l’utilisateur a rempli les champs du formulaire et cliqué sur “Send”.

Les variables d’événement doivent être ajoutées dans l’interface Commanders Act avant de pouvoir être utilisées, et uniquement pour les events, pas pour les tags.

Variables d’événement doivent être créées dans l’interface Commanders Act avant de pouvoir être utilisées dans un event. Consultez l’article “Adding event variables” pour savoir comment créer une variable d’événement dans l’interface.

Toutes les variables d’événement créées peuvent être utilisées :

• Pour ajouter des informations aux solutions intégrées dans Commanders Act (associer des variables d’événement et des solutions s’appelle le mapping). Consultez l’article “Mapping Tags’ Variables” pour savoir comment mapper vos variables dans un event.

• Pour créer des règles d’activation pour vos events. Consultez la section “Adding Rules” pour savoir comment créer des règles basées sur vos variables d’événement.

Informations complémentaires

Variables d’événement doivent être implémentées dans la fonction event de Commanders Act (tC.events).

Note : les variables externes déjà disponibles sur la page n’ont pas besoin d’être implémentées dans votre event. Par exemple, vous n’avez pas besoin d’assigner une variable “country” à un event si cette information est déjà présente dans une variable externe.

Voici un exemple de variable d’événement :

<a onclick="addtocart(0);{tC.event.addtocart(this, {'productID':123, 'user_email':'[email protected]'})}">Add to cart</a>

Quand ajouter une variable d’événement

Il existe deux situations dans lesquelles vous pouvez avoir besoin de déclarer vos variables dans l’interface de gestion des variables d’événement :

• Vous souhaitez implémenter les events Commanders Act sur un nouveau site. Les variables que votre équipe technique ou votre prestataire technique implémentent dans le code source du site (dans la fonction tC.events) doivent d’abord être déclarées dans l’interface afin de pouvoir être ajoutées à vos tags et règles.

• Les variables de vos fonctions event actuelles sont manquantes ou vous souhaitez ajouter un nouvel event à votre site. Là encore, cette variable doit d’abord être déclarée dans l’interface avant de pouvoir être utilisée dans vos tags et règles.

Ajouter des variables d’événement

Pour ajouter une variable d’événement, vous devez aller dans “Data Management” > “Web Datalayer” > “Event Variables” et cliquer sur “ADD VARIABLE” :

Le « ajouter” comprend les éléments suivants :

« Nom“ : le nom de la variable (champ obligatoire)

« Type“ : le type de la variable

« Description“ : une description de la variable, pour clarifier son nom (par ex. “Page template” peut être la description de la variable nommée “env_template”)

« Description détaillée“ : une description détaillée de la variable, pour préciser davantage son nom (par ex. “possible values: homepage/category/product/funnel_confirmation” peut être la description détaillée de la variable “env_template”)

Modifier ou supprimer des variables

Vous pouvez modifier une variable interne en cliquant sur l’icône “Edit” et la supprimer en cliquant sur “X” :