Connexion HubSpot

Dernière mise à jour : 2024-01-25
  • Créé pour :
  • Developer
    User
    Admin
    Leader

HubSpot est une plateforme CRM proposant l’ensemble des logiciels, intégrations et ressources dont vous avez besoin pour connecter les services marketing, ventes, gestion de contenu et clientèle. Elle vous permet de connecter vos données, vos équipes et votre clientèle sur une seule et même plateforme CRM.

Ceci Adobe Experience Platform destination tire parti de la fonction HubSpot API de contacts, pour mettre à jour les contacts dans HubSpot d’une audience Experience Platform existante après activation.

Les instructions vous permettant de vous authentifier sur votre instance HubSpot sont plus loin dans la section Authentifier à la destination.

Cas d’utilisation

Pour mieux comprendre quand et comment utiliser la destination HubSpot, consultez l’exemple de cas d’utilisation ci-dessous que les clientes et clients d’Adobe Experience Platform peuvent résoudre à l’aide de cette destination.

HubSpot Les contacts stockent des informations sur les individus qui interagissent avec votre entreprise. Votre équipe utilise les contacts existant dans HubSpot pour créer les audiences Experience Platform. Après avoir envoyé ces audiences à HubSpot, leurs informations sont mises à jour et chaque contact se voit attribuer une propriété avec sa valeur comme nom d’audience indiquant à quelle audience appartient le contact.

Conditions préalables

Reportez-vous aux sections ci-dessous pour connaître les conditions préalables à configurer dans Experience Platform et HubSpot et pour les informations que vous devez rassembler avant de travailler avec la variable HubSpot destination.

Conditions préalables d’Experience Platform

Avant d’activer des données dans HubSpot destination, vous devez avoir une schema, un dataset, et audiences créé dans Experience Platform.

Reportez-vous à la documentation Experience Platform pour Groupe de champs Détails de l’appartenance à une audience si vous avez besoin de conseils sur les états d’audience.

Conditions préalables pour l’ HubSpot destination

Notez les conditions préalables suivantes pour exporter des données de Platform vers votre HubSpot compte :

Vous devez disposer d’un HubSpot account

Pour exporter des données de Platform vers votre Hubspot vous devez disposer d’un HubSpot compte . Si vous n’en avez pas déjà un, consultez la page Configuration de votre compte HubSpot et suivez les conseils pour enregistrer et créer votre compte.

Rassemblez les HubSpot jeton d’accès aux applications privées

Vous avez besoin de votre HubSpot Access token pour autoriser le HubSpot destination pour effectuer des appels API via votre HubSpot application privée dans votre HubSpot compte . La variable Access token sert de Bearer token lorsque vous authentifier la destination.

Si vous ne disposez pas d’une application privée, suivez la documentation pour Création d’une application privée dans HubSpot.

IMPORTANT

Les portées ci-dessous doivent être attribuées à l’application privée :
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read

Informations d’identification Description Exemple
Bearer token La variable Access token de votre HubSpot application privée.
Pour obtenir votre HubSpot Access token suivez le HubSpot documentation à effectuer des appels API avec le jeton d’accès de votre application ;.
pat-na1-11223344-abcde-12345-9876-1234a1b23456

Mécanismes de sécurisation

HubSpot les applications privées sont soumises aux Limites de taux. Le nombre d’appels que votre application privée peut effectuer dépend de votre HubSpot abonnement au compte et si vous avez acheté le module complémentaire API. Reportez-vous également à la section Autres limites.

Identités prises en charge

HubSpot prend en charge la mise à jour des identités décrites dans le tableau ci-dessous. En savoir plus sur les identités.

Identité cible Exemple Description Considérations
email test@test.com Adresse électronique du contact. Obligatoire

Audiences prises en charge

Cette section décrit toutes les audiences que vous pouvez exporter vers cette destination.

Cette destination prend en charge l’activation de toutes les audiences générées par le Segmentation Service d’Experience Platform.

Cette destination prend également en charge l’activation des audiences décrites dans le tableau ci-dessous.

Type d’audience Description
Chargements personnalisés Audiences importées dans Experience Platform à partir de fichiers CSV.

Type et fréquence d’exportation

Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.

Élément Type Notes
Type d’exportation Basé sur les profils
  • Vous exportez tous les membres d’une audience, ainsi que les champs de schéma souhaités. (par exemple : adresse électronique, numéro de téléphone, nom), en fonction de votre mappage de champs.
  • En outre, une nouvelle propriété est créée dans HubSpot l’utilisation du nom de l’audience et de sa valeur est avec l’état d’audience correspondant de Platform, pour chacune des audiences sélectionnées.
Fréquence des exportations Diffusion en continu
  • Les destinations de diffusion en continu sont des connexions basées sur l’API « toujours actives ». Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des audiences, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur les destinations de diffusion en continu.

Se connecter à la destination

IMPORTANT

Pour vous connecter à la destination, vous avez besoin de l’événement Affichage des destinations et Gestion des destinations autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.

Dans Destinations > Catalogue, recherchez HubSpot. Vous pouvez également localiser cet élément dans la catégorie CRM.

S’authentifier auprès de la destination

Renseignez les champs obligatoires ci-dessous. Voir Rassemblez les HubSpot jeton d’accès aux applications privées pour obtenir des conseils.

  • Jeton de porteur: jeton d’accès pour votre HubSpot application privée.

Pour vous authentifier auprès de la destination, sélectionnez Se connecter à la destination.
Capture d’écran montrant comment s’authentifier sur l’interface utilisateur de Platform.

