Comment utiliser les événements personnalisés ?

Dernière mise à jour: March 7, 2018

Disponible avec :

Produit: HubSpot Marketing
Abonnement: Entreprise
Les événements personnalisés permettent de suivre tout type d'interaction d'un visiteur avec votre site web.

Note : cette fonctionnalité est uniquement disponible sur la version HubSpot Entreprise. Les comptes Pro et Entreprise permettent tous deux de créer des listes basées sur les URL visitées, mais seuls les comptes Entreprise offrent la possibilité de créer un rapport d'URL visitées.

Pourquoi utiliser les événements personnalisés ?

Il est parfois judicieux de suivre des indicateurs plus approfondis que les types d'événement décrits précédemment dans ce guide. C'est pourquoi HubSpot dispose d'une fonctionnalité Événements personnalisés.

Les événements personnalisés peuvent prendre deux formes :

  • Événement JavaScript
  • Événement API HTTP

Instructions

Les instructions ci-dessous expliquent comment créer un événement personnalisé dans HubSpot. Pour intégrer l'événement au fichier JavaScript ou à un script de serveur, l'aide d'un développeur est nécessaire.

Accéder aux événements

Sur le tableau de bord HubSpot, accédez à Rapports > Événements.

HubSpot Help article screenshot

Créer un nouvel événement

Cliquez sur Créer un nouvel événement, à droite de l'écran.

HubSpot Help article screenshot

Créer un événement personnalisé

Sous Suivre un type d'événement, sélectionnez Événement personnalisé.

À cette étape, choisissez entre JavaScript et API HTTP.

HubSpot Help article screenshot

Événement JavaScript

Cliquez sur le lien Ajouter un JavaScript personnalisé. La fenêtre contextuelle permet de saisir du code JavaScript personnalisé. Sur les pages internes ou externes intégrant le code de suivi HubSpot, le snippet correspondant sera ajouté via la variable _hsq.

Si l'événement doit être suivi sur une page spécifique, indiquez son URL dans le champ URL (facultatif).

Si vous souhaitez que la règle s'applique à chaque chargement de la page, remplacez « if(false) » par if (true) dans la première ligne du code généré automatiquement dans l'éditeur, ou supprimez entièrement cette ligne.

Une fois l'événement enregistré, HubSpot génère un attribut id associé. Ce snippet de code peut être intégré à la fonction callback de JavaScript, à l'emplacement où l'événement sera généré. Veuillez noter qu'il n'est pas nécessaire de mettre le code de suivi HubSpot à jour, ni d'ajouter manuellement du code sur la page de l'événement. Le snippet JavaScript est automatiquement intégré au code de suivi. Par défaut, l'élément value est défini sur « null ». Si vous souhaitez associer une valeur de conversion à la propriété de contact Chiffre d'affaires, saisissez un nombre. Pour en savoir plus sur les valeurs de conversion, veuillez consulter cet article.

Lorsqu'une page est chargée et que le code de suivi HubSpot est exécuté, une variable _hsq est créée. Celle-ci agit en tant que file d'attente pour différents événements de suivi. Pour ajouter des événements au suivi avant le chargement du code JavaScript, définissez un tableau Array pour la variable _hsq, et renseignez des appels d'événements.

Pour plus d'informations sur les événements JavaScript, veuillez accéder au forum Développeurs.

Événement API HTTP

Lorsqu'un événement API HTTP est créé, une URL est automatiquement générée avec les paramètres suivants :

  • _n : l'attribut Event_ID de l'événement ciblé
  • _a : votre ID HubSpot

Une fois l'événement créé, donnez-lui un nom et enregistrez-le.

Pour qu'un événement API HTTP soit enregistré sur la fiche d'informations d'un contact HubSpot, l'adresse e-mail de ce contact (&email) doit être transmise par l'URL de requête. Si aucune fiche d'informations n'existe pour cette adresse e-mail, une nouvelle fiche est créée. Sinon, l'événement est attribué au contact correspondant.

Les paramètres _m et property sont également utiles. Ajoutez &_m à l'URL de requête pour attribuer une valeur à la propriété Chiffre d'affaires d'un contact, et &property pour définir une propriété de contact. Toute valeur nulle sera remplacée, mais les valeurs existantes ne seront pas mises à jour.

Voici un exemple d'URL test pour un événement :

http://track.hubspot.com/v1/event?_n=000000152395&_a=######&email=testing@hubspot.com&_m=100&demosuccess=true

Pour déclencher un événement API HTTP, vous devez soumettre une requête à l'API de suivi HubSpot avec l'élément de chemin /v1/.

Pour plus d'informations sur les événements API HTTP, veuillez accéder au forum Développeurs.

HubSpot Help article screenshot

Article précédent:

Article suivant: