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 à l'aide de l'assistant de code (BÊTA)

Dernière mise à jour: juillet 19, 2022

Disponible avec :

Marketing Hub Entreprise

Les événements comportementaux personnalisables permettent de définir et de suivre les événements uniques à votre entreprise, notamment les événements liés à l'environnement physique, physique, physique, physique, physique, physique, physique, 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 l'extrait de code Javascript ajoutent automatiquement des données d'événement au code de suivi HubSpot de votre site et nécessitent la configuration d'une personne familière avec Javascript. 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 toute propriété d'événement personnalisée.
  • Créer un extrait de code Javascript ou 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.
  • Dans l'angle supérieur droit, cliquez sur Créer un événement personnalisé.
  • Sélectionnez l'assistant de code (Code Wizard).

  • Saisissez un nom  d'événement et fournissez éventuellement votre description
  • Dans le menu déroulant, sélectionnez votre objet associé. Cela vous permet d'associer vos complétions d'événements à différents objets dans HubSpot, y compris les contacts, les entreprises, les transactions et les tickets

événement-nom-custom-behavioral

  • Cliquez sur Suivant pour continuer, puis cliquez sur Suivant pour continuer.

Ajouter des propriétés d'événement

Lorsqu'un événement est créé, les propriétés d'événement par défaut seront 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 :

  • Sélectionnez le type de propriété en cliquant sur le type de champ pour votre propriété. Les options comprennent : 
    • Propriété de chaîne personnalisée : créez une propriété qui est une chaîne de texte en clair. 
    • Propriété de numéro personnalisé : créez une propriété qui est une valeur numérique.
    • Propriété d'horodatage personnalisée : créez une propriété qui est une date. Vous devez envoyer vos données sous forme de millisecondes d'époque. 
    • Propriété d'énumération personnalisée : créez une propriété avec un ensemble de valeurs prédéfinies.

      create-property-custom-behavioral-event
    • Lorsque vous avez sélectionné votre propriété, configurez-la dans le panneau de droite :

    • Saisissez un nom pour la propriété et une Description pour la propriété.
    • Pour les propriétés d'énumération, cliquez sur Suivant et entrez les étiquettes et les valeurs de votre propriété. Vous devez définir vos valeurs et étiquettes avant de leur envoyer des données. Si cette étape n'est pas terminée avant l'envoi de données qui ne figurent pas dans la liste, les données ne seront pas disponibles pour utilisation. Pour envoyer plusieurs valeurs, séparez-les par un point-virgule.
    • Cliquez sur Terminé.
    • Une fois que votre propriété est créée, elle apparaîtra dans le tableau sous les propriétés d'événement par défaut de HubSpot (HubSpot' s default event properties) (en anglais seulement). Vous pouvez modifier ou supprimer votre propriété en sélectionnant le menu déroulant Actions et en sélectionnant 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 l'extrait de code Javascript, soit envoyer des données à HubSpot via l'API en sélectionnant Envoyer des données à HubSpot

Créer un extrait de code Javascript

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

  • Sélectionnez le bloc de code Javascript. Utilisez l'extrait 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 de code au besoin en saisissant du texte dans le panneau de droite. Tout code que vous ajoutez sera automatiquement inclus dans le code de suivi HubSpot.
  • Lorsque vous avez terminé, cliquez sur Créer pour terminer votre événement et démarrer automatiquement le suivi. 
    exemple-code-snippet-custom-event

Envoyer des données à HubSpot

Si vous envoyez des données à HubSpot, 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 terminer la création de votre événement à envoyer des données via l'API :

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

Pour trouver le nom d'événement interne d'un événement existant et les noms 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.
    événement-custom-name-interne
  • 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'
Remarque :
Lors de l'envoi de données à votre événement, les limites suivantes s'appliquent :
  • Les noms de propriété 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 de la demande d'API JS, HubSpot tronquera toutes les valeurs 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 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é.
  • Dans la chronologie du contact, cliquez pour développer l'événement et afficher ses détails.

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

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.