Reports

Comment créer des événements dans HubSpot ?

Dernière mise à jour: July 7, 2017

Disponible avec :

Qu'est-ce qu'un événement ?

L'utilisation d'événements est une fonctionnalité offerte aux clients Entreprise de HubSpot. Elle permet de suivre les actions spécifiques d'un utilisateur sur votre site web. Par exemple :

  • Un visiteur s'inscrit pour tester une version d'évaluation.
  • Un visiteur télécharge un livre blanc.
  • Un internaute clique sur le bouton de lecture de la démonstration gratuite.
  • Un utilisateur se connecte.
  • Un prospect crée un compte.
  • Un internaute consulte la page des tarifs.

Quelles sont les conditions préalables requises ?

  • L'outil Événements est uniquement offert aux clients Entreprise.
  • Le code de suivi HubSpotdoit être installé sur toutes les pages sur lesquelles vous souhaitez effectuer le suivi d'événements.

Comment créer un événement ?

  • Accédez à Rapports > Événements, puis cliquez sur le bouton Créer un nouvel événement.
  • Choisissez votre type d'événement :

Événements d'URL visitée : un événement est déclenché lorsqu'un visiteur accède à une URL spécifique.
Événements d'élément cliqué : un événement est déclenché lorsqu'un clic est effectué sur un élément de la page.
Événements de formulaire soumis : un événement est déclenché lorsqu'un visiteur soumet un formulaire HubSpot.
Événements personnalisés : un événement est déclenché sur la base d'un code JavaScript personnalisé ou de requêtes d'API HTTP.

Quels sont les types d'événements ?

Événement d'URL visitée

événements d'URL visitée
Entrez l'URL exacte à partir de laquelle l'événement d'URL visitée sera déclenché lorsqu'un internaute y accédera.
  • Ajoutez une ou plusieurs étiquettes pour organiser les événements.

Si vous utilisez SSL, faites bien attention aux protocoles (http ou https). Si vous souhaitez suivre une URL qui utilise SSL et qui contient « https », veillez à écrire « https » ici.

Remarque : pour que l'événement soit déclenché pour une série de pages, vous pouvez également utiliser des caractères génériques dans l'URL. Par exemple, si vous ajoutez * à la fin d'une URL, l'événement se déclenchera sur toutes les pages qui contiennent la première partie de l'URL. Autrement dit, si l'URL de tous vos blogs commence par http://blog.exemple.com/, http://blog.exemple.com/ * déclenchera l'événement pour l'URL de tous les blogs (http://blog.exemple.com/article-incontournable, http://blog.exemple.com/article-a-ne-pas-manquer, etc.).

Événement d'élément cliqué

Nous vous recommandons d'utiliser le bookmarklet d'événements pour générer des événements d'élément cliqué. Pour en savoir plus sur cette configuration, cliquez ici. Vous pouvez également créer manuellement un événement d'élément cliqué à l'aide d'un ID, d'une classe ou d'un sélecteur jQuery.

Événement d'élément cliqué
Événement d'élément cliqué
  • Saisissez l'ID, la classe ou un sélecteur jQuery pour l'élément de la page web page dont vous souhaitez suivre les clics. Par exemple, si vous utilisez une image sur la page avec ce code HTML , l'ID correspond à image-offre-webinar.
  • Spécifiez une URL de page afin de ne déclencher l'événement que lorsque les visiteurs cliquent sur l'élément de cette page spécifique. Si vous souhaitez que l'événement soit déclenché pour toutes les pages, ne spécifiez aucune URL de page.
  • Associez une valeur de conversion qui s'affichera dans le rapport sur les événements si vous voulez évaluer le retour sur investissement lié à cet événement.
  • Ajoutez une ou plusieurs étiquettes pour organiser les événements.

Événement de formulaire soumis

événement de formulaire soumis
événement de formulaire soumis
  • Sélectionnez le formulaire HubSpot pour lequel vous souhaitez déclencher l'événement. Les formulaires soumis à HubSpot via l'API Formulaires sont également inclus dans la liste déroulante.
  • Spécifiez une URL de page afin de ne déclencher l'événement que lorsque les visiteurs soumettent le formulaire sur cette page spécifique. Si vous souhaitez que l'événement soit déclenché pour toutes les pages, ne spécifiez aucune URL de page.
  • Ajoutez une ou plusieurs étiquettes pour organiser les événements.

Événements personnalisés

Pour créer des événements personnalisés, un développeur doit écrire un code JavaScript personnalisé pour qu'un événement soit soumis à HubSpot lorsque certaines conditions sont remplies. La documentation de l'API permettant de créer des événements personnalisés est disponible sur le forum des développeurs. Il existe deux types d'événements personnalisés : les événements JavaScript personnalisés et les événements d'API HTTP.

  • Événements JavaScript personnalisés

Lorsqu'une page est chargée et que le code de suivi HubSpot est exécuté, nous créons une variable _hsq qui agit telle une file d'attente à laquelle vous pouvez transmettre des événements de suivi. Pour ajouter des événements à suivre, vous pouvez définir un tableau pour la variable _hsq et le remplir d'appels d'événements. Pour appeler les méthodes, spécifiez le nom et les arguments correspondants (par exemple, _hsq.push(["method", "arg1", "arg2"]). Les variables doivent correspondre aux clés de propriété des contacts afin que leurs valeurs apparaissent correctement dans les enregistrements des contacts.

Événement JavaScript personnalisé
Événement JavaScript personnalisé
  • Ajoutez le code JavaScript pour créer l'événement personnalisé. Cet extrait JavaScript est automatiquement inclus lors du chargement du code de suivi HubSpot.
  • Spécifiez une URL de page afin de ne déclencher l'événement que lorsque les visiteurs accèdent à cette page spécifique. Si vous souhaitez que l'événement soit déclenché pour toutes les pages, ne spécifiez aucune URL de page.
  • Ajoutez une ou plusieurs étiquette pour organiser les événements.
  • Événements personnalisés via l'API HTTP

Vous pouvez également suivre un événement en adressant une requête à l'URL fournie lors de la création d'un événement d'API HTTP personnalisé. L'outil Événements génèrera une URL qui contient plusieurs paramètres de requête. Les requêtes liées à « track.hubspot.com » doivent être effectuées via la méthode GET (les protocoles HTTP et HTTPS sont pris en charge).

Événement d'API HTTP
Pour déclencher un événement d'API HTTP, vous devez soumettre une requête à notre API de suivi avec le chemin /v1/event.
  • Les deux paramètres obligatoires sont : «_n » (identifiant unique de l'événement) et « email » (adresse e-mail du contact qui a déclenché l'événement).
  • Pour générer l'ID de l'événement, cliquez sur le bouton Créer un rapport dans l'événement correspondant. Cliquez ensuite sur Afficher pour afficher l'événement enregistré, puis sur Modifier l'événement. Enfin, sélectionnez le lien Utiliser l'API HTTP. L'ID sera ajoutée en tant que paramètre dans l'URL de la requête.

    Événement d'API HTTP avec ID
    Une liste complète des paramètres facultatifs est disponible sur le forum des développeurs.

Pour plus d'informations, veuillez consulter les ressources ci-dessous.