Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.
Analytics Tools

Créer des événements comportementaux personnalisés suivis manuellement

Dernière mise à jour: septembre 29, 2021

Disponible avec :

Marketing Hub Entreprise

Les événements comportementaux suivis manuellement permettent de définir et de suivre les événements uniques à votre entreprise. Les événements comportementaux personnalisés peuvent être liés aux propriétés de contact, que vous pouvez utiliser dans les outils HubSpot. Les événements suivis manuellement utilisent l'API d'analytics et nécessitent un développeur à des fins de configuration. 

Découvrez comment utiliser l'outil d'événement comportemental personnalisé pour créer des événements d'élément cliqué et des événements d'URL visitée.

Remarque : L'outil d'événements comportementaux personnalisés remplace le précédent outil d'événements comportementaux hérités. Tous les événements créés dans l'outil hérité continueront de fonctionner et vous pourrez toujours les gérer et les analyser dans cet outil

Le processus de création d'événements est en deux parties :

  • Définir l'événement dans HubSpot, y compris les propriétés de contact que vous souhaitez associer à l'événement.
  • Définir l'appel d'API qui déclenchera l'événement. 

Créer l'événement dans HubSpot

Pour configurer un événement comportemental personnalisé, vous devrez d'abord créer l'événement, puis y associer des propriétés :

  • Depuis votre compte HubSpot, accédez à Reports > Analytics Tools.
  • Cliquez sur Événements comportementaux personnalisés.
  • Cliquez sur Créer un événement dans l'angle supérieur droit.
  • Dans le panneau de droite, saisissez un nom pour votre événement, puis sélectionnez Événement suivi manuellement
    create-manually-tracked-event
  • L'événement sera alors créé et vous pourrez copier le nom interne, qui sera utilisé lors de la requête d'API. Pour copier le nom interne, cliquez sur Copier.

Puis configurez les propriétés qui seront utilisées dans votre appel d'API.

Ajouter et gérer des propriétés d'événement

La création de propriétés pour un événement permet à l'appel d'API d'envoyer et de stocker des données dans les propriétés de contact. Lorsque vous créez un événement, vous pouvez utiliser un ensemble de propriétés d'événement par défaut, et vous pouvez également créer vos propres propriétés personnalisées. Les propriétés d'événement sont stockées séparément des autres propriétés du CRM et sont uniques à l'événement (autrement dit, vous ne pouvez pas modifier ces propriétés depuis vos paramètres de compte). 

Pour afficher et créer des propriétés pour un événement :

  • Depuis votre compte HubSpot, accédez à Reports > Analytics Tools.
  • Cliquez sur Événements comportementaux personnalisés.
  • Cliquez sur le nom de l'événement que vous souhaitez afficher ou actualiser. Vous serez alors redirigé vers la page de détails de l'événement.
  • Dans le tableau Propriétés, consultez les propriétés par défaut créées pour l'événement. 
  • Pour modifier une propriété :
    • Cliquez sur le nom de la propriété.
    • Dans le panneau de droite, vous pouvez saisir un nouveau nom ou une nouvelle description. La modification du nom de la propriété ne modifiera pas le nom interne, vous n'aurez donc pas besoin de mettre à jour votre appel d'API si vous modifiez le nom d'une propriété.
    • Pour modifier le type de champ et configurer davantage la propriété, cliquez sur l'onglet Type de champ, puis utilisez les menus déroulants pour sélectionner un nouveau type de champ et configurez les détails de votre propriété. 
    • Cliquez sur Enregistrer.
  • Pour créer une nouvelle propriété :
    • Cliquez sur Créer une propriété dans l'angle supérieur droit.
    • Dans le panneau de droite, configurez la propriété :
      • Sélectionnez un groupe pour la propriété en cliquant sur le menu déroulant Groupe, puis en sélectionnant un groupe.
      • Pour définir le nom de la propriété, saisissez un nom dans le champ Libellé. Le nom que vous saisissez créera automatiquement le nom interne de la propriété.
        • Pour modifier le nom interne, cliquez sur l'icône de code code, puis sur le champ Nom interne pour saisir un nouveau nom. Une fois que la propriété est créée, le nom interne ne peut pas être mis à jour.

          Remarque : Le libellé de la propriété et le nom interne sont limités à 50 caractères.
        • Pour enregistrer le nom, cliquez sur Enregistrer
      • Vous pouvez également saisir une description facultative pour la propriété dans le champ Description.
      • Cliquez sur Suivant.
      • Sélectionnez le type de propriété en cliquant sur le menu déroulant Type de champ, puis sélectionnez un type de champ. Par défaut, la propriété sera disponible dans les formulaires et les bots. Pour empêcher l'utilisation du champ dans les formulaires et les bots, cliquez pour désélectionner la case Afficher dans les formulaires.
    • Cliquez sur Créer.

Définir l'appel d'API

Après avoir configuré l'événement et ses propriétés, vous devez définir l'appel d'API pour déclencher l'événement. Découvrez comment définir votre appel d'API dans la documentation pour les développeurs de HubSpot.

Vous aurez besoin de certaines informations pour votre appel d'API, que vous pouvez obtenir depuis HubSpot :

  • Nom de l'événement : le nom interne de l'événement.
  • Noms de propriété : les noms internes des propriétés auxquelles vous enverrez des données.

Pour trouver les noms internes d'événement et de propriété :

  • Depuis votre compte HubSpot, accédez à Reports > Analytics Tools.
  • Cliquez sur Événements comportementaux personnalisés.
  • Cliquez sur le nom de l'événement. Vous serez alors redirigé vers la page de détails de l'événement.
  • En haut de la page, recherchez le nom d'événement sous Nom interne

    custom-event-internal-name
  • Pour rechercher les noms internes des propriétés que vous mettez à jour, cliquez sur le nom d'une propriété.
  • Dans le panneau de droite, cliquez sur l'icône de code code, puis consultez le nom sous Nom interne.

Remarque : Lorsque vous envoyez des données à votre événement, gardez à l'esprit les limites suivantes :

  • Le libellé de la propriété et le nom interne sont limités à 50 caractères. 
  • Les propriétés d'URL et de référent peuvent contenir jusqu'à 1024 caractères, tandis que toutes les autres propriétés peuvent contenir jusqu'à 256 caractères.
  • Chaque événement peut contenir des données pour un maximum de 50 propriétés.
  • Les noms internes des propriétés doivent commencer par une lettre et ne contenir que des lettres minuscules de a à z, des chiffres de 0 à 9 et des tirets bas. Les propriétés ayant le même nom interne après la mise en minuscule sont considérées comme des doublons, et une seule des propriétés sera utilisée à la fin du processus.

Si ces limites sont dépassées lors d'une requête d'API HTTP, celle-ci échouera. Si ces limites sont dépassées lors d'une requête d'API JS, HubSpot tronquera toute valeur de nom de propriété à la longueur autorisée et/ou ne mettra à jour que 50 propriétés par événement.

Utiliser des données d'événements comportementaux personnalisés

Les données d'événements comportementaux personnalisés peuvent être consultées et utilisées dans les outils de HubSpot. Découvrez ci-dessous comment afficher les événements terminés et les façons dont vous pouvez intégrer ces données à d'autres outils.

Rapport sur les événements personnalisés

Les événements comportementaux personnalisés terminés peuvent être analysés depuis l'outil d'événements comportementaux personnalisés, et les données d'événements seront également disponibles dans l'éditeur de rapports personnalisés et les rapports d'attribution.

Découvrez-en davantage sur l'analyse de vos événements comportementaux personnalisés.

Afficher les événements terminés dans la chronologie d'un contact

Les événements terminés apparaîtront dans la chronologie de la fiche d'informations du contact, ainsi que toute propriété renseignée.

Pour afficher les détails d'un événement sur la chronologie d'un contact :

  • Accédez à la fiche d'informations du contact qui a terminé un événement comportemental personnalisé.
  • Pour filtrer la chronologie du contact par événements terminés, cliquez sur Filtrer l'activité, puis sélectionnez Événement comportemental personnalisé.

custom-behavioral-events-contact-timeline-filter

  • Dans la chronologie du contact, cliquez pour développer l'événement et afficher ses détails.
     custom-behavioral-events-contact-timeline-info

Utiliser des événements comportementaux personnalisés dans des workflows

Dans un workflow, vous pouvez configurer un délai en fonction des événements comportementaux personnalisés terminés à l'aide d'une action Retarder jusqu'à ce que l'événement se produise :

  • Depuis votre compte HubSpot, accédez à Automatisation > Workflows.
  • Cliquez sur le nom d'un workflow. Découvrez également comment créer un nouveau workflow.
  • Dans l'éditeur de workflow, cliquez sur l'icône Plus + pour ajouter une nouvelle action de workflow.
  • Dans le panneau de droite, sélectionnez Retarder jusqu'à ce que l'événement se produise.

workflow-delay-until-event-happens-action

  • Configurez le délai :
    • Cliquez sur le menu déroulant Événement, puis sélectionnez un événement comportemental personnalisé.
    • Puis sélectionnez la propriété de l'événement que vous souhaitez retarder.
    • Sélectionnez le filtre de la propriété d'événement.
    • Cliquez sur Appliquer le filtre.

      workflow-delay-until-event-device-type
    • Sélectionnez le temps écoulé maximum ou sélectionnez la case à cocher Délai le plus long possible.
  • Cliquez sur Enregistrer.

Le workflow retardera alors les fiches d'informations inscrites jusqu'à ce qu'elles répondent aux critères d'événement comportementaux personnalisés spécifiés.