Créer des événements personnalisés

Les événements personnalisés vous permettent de définir et de suivre des événements propres à votre entreprise. Les événements personnalisés peuvent être liés à des propriétés d'événement, que vous pouvez ensuite utiliser à travers les outils de HubSpot. 

Il existe trois façons différentes de créer des événements personnalisés : 

• Envoi via l'API : utilisez le point de terminaison Custom event definition pour créer votre événement. A partir de là, utilisez votre ID d'événement avec le point de terminaison send Custom event pour envoyer les événements terminés à HubSpot.
• Capturez les données de votre site web sans API :
  • Code Javascript : en utilisant Custom Javascript, vous pouvez insérer un code personnalisé dans votre script de suivi HubSpot en utilisant l'éditeur de code.
  • Utilisez le visualiseur d'événements : pour suivre les pages vues ou les éléments cliqués en les sélectionnant sur votre site web. En savoir plus sur la création d'événements personnalisés avec le visualiseur d'événements.
• Importer une feuille de calcul : télécharger une feuille de calcul de données d'événements pour capturer l'activité hors ligne, remplir les données ou intégrer manuellement n'importe quel outil à HubSpot.

Remarque : l'outil de personnalisation des événements remplace l'ancien outil de personnalisation des événements. 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 bloc de code JavaScript ou définir l'appel d'API qui déclenchera l'événement. 

Créer un événement via l'API

Si vous envoyez des données à HubSpot via l'API, vous devrez utiliser le point de terminaison Custom event definition pour créer votre événement. Ensuite, vous devrez définir l'appel à l'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 pour 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 interne d'un événement existant et les noms internes de propriété :

• Dans votre compte HubSpot, accédez à Reporting et données > Événements personnalisés.
• Cliquez sur Événements 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, localisez 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 de code, puis consultez le nom sous Nom interne.

Créer des événements à l'aide d'un bloc code Javascript

• Dans votre compte HubSpot, accédez à Reporting et données > Événements personnalisés.
• En haut à droite, cliquez sur Créer un événement.
• Sélectionnez Code Javascript.

• Cliquez sur Suivant.
• Saisissez un nom d'événement et fournissez éventuellement une description de l'événement.
• Sélectionner un objet associé . Cela vous permet d'associer vos événements exécutés à différents objets dans HubSpot, y compris des Contacts, des Entreprises, des Transactions et des Tickets. 

• Cliquez sur Suivant.

Ajouter des propriétés

Lorsqu'un événement est créé, les propriétés par défaut de cet é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é sous forme de chaîne de texte simple. 
  • Propriété de nombre personnalisée : créez une propriété sous forme de valeur numérique.
  • Propriété d'horodatage personnalisée : créez une propriété sous forme de valeur de date. Vous devez envoyer vos données sous forme de millisecondes epoch ou conformément à la norme 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é ainsi qu'une description.
  • Pour Propriétés d'énumération, cliquez sur Suivant et saisissez les Libellés et Valeurs de votre propriété. 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 sur 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énement par défaut de HubSpot. Vous pouvez modifier ou supprimer votre propriété en cliquant sur le menu déroulant Actions et en sélectionnant Modifier ou Supprimer. 
• Cliquez sur Next.
• Après avoir configuré l'événement et ses propriétés, vous pouvez ajouter cet événement au code de suivi de votre site web en sélectionnant le bloc de code Javascript.

La création d'événements avec un bloc de code Javascript vous permet d'ajouter automatiquement des éléments Javascript à votre code de suivi HubSpot. Cette procédure 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 Bloc de code Javascript. Utilisez le bloc de texte prédéfini 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 le bloc de texte prédéfini selon vos besoins en saisissant du texte dans le panneau de droite. Tout code sera automatiquement inclus dans le code de suivi HubSpot.
• Lorsque vous avez terminé, cliquez sur Create pour terminer votre événement et lancer automatiquement le suivi. 
  

Importer des données d'événements

Téléchargez vos données de participation à des événements en personne, des données horodatées provenant d'applications que vous n'intégrez pas à HubSpot, des données de campagnes ou de prospects ponctuels provenant d'un fournisseur, ou toute autre donnée d'événement sous forme de feuille de calcul. Les événements vous permettent de capturer un comportement et de l'utiliser ensuite dans HubSpot. 

• Dans votre compte HubSpot, accédez à Reporting et données > Événements personnalisés.

• En haut à droite, cliquez sur Créer un événement.
• Sélectionnez Importer une feuille de calcul.