Si les détails fournis sont valides, l’interface utilisateur affiche un statut Connecté avec une coche verte. Vous pouvez ensuite passer à l’étape suivante.

Renseigner les détails de la destination

Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.
Capture d’écran de l’interface utilisateur de Platform montrant les détails de destination.

  • Nom : un nom par lequel vous reconnaîtrez cette destination à l’avenir.
  • Description : une description qui vous aidera à identifier cette destination à l’avenir.

Activer les alertes

Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.

Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.

Activer des audiences vers cette destination

IMPORTANT

Pour activer les données, vous avez besoin de l’événement Affichage des destinations, Activation des destinations, Afficher les profils, et Affichage de segments autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.

Consultez la section Activer les profils et les audiences vers les destinations d’exportation d’audiences en flux continu pour obtenir des instructions sur l’activation des audiences vers cette destination.

Mapper les attributs et les identités

Pour envoyer correctement vos données d’audience de Adobe Experience Platform vers le HubSpot destination, vous devez passer par l’étape de mappage des champs. Le mappage consiste à créer un lien entre vos champs de schéma de modèle de données d’expérience (XDM) dans votre compte Platform et leurs équivalents de la destination cible.

Pour mapper correctement vos champs XDM à HubSpot pour les champs de destination, procédez comme suit :

Mappage de la variable Email identité

La variable Email l’identité est un mappage obligatoire pour cette destination. Suivez les étapes ci-dessous pour le mapper :

  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Vous pouvez désormais voir une nouvelle ligne de mappage sur l’écran.
    Copie d’écran de l’interface utilisateur de Platform avec ajout d’un nouveau bouton de mappage mis en surbrillance.
  2. Dans le Sélectionner le champ source , choisissez la Sélectionner un espace de noms d’identité et sélectionnez une identité.
    Copie d’écran de l’interface utilisateur de Platform sélectionnant email comme attribut source à mapper en tant qu’identité.
  3. Dans le Sélectionner le champ cible , choisissez la Sélectionner des attributs et sélectionnez email.
    Copie d’écran de l’interface utilisateur de Platform sélectionnant email comme attribut cible à mapper en tant qu’identité.
Champ source Champ cible Obligatoire
IdentityMap: Email Identity: email Oui

Un exemple de mappage d’identité est illustré ci-dessous :
Exemple de capture d’écran de l’interface utilisateur de Platform avec mappage d’identité de courrier électronique.

Mappage facultatif Attributs

Pour ajouter d’autres attributs à mettre à jour entre votre schéma de profil XDM et votre HubSpot répétez les étapes ci-dessous :

  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Vous pouvez désormais voir une nouvelle ligne de mappage sur l’écran.
    Copie d’écran de l’interface utilisateur de Platform avec ajout d’un nouveau bouton de mappage mis en surbrillance.
  2. Dans le Sélectionner le champ source , choisissez la Sélectionner des attributs et sélectionnez l’attribut XDM.
    Capture d’écran de l’interface utilisateur de Platform sélectionnant Prénom comme attribut source.
  3. Dans le Sélectionner le champ cible fenêtre, choisissez Sélectionner des attributs et sélectionnez dans la liste des attributs automatiquement renseignés à partir de votre HubSpot compte . La destination utilise la variable HubSpot Propriétés API pour récupérer ces informations. Les deux HubSpot propriétés par défaut et toutes les propriétés personnalisées sont récupérées pour sélection en tant que champs cibles.
    Capture d’écran de l’interface utilisateur de Platform sélectionnant Prénom comme attribut cible.

Quelques mappages disponibles entre votre schéma de profil XDM et Hubspot sont illustrées ci-dessous :

Champ source Champ cible
xdm: person.name.firstName Attribute: firstname
xdm: person.name.lastName Attribute: lastname
xdm: workAddress.street1 Attribute: address
xdm: workAddress.city Attribute: city
xdm: workAddress.country Attribute: country

Un exemple utilisant ces mappages d’attributs est illustré ci-dessous :
Exemple de capture d’écran de l’interface utilisateur de Platform avec mappages d’attributs.

Lorsque vous avez terminé de fournir les mappages pour votre connexion de destination, sélectionnez Suivant.

Valider l’exportation des données

Pour vérifier que vous avez correctement configuré la destination, procédez comme suit :

  1. Connectez-vous au HubSpot , puis accédez à la Contacts pour vérifier les états de l’audience. Cette liste peut être configurée pour afficher les colonnes des propriétés personnalisées créées avec le nom de l’audience dont la valeur correspond aux états de l’audience.
    Capture d’écran de l’interface utilisateur de HubSpot montrant la page Contacts avec les en-têtes de colonne indiquant le nom de l’audience et les états de l’audience des cellules

  2. Vous pouvez également effectuer une analyse approfondie dans une Personne et accédez aux propriétés qui affichent le nom de l’audience et les états de l’audience.
    Capture d’écran de l’interface utilisateur de HubSpot montrant la page Contact avec des propriétés personnalisées indiquant le nom de l’audience et les états de l’audience.

Utilisation et gouvernance des données

Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux politiques d’utilisation des données. Pour obtenir des informations détaillées sur la manière dont Adobe Experience Platform applique la gouvernance des données, lisez la présentation de la gouvernance des données.

Ressources supplémentaires

Informations utiles supplémentaires de la section HubSpot la documentation est la suivante :

Journal des modifications

Cette section répertorie les nouvelles fonctionnalités et les mises à jour importantes de la documentation consacrée au connecteur de destination.

 Afficher le journal des modifications
Mois de publication Type de mise à jour Description
Septembre 2023 Version initiale Version initiale de la destination et publication de la documentation.

Sur cette page