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 : 

• Envoyer via l’API : utilisez le point de terminaison de définition d’événement personnalisé 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.
  • Utiliser le visualiseur d'événements ("Marketing Hub Entreprise"uniquement) : 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 une API, vous devrez utiliser le point de terminaison de définition d’événement personnalisé 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é :

• Depuis votre compte HubSpot, accédez à Gestion des 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

• Depuis votre compte HubSpot, accédez à Gestion des 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 :

• Adresse e-mail du contact.
• S’est produit à l’horodatage . En savoir plus sur le formatage des propriétés des dates dans les fichiers d'importation.

Exemple de fichier

Pour importer des événements personnalisés :

• Depuis votre compte HubSpot, accédez à Gestion des 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é . Pour le moment, les événements créés via l’import ne peuvent être associés qu’à des contacts.

• Téléchargez le fichier. Sélectionnez le mode d’import des objets et la langue du fichier, puis cliquez sur Suivant.

• Mappez les colonnes à des propriétés d’événement et de contact, puis cliquez sur Suivant.

• Confirmez le nom de votre fichier d’import.
• Cochez la case pour confirmer que les contacts s’attendent à recevoir de vos messages et que votre fichier d’import ne contient pas de liste achetée. En savoir plus sur La politique d'utilisation acceptable de HubSpot.
• Sélectionnez le format de date de la propriété S’est produit à .
• 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.