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 personnalisés

Dernière mise à jour: octobre 15, 2024

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

Marketing Hub   Enterprise
Sales Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
Content Hub   Enterprise

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

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

    internal-name-custom-event
  • 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.
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 d'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 événement.

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.
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
détails de l'événement

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

    • 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. 
    example-code-snippet-custom-event

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. 

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

détails de l'événement

  • 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. Lors du téléchargement d'un fichier, les éléments suivants doivent être inclus :

même-fichier-événements-personnalisé

Exemple de fichier

Remarque : lors de l'importation de données d'événements, les limites ci-dessous s'appliquent :
  • Votre fichier doit être de type csv, .xlsx ou .xls 
  • Limité à 1 million de lignes.
  • Pour l'instant, les événements créés via l'importation ne peuvent être associés qu'à des contacts. 
  • Les événements ccréeront et mettront à jour les fiches de contact. TL'importation permettra de créer de nouveaux enregistrements et activités, ainsi que d'identifier et de mettre à jour les enregistrements existants. Pour créer de nouveaux enregistrements ou activités, votre fichier doit contenir les propriétés requises pour ce contact. Pour mettre à jour les enregistrements existants, votre dossier doit contenir un identifiant unique .
  • L'importation d'événements doit être utilisée pour des événements qui ont déjà eu lieu, les événements avec des dates futures ne sont pas pris en charge.

 

  • Cliquez sur le menu déroulant pour sélectionner la langue de vos en-têtes de colonne.
upload-spreadsheet-events
  • 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.
créer-nouvelle-propriété
  • 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.

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.