Comment envoyer un événement avec JavaScript ?

L'envoi d'événements avec JavaScript est l'une des méthodes les plus populaires et les plus flexibles pour suivre le comportement des contacts dans Positive User. Vous pouvez l'utiliser pour enregistrer des clics, des achats, des soumissions de formulaires ou toute autre action importante effectuée sur votre site. Ces événements peuvent ensuite alimenter vos automatisations, segments, statistiques et communications personnalisées.

Si vous souhaitez d'abord comprendre le fonctionnement des événements, consultez : Qu'est-ce qu'un événement ?

Étapes à suivre

1. Liaison d'événement simple

Vous pouvez envoyer un événement en l’associant directement à une action sur votre site web, comme un clic sur un bouton. Lorsque l'action se produit, l'événement est envoyé à Positive User.

Exemple:

 <a href="#" onclick="userengage('event.name_your_event_here')">CLICK ME!</a>             

2: Ajouter des attributs à votre événement

Vous pouvez enrichir vos événements en ajoutant des attributs en tant que second paramètre.

Exemple avec un attribut :

 <a href="#" onclick="userengage('event.name_your_event_here', {'price': '10'})">CLICK ME!</a>

Pour envoyer plusieurs attributs, il suffit de les regrouper dans un objet.

Exemple avec plusieurs attributs :

<a href="#" onclick="userengage('event.name_your_event_here', {'sku': '7', 'size': '39', 'color': 'teal', 'price': '39'})">CLICK ME!</a>

3: Définir les bons types d’attributs

Avant d’envoyer des événements avec des attributs, assurez-vous que tous les attributs d’événement sont créés dans Positive User avec les bons types. Sinon, toutes les valeurs reçues seront traitées comme des chaînes de caractères (sauf le JSON), ce qui limiterait vos possibilités de filtre et d'automatisation.

Consultez notre article : Comment créer un attribut personnalisé ?

Exemple:

<a href="#" onclick="userengage('event.purchase_details', { 'sku': 7, 'size': 39, 'color': 'teal', 'price': 39 })"/>

Dans cet exemple, seul “color” est une chaîne de caractères (string). Les autres attributs sont envoyés sous forme de nombres (number), conformément à leur type attendu.

Veillez à sélectionner le bon type d’attribut dès le départ : il ne pourra plus être changé ensuite.

Voici les différents types d'attributs d'événement disponibles :

4. Consultation des données d'événement

Une fois que vous avez envoyé des données vers l'application Positive User, vous pouvez les vérifier à deux endroits :

• La fiche du contact (dans la section “Événements”)

• Paramètres de l'espace de travail → Données & événements des contacts → Événements (cliquez sur le nom de l'événement pour consulter les journaux)

Exemple:

Articles liés

• Qu’est-ce qu’un événement ?

• Comment envoyer un événement avec Google Tag Manager ?

• Comment envoyer des événements produit ?