DocumentationExperience PlatformGuide des destinations

Connexion HubSpot

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration
  • Utilisateur ou utilisatrice

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.

Cette Adobe Experience Platform destination utilise l’API HubSpot Contacts pour mettre à jour les contacts dans HubSpot à partir 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 use-cases

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 contacts stockent des informations sur les individus qui interagissent avec votre entreprise. Votre équipe utilise les contacts qui existent 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 qui indique à quelle audience appartient le contact.

Conditions préalables prerequisites

Reportez-vous aux sections ci-dessous pour connaître les conditions préalables à configurer dans Experience Platform et HubSpot et pour obtenir des informations que vous devez rassembler avant d’utiliser la destination HubSpot.

Conditions préalables d’Experience Platform prerequisites-in-experience-platform

Avant d’activer des données dans la destination HubSpot, vous devez avoir créé un schéma, un jeu de données et des audiences dans Experience Platform.

Reportez-vous à la documentation Experience Platform pour le groupe de champs de schéma Détails sur l’appartenance à une audience si vous avez besoin de conseils sur les statuts de l’audience.

Conditions préalables pour la destination HubSpot prerequisites-destination

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

Vous devez disposer d'un compte HubSpot prerequisites-account

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

Collecter le jeton d’accès à l’application privée HubSpot gather-credentials

Vous avez besoin de votre Access token HubSpot pour permettre à la destination HubSpot d’effectuer des appels API via votre application privée HubSpot dans votre compte HubSpot. Le Access token sert de Bearer token lorsque vous authentifiez la destination.

Si vous ne disposez pas d’une application privée, consultez la documentation pour ​ Créer 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
Access token de votre application privée HubSpot.
Pour obtenir votre HubSpot, Access token suivre la documentation HubSpot pour 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 guardrails

HubSpot applications privées sont soumises à des limites de taux. Le nombre d’appels que votre application privée peut effectuer est basé sur votre abonnement au compte HubSpot et sur le fait que vous ayez ou non acheté le module complémentaire API. Reportez-vous également à la section ​ Autres limites ​.

Identités prises en charge supported-identities

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 supported-audiences

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 export-type-frequency

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 e-mail, 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’aide du nom de l’audience et sa valeur est définie avec le statut d’audience correspondant d’Experience 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 connect

IMPORTANT
Pour vous connecter à la destination, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations et Gérer les destinations 🔗. 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 authenticate

Renseignez les champs obligatoires ci-dessous. Reportez-vous à la section Collecter le jeton HubSpot ’accès d’application privée pour obtenir des conseils.

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

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

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 destination-details

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 d’Experience Platform affichant les détails de la 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 enable-alerts

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 activate

IMPORTANT
Pour activer les données, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations, Activer les destinations, Afficher les profils et Afficher les segments 🔗. 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 map

Pour envoyer correctement vos données d’audience de Adobe Experience Platform vers la destination HubSpot, 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 Experience Platform et leurs équivalents issus de la destination cible.

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

Mappage de l’identité Email

L’identité Email 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. Une nouvelle ligne de mappage s’affiche désormais à l’écran.
    Capture d’écran de l’interface utilisateur d’Experience Platform avec le bouton Ajouter un nouveau mappage mis en surbrillance.
  2. Dans la fenêtre Sélectionner le champ source, choisissez le Sélectionner l’espace de noms d’identité et sélectionnez une identité.
    Capture d’écran de l’interface utilisateur d’Experience Platform sélectionnant l’e-mail comme attribut source à mapper en tant qu’identité.
  3. Dans la fenêtre Sélectionner le champ cible, choisissez le Sélectionner les attributs et sélectionnez email.
    Capture d’écran de l’interface utilisateur d’Experience Platform sélectionnant l’e-mail comme attribut cible à mapper en tant qu’identité.
Champ source
Champ cible
Obligatoire
IdentityMap: Email
Identity: email
Oui

Un exemple avec le mappage d’identité est illustré ci-dessous :
Exemple de capture d’écran de l’interface utilisateur d’Experience Platform avec mappage d’identité d’e-mail.

Mappage facultatif attributs

Pour ajouter tout autre attribut que vous souhaitez mettre à jour entre votre schéma de profil XDM et votre compte HubSpot, répétez les étapes ci-dessous :

  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affiche désormais à l’écran.
    Capture d’écran de l’interface utilisateur d’Experience Platform avec le bouton Ajouter un nouveau mappage mis en surbrillance.
  2. Dans la fenêtre Sélectionner le champ source, choisissez la catégorie Sélectionner des attributs et sélectionnez l’attribut XDM.
    Capture d’écran de l’interface utilisateur d’Experience Platform sélectionnant le prénom en tant qu’attribut source.
  3. Dans la fenêtre Sélectionner le champ cible, choisissez la catégorie Sélectionner les attributs et sélectionnez dans la liste des attributs qui sont automatiquement renseignés à partir de votre compte HubSpot. La destination utilise l’API HubSpot Properties pour récupérer ces informations. Les HubSpot propriétés par défaut et les propriétés personnalisées sont récupérées pour être sélectionnées en tant que champs cibles.
    Capture d’écran de l’interface utilisateur d’Experience Platform sélectionnant le prénom en tant qu’attribut cible.

Voici quelques mappages disponibles entre votre schéma de profil XDM et Hubspot :

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 d’utilisation de ces mappages d’attributs est illustré ci-dessous :
Exemple de capture d’écran de l’interface utilisateur d’Experience 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 exported-data

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

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

  2. Vous pouvez également explorer une page Personne individuelle et accéder aux propriétés affichant le nom de l’audience et les statuts de l’audience.
    Capture d’écran de l’interface utilisateur HubSpot) montrant la page Contact avec des propriétés personnalisées affichant le nom de l’audience et les statuts de l’audience.

Utilisation et gouvernance des données data-usage-governance

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 additional-resources

Retrouvez d’autres informations utiles de la documentation HubSpot ci-dessous :

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
table 0-row-3 1-row-3 layout-auto
Mois de publication Type de mise à jour Description
Septembre 2023 Version initiale Publication de la destination initiale et de la documentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6