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 :
|
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.
- 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 :
- 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 simple.
- Propriété numérique personnalisée : 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 valeur de date. Vous devez envoyer vos données sous forme d'époques (epoch) en millisecondes ou en ISO8601.
- Propriété d'énumération personnalisée : créer une propriété avec un ensemble de valeurs prédéfinies.
- Lorsque vous avez sélectionné votre propriété, configurez-la dans le panneau de droite :
-
- 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.
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.
- 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.
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.
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:
- Depuis votre compte HubSpot, accédez à Automatisation > Workflows.
- Cliquez sur le nom d'un workflow. Ou encore, apprenez à créer un nouveau Workflow.
- Dans l'éditeur de workflow, cliquez sur l'icône + plus pour ajouter une action de workflow.
- Dans le panneau de droite, sélectionnez Délai 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 pour la propriété de l'é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.