• Cliquez sur Suivant.
• Saisissez un nom d'événement et fournissez éventuellement une description de l'événement.
• Sélectionner un objet associé . Cela vous permet d'associer vos événements exécutés à différents objets dans HubSpot, y compris des Contacts, des Entreprises, des Transactions et des Tickets. 

• Glissez-déposez un fichier dans la section Sélectionnez un fichier ou cliquez sur Choisissez un fichier pour télécharger un fichier depuis votre ordinateur.

• Cliquez sur le menu déroulant pour sélectionner la langue de vos en-têtes de colonne.

• Cliquez sur Suivant.
• Sur l'écran Map columns in your file to HubSpot properties, HubSpot mappera les colonnes de votre fichier aux propriétés des contacts et des événements en fonction de l'en-tête, de la langue de l'en-tête et du nom de la propriété.
• Le guide de mappage affiche les propriétés requises pour créer et/ou mettre à jour les contacts et les événements. S'il manque à votre fichier l'une des propriétés nécessaires pour atteindre l'objectif de votre importation, vous devez corriger votre fichier d'importation et relancer l'importation pour éviter les erreurs.
• Les colonnes de votre feuille de calcul peuvent être associées à des propriétés de contact ou à des propriétés d'événement. Cliquez sur le menu déroulant Import as pour sélectionner la manière d'importer les données du fichier. Ensuite, sélectionnez la propriété HubSpot à laquelle la mapper. Vous pouvez l'associer à une propriété existante ou en créer une nouvelle.

• Cliquez sur Suivant.
• Confirmez le nom de votre fichier d'importation.
• Cliquez sur la case pour accepter que les contacts s'attendent à recevoir des nouvelles de votre part et que votre fichier d'importation ne contienne pas de liste achetée. En savoir plus sur La politique d'utilisation acceptable de HubSpot.
• Cliquez sur le menu déroulant pour sélectionner le format de date de la propriété Occurred at.
• Cliquez sur Terminer l'import.

Utiliser des données d'événement personnalisées

Les données des événements personnalisés peuvent être visualisées et utilisées dans tous 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.

Vous pouvez ouvrir les événements sélectionnés directement dans certains outils HubSpot avec le menu déroulant des actions dans votre liste d'événements, la vue d'un seul événement, ou le coin supérieur droit des graphiques dans l'onglet Analyse.

Rapport sur les événements personnalisés

Les événements personnalisés peuvent être analysés à partir de l'outil d'événements personnalisés, et les données relatives aux é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 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 une fiche de contact qui a réalisé un événement personnalisé.
• Pour filtrer la chronologie d'un contact en fonction des événements réalisés, cliquez sur Filter activity, puis sélectionnez Custom event.
• Dans la chronologie du contact, cliquez pour développer l'événement et afficher ses détails.

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

Dans un Workflow, vous pouvez retarder l'exécution d'un événement personnalisé à l'aide d'une action Delay until event happens ou d'un déclencheur d'inscription à un événement.

• Dans votre compte HubSpot, accédez à Automatisations > Workflows.
• Cliquez sur le nom d'un workflow. Ou encore, apprenez à créer un nouveau Workflow.
• Pour ajouter un déclencheur :
  • Dans l'éditeur de workflow, cliquez sur Définir des critères d'inscription.
  • Dans le panneau de gauche, sélectionnez Lorsqu'un événement se produit. Configurez le critère, puis cliquez sur Ajouter un filtre.
  • Pour affiner davantage votre déclencheur, cliquez sur Add refinement filters. Vous pouvez sélectionner des propriétés supplémentaires pour affiner les objets que vous souhaitez inscrire dans le workflow.
  • Par défaut, les fiches d'informations ne seront inscrites dans un workflow que la première fois où elles répondront aux critères d'inscription. Pour activer la réinscription, dans la section Should [object] be re-enrollrolled in this workflow ?, sélectionnez Yes, re-enroll every time the trigger occurs.
• Pour ajouter un délai :
  • 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 Event, puis sélectionnez un custom event.
    • 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.

Remarque : tous les déclencheurs d'inscription à un événement seront séparés à l'aide de l'opérateur OR. Cela signifie qu'un seul des événements déclencheurs de l'inscription doit se produire pour que l'enregistrement soit inscrit dans le Workflow.

Le Workflow retardera alors les enregistrements inscrits jusqu'à ce qu'ils répondent aux critères de l'événement personnalisé spécifié ou sera déclenché lorsque l'événement se produira.