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.

Créer des événements comportementaux personnalisés avec l'assistant de code

Dernière mise à jour: juin 21, 2023

Disponible avec le ou les abonnements suivants, sauf mention contraire :

Marketing Hub Entreprise

Les événements comportementaux personnalisés vous permettent de définir et de suivre des événements propres à votre entreprise. Les événements comportementaux personnalisés peuvent être liés aux propriétés d'événement, que vous pouvez utiliser dans les outils HubSpot. Les événements créés avec le "bloc de code Javascript ajoutent automatiquement des données d'événement au code de suivi HubSpot de votre site et nécessitent une personne familière avec Javascript pour les mettre en place. Les événements suivis manuellement utilisent l'API analytique , et nécessitent un développeur pour être mis en place. 

Apprenez à utiliser l'outil de personnalisation des événements comportementaux pour créer des événements pour les éléments cliqués et pour les URL visitées.

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 toute propriété d'événement personnalisée.
  • Création d'un bloc de code Javascript ou Définition de l'appel 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 à Rapports > Analytics.
  • Cliquez sur Événements comportementaux personnalisés.
  • En haut à droite, cliquez sur Créer un événement personnalisé.
  • Sélectionnez Code Wizard.

  • Saisissez le nom de l'événement et fournissez éventuellement une description de l'événement
  • Dans le menu déroulant, sélectionnez votre objet associé. Cela vous permet d'associer les événements terminés à différents objets dans HubSpot, y compris les contacts, les entreprises, les contrats et les billets

nom de l'événement comportemental personnalisé

  • Cliquez sur Suivant pour continuer.

Ajouter les propriétés de l'événement

Lorsqu'un événement est créé, les propriétés par défaut de l'événement sont disponibles. 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 créer des propriétés pour un événement :

    • Saisissez un nom pour la propriété et saisissez une description pour la propriété.
    • Pour les propriétés d'énumération, cliquez sur Suivant et saisissez les Libellés et les Valeurs devos propriétés. Vous devez définir vos valeurs et vos libellés avant de leur envoyer des données. Si cette étape n'est pas réalisée avant d'envoyer des données qui ne figurent pas dans la liste, les données ne pourront pas être utilisées. Pour envoyer plusieurs valeurs, séparez-les par un point-virgule.
    • Cliquez sur Terminé.
    • Une fois votre propriété créée, elle apparaîtra dans le tableau sous les propriétés d'événements par défaut de HubSpot. Vous pouvez modifier ou supprimer votre propriété en sélectionnant le menu déroulant Actions et en choisissant Modifier ou Supprimer
  • Cliquez sur Suivant.
  • Après avoir configuré l'événement et ses propriétés, vous pouvez soit ajouter cet événement au code de suivi de votre site web en sélectionnant Bloc de code Javascript, soit envoyer les données à HubSpot via l'API en sélectionnant Envoyer les données à HubSpot

Créer un bloc de code Javascript

La création d'événements avec un bloc de code Javascript vous permet d'ajouter automatiquement du Javascript à votre code de suivi HubSpot. Elle peut être utilisée pour capturer des données d'événements plus complexes que le code de suivi ne capture pas par défaut. 

  • Sélectionnez le bloc de code Javascript. Utilisez le snippet dans le panneau de droite pour suivre l'événement dans HubSpot. Toutes les propriétés personnalisées créées seront prédéfinies dans le bloc de code. 
  • Modifiez l'extrait selon vos besoins en saisissant du texte dans le panneau de droite. Tout code que vous ajoutez sera automatiquement inclus dans votre code de suivi HubSpot.
  • Lorsque vous avez terminé, cliquez sur Créer pour terminer votre événement et lancer automatiquement le suivi.
    exemple de bloc de code-événement personnalisé

Envoyer des données à HubSpot

Si vous envoyez des données à HubSpot, vous devez définir l'appel API qui déclenchera l'événement. Apprenez à définir votre appel API sur 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 terminer, créez votre événement pour envoyer des données via l'API :

  • Sélectionnez Envoyer les données à HubSpot et copiez l'ID de suivi.
  • Cliquez sur Créer.

Pour trouver le nom de l'événement interne d'un événement existant et les noms des propriétés :

  • Depuis votre compte HubSpot, accédez à Rapports > Analytics.
  • 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, repérez le nom de l'événement sous Nom interne.
    nom interne-événement personnalisé
  • Pour trouver les noms internes des propriétés que vous allez mettre à jour, cliquez sur le nom d'une propriété.
  • Dans le panneau de droite, cliquez sur l'icône du code, puis affichez le nom sous Nom interne.
Remarque :
Lors de l'envoi de données à votre événement, les limites ci-dessous s'appliquent :
  • Les noms des propriétés 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 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 achèvement d'é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 le générateur de rapports personnalisés et les rapports d'attribution.

En savoir plus 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 :

  • Naviguer vers un enregistrement de contact qui a terminé un événement comportemental personnalisé.
  • Pour filtrer la chronologie d'un contact en fonction des événements terminés, cliquez sur Filtrer l'activité, puis sélectionnez Personnaliser l'événement comportemental.
  • Dans la chronologie des contacts, cliquez sur pour développer l'événement et en afficher les détails.

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

Dans un Workflow, vous pouvez retarder l'exécution d'un événement comportemental personnalisé à l'aide d'une action Retarder jusqu'à ce que l'événement se produise:

    • 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. 

Cet article vous a-t-il été utile ?
Ce formulaire n'est utilisé que pour recueillir du feedback sur la documentation. Découvrez comment obtenir de l'aide sur HubSpot.