Documentation Experience Platform Guide des destinations

Connexion Salesforce CRM

Last update: Tue Nov 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Destinations

Créé pour :

Administration
Utilisateur ou utilisatrice

Présentation overview

Salesforce CRM est une plateforme de gestion de la relation client (GRC) populaire qui prend en charge les types de profils décrits ci-dessous :

Prospects - Un prospect est le nom d'une personne ou d'une entreprise qui pourrait (ou non) être intéressée par les produits ou services que vous vendez.
Contacts - Un contact est une personne avec laquelle l’un de vos représentants a établi une relation et qui a été qualifiée de client potentiel.

Cette Adobe Experience Platform destination tire parti du Salesforce composite API , qui prend en charge les deux types de profils décrits ci-dessus.

Lors de l’activation des segments, vous pouvez choisir entre les prospects ou les contacts et mettre à jour les attributs et les données d’audience dans Salesforce CRM.

Salesforce CRM utilise OAuth 2 avec l’octroi de mot de passe comme mécanisme d’authentification pour communiquer avec l’API REST Salesforce. Les instructions vous permettant de vous authentifier sur votre instance Salesforce CRM sont plus loin dans la section Authentifier à la destination.

Cas d’utilisation use-cases

En tant que professionnel du marketing, vous pouvez proposer des expériences personnalisées à vos utilisateurs en fonction des attributs de leurs profils Adobe Experience Platform. Vous pouvez créer des audiences à partir de vos données hors ligne et envoyer ces audiences vers le CRM Salesforce, afin de mettre à jour l’appartenance au CRM dès que les audiences et les profils sont mis à jour dans Adobe Experience Platform.

Conditions préalables prerequisites

Conditions préalables dans Experience Platform prerequisites-in-experience-platform

Avant d’activer des données vers la destination Salesforce CRM, vous devez disposer d’un schéma, d’un jeu de données et de segments créés dans Experience Platform.

Conditions préalables dans Salesforce CRM prerequisites-destination

Notez les conditions préalables suivantes dans Salesforce CRM, afin d’exporter des données d’Experience Platform vers votre compte Salesforce :

Vous devez avoir un compte Salesforce. prerequisites-account

Accédez à la page Salesforce version d’évaluation pour vous enregistrer et créer un compte Salesforce, le cas échéant.

Configuration d’une application connectée dans Salesforce prerequisites-connected-app

Tout d’abord, vous devez configurer une Salesforce application connectée dans votre compte Salesforce, si vous n’en avez pas déjà une. Salesforce CRM utilisera l’application connectée pour vous connecter à Salesforce.

Ensuite, activez OAuth Settings for API Integration pour le Salesforce connected app. Reportez-vous à la documentation Salesforce pour obtenir des conseils.

Assurez-vous également que les portées mentionnées ci-dessous sont sélectionnées pour le Salesforce connected app.

chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access

Enfin, assurez-vous que l’octroi de password est activé dans votre compte Salesforce. Reportez-vous à la documentation Salesforce Flux nom d’utilisateur-mot de passe OAuth 2.0 pour les scénarios spéciaux si vous avez besoin de conseils.

IMPORTANT

Si l’administrateur de votre compte Salesforce a limité l’accès aux plages d’adresses IP de confiance, vous devez le contacter pour obtenir les adresses IP d’Experience Platformplacer sur la liste autorisée . Reportez-vous à la documentation Salesforce Limiter l’accès aux plages d’adresses IP de confiance pour une application connectée si vous avez besoin de conseils supplémentaires.

Créer des champs personnalisés dans Salesforce prerequisites-custom-field

Lors de l’activation des audiences vers la destination Salesforce CRM, vous devez saisir une valeur dans le champ Mapping ID pour chaque audience activée, à l’étape Planning des audiences.

Salesforce CRM a besoin de cette valeur pour lire et interpréter correctement les audiences provenant d’Experience Platform et pour mettre à jour leur statut d’audience dans Salesforce. 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.

Pour chaque audience activée d’Experience Platform vers Salesforce CRM, vous devez créer un champ personnalisé de type Text Area (Long) dans Salesforce. Vous pouvez définir la longueur des caractères du champ de n’importe quelle taille entre 256 et 131 072 caractères en fonction des besoins de votre entreprise. Consultez la page de documentation Salesforce Types de champs personnalisés pour plus d’informations sur les types de champs personnalisés. Reportez-vous également à la documentation Salesforce pour créer des champs personnalisés si vous avez besoin d’aide pour la création de champs.

IMPORTANT

N’incluez pas d’espaces dans le nom du champ. Utilisez plutôt le caractère de soulignement (_) comme séparateur.
Dans Salesforce, vous devez créer des champs personnalisés avec un Field Name qui correspond exactement à la valeur spécifiée dans Mapping ID pour chaque segment Experience Platform activé. Par exemple, la capture d’écran ci-dessous montre un champ personnalisé nommé crm_2_seg. Lors de l’activation d’une audience vers cette destination, ajoutez crm_2_seg en tant que Mapping ID pour renseigner les audiences d’Experience Platform dans ce champ personnalisé.

Un exemple de création de champ personnalisé dans Salesforce, Étape 1 - Sélectionner le type de données, est illustré ci-dessous :
Capture d’écran de l’interface utilisateur de Salesforce montrant la création de champs personnalisés, Étape 1 - Sélectionnez le type de données.

Un exemple de création de champ personnalisé dans Salesforce, Étape 2 - Saisissez les détails du champ personnalisé, est illustré ci-dessous :
Capture d’écran de l’interface utilisateur de Salesforce montrant la création d’un champ personnalisé, Étape 2 : saisissez les détails du champ personnalisé.

TIP

Pour faire la distinction entre les champs personnalisés utilisés pour les audiences Experience Platform et d’autres champs personnalisés dans Salesforce, vous pouvez inclure un préfixe ou un suffixe reconnaissable lors de la création du champ personnalisé. Par exemple, au lieu de test_segment, utilisez Adobe_test_segment ou test_segment_Adobe
Si d’autres champs personnalisés ont déjà été créés dans Salesforce, vous pouvez utiliser le même nom que le segment Experience Platform pour identifier facilement l’audience dans Salesforce.

NOTE

Les objets dans Salesforce sont limités à 25 champs externes. Voir Attributs de champ personnalisés.
Cette restriction implique que vous ne pouvez avoir qu’un maximum de 25 appartenances à une audience Experience Platform actives à tout moment.
Si vous avez atteint cette limite dans Salesforce, vous devez supprimer les attributs personnalisés de Salesforce utilisés pour stocker le statut de l’audience par rapport aux audiences plus anciennes dans Experience Platform avant de pouvoir utiliser une nouvelle Mapping ID.

Collectez les informations d’identification de Salesforce CRM. gather-credentials

Notez les éléments ci-dessous avant de vous authentifier à la destination Salesforce CRM :

Informations d’identification

Description

Exemple

Username

Nom d’utilisateur de votre compte Salesforce.

Password

Mot de passe de votre compte Salesforce.

Security Token

Votre jeton de sécurité Salesforce que vous ajouterez ultérieurement à la fin de votre mot de passe Salesforce pour créer une chaîne concaténée à utiliser comme Password lors de l’authentification à la destination.
Reportez-vous à la documentation Salesforce pour réinitialiser votre jeton de sécurité afin de savoir comment le régénérer à partir de l’interface Salesforce si vous ne disposez pas du jeton de sécurité.

Custom Domain

Votre préfixe de domaine Salesforce.
Consultez la Salesforce documentation pour savoir comment obtenir cette valeur à partir de l’interface Salesforce.

Si votre domaine de Salesforce est
d5i000000isb4eak-dev-ed.my.salesforce.com,
vous aurez besoin de d5i000000isb4eak-dev-ed comme valeur.

Client ID

Votre Consumer Key Salesforce.
Reportez-vous à la Salesforce documentation pour savoir comment obtenir cette valeur à partir de l’interface Salesforce.

Client Secret

Votre Consumer Secret Salesforce.
Reportez-vous à la Salesforce documentation pour savoir comment obtenir cette valeur à partir de l’interface Salesforce.

Mécanismes de sécurisation guardrails

Salesforce équilibre la charge des transactions en imposant des limites de requête, de taux et de délai d’expiration. Pour plus d’informations, consultez Limites et allocations de requêtes API.

Si l’administrateur de votre compte Salesforce a appliqué des restrictions IP, vous devez ajouter les adresses IP Experience Platform aux plages d’adresses IP de confiance de vos comptes Salesforce. Reportez-vous à la documentation Salesforce Limiter l’accès aux plages d’adresses IP de confiance pour une application connectée si vous avez besoin de conseils supplémentaires.

IMPORTANT

Lors de l’activation des segments vous devez choisir entre les types Contact ou Lead. Vous devez vous assurer que vos audiences disposent du mappage de données approprié en fonction du type sélectionné.

Identités prises en charge supported-identities

Salesforce CRM 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

Description

Considérations

SalesforceId

Identifiant Salesforce CRM pour les identités de contact ou de prospect que vous exportez ou mettez à jour via votre segment.

Obligatoire

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

Profile-based

Vous exportez tous les membres d’un segment, 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.
Chaque statut d’audience dans Salesforce CRM est mis à jour avec le statut d’audience correspondant d’Experience Platform, en fonction de la valeur Mapping ID fournie lors de l’étape planification de l’audience.

Fréquence des exportations

Streaming

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 View Destinations et Manage 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 > Catalog, recherchez Salesforce CRM. Vous pouvez également localiser cet élément dans la catégorie CRM .

S’authentifier auprès de la destination authenticate

Pour vous authentifier auprès de la destination, renseignez les champs obligatoires ci-dessous et sélectionnez Connect to destination. Reportez-vous à la section Collecter Salesforce CRM informations d’identification pour obtenir des conseils.

Informations d’identification

Description

Username

Nom d’utilisateur de votre compte Salesforce.

Password

Chaîne concaténée composée du mot de passe de votre compte Salesforce, suivie du jeton de sécurité Salesforce.
La valeur concaténée prend la forme d’{PASSWORD}{TOKEN}.
Remarque : n’utilisez pas d’accolades ni d’espaces.
Par exemple, si votre mot de passe Salesforce est MyPa$$w0rd123 et Salesforce jeton de sécurité est TOKEN12345....0000, la valeur concaténée que vous utiliserez dans le champ Password est MyPa$$w0rd123TOKEN12345....0000.

Custom Domain

Votre préfixe de domaine Salesforce.
Par exemple, si votre domaine est d5i000000isb4eak-dev-ed.my.salesforce.com, vous devez fournir d5i000000isb4eak-dev-ed comme valeur.

Client ID

Votre Salesforce d’application connectée Consumer Key.

Client Secret

Votre Salesforce d’application connectée Consumer Secret.

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 Connected avec une coche verte, vous pouvez 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.

Name : nom par lequel vous reconnaîtrez cette destination à l’avenir.
Description : une description qui vous aidera à identifier cette destination à l’avenir.
Salesforce ID Type :
- Sélectionnez Contact si les identités que vous souhaitez exporter ou mettre à jour sont de type Contact.
- Sélectionnez Lead si les identités que vous souhaitez exporter ou mettre à jour sont de type Lead.

Capture d’écran de l’interface utilisateur d’Experience Platform affichant les détails de la destination.

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

Activer des audiences vers cette destination activate

IMPORTANT

Pour activer les données, vous avez besoin des autorisations de contrôle d’accès View Destinations, Activate Destinations, View Profiles et View Segments Access control. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.
Pour exporter des identités, vous devez disposer de l’autorisation de contrôle d’accès View Identity Graph🔗.
{width="100" modal="regular"}

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.

Considérations sur le mappage et exemple mapping-considerations-example

Pour envoyer correctement vos données d’audience d’Adobe Experience Platform vers la destination Salesforce CRM, 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.

Les attributs spécifiés dans le Target field doivent être nommés exactement comme décrit dans le tableau des mappages d’attributs, car ces attributs formeront le corps de la requête.

Les attributs spécifiés dans le Source field ne suivent aucune restriction de ce type. Vous pouvez la mapper en fonction de vos besoins, mais assurez-vous que le format des données d’entrée est valide, conformément à la Salesforce documentation. Si les données d’entrée ne sont pas valides, l’appel de mise à jour à Salesforce échoue et vos contacts/prospects ne sont pas mis à jour.

Pour mapper correctement vos champs XDM vers les champs de destination (API) Salesforce CRM, procédez comme suit :

À l’étape Mapping, sélectionnez Add new mapping. Une nouvelle ligne de mappage s’affiche à l’écran.
Dans la fenêtre Select source field , choisissez la catégorie Select attributes et sélectionnez l’attribut XDM ou choisissez le Select identity namespace et sélectionnez une identité.

Dans la fenêtre Select target field , choisissez le Select identity namespace et sélectionnez une identité ou choisissez Select custom attributes catégorie et sélectionnez un attribut ou définissez-en un à l’aide du champ Attribute name , si nécessaire. Reportez-vous à la Salesforce CRM documentation pour obtenir des conseils sur les attributs pris en charge.

Répétez ces étapes pour ajouter les mappages suivants entre votre schéma de profil XDM et (API) Salesforce CRM :

Utilisation des contacts

Si vous utilisez des Contacts au sein de votre segment, reportez-vous à la section Référence d’objet dans Salesforce pour Contact afin de définir des mappages pour les champs à mettre à jour.
Vous pouvez identifier les champs obligatoires en recherchant le mot Obligatoire, qui est mentionné dans la description des champs dans le lien ci-dessus.

Selon les champs que vous souhaitez exporter ou mettre à jour, ajoutez des mappages entre votre schéma de profil XDM et (API) Salesforce CRM :

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Champ source	Champ cible	Remarques
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`. Nom du contact (80 caractères maximum).
`xdm: person.name.firstName`	`Attribute: FirstName`	Prénom du contact, 40 caractères maximum.
`xdm: personalEmail.address`	`Attribute: Email`	Adresse électronique du contact.

Un exemple d’utilisation de ces mappages est illustré ci-dessous :

Utilisation des prospects

Si vous utilisez des prospects au sein de votre segment, reportez-vous à la section Référence d’objet dans Salesforce pour les prospects afin de définir les mappages pour les champs à mettre à jour.
Vous pouvez identifier les champs obligatoires en recherchant le mot Obligatoire, qui est mentionné dans la description des champs dans le lien ci-dessus.

Selon les champs que vous souhaitez exporter ou mettre à jour, ajoutez des mappages entre votre schéma de profil XDM et (API) Salesforce CRM :

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Champ source	Champ cible	Remarques
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`. Nom du prospect (80 caractères maximum)
`xdm: b2b.companyName`	`Attribute: Company`	`Mandatory`. La compagnie du chef.
`xdm: personalEmail.address`	`Attribute: Email`	Adresse électronique du prospect.

Un exemple d’utilisation de ces mappages est illustré ci-dessous :

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

Planifier l’exportation de l’audience et exemple schedule-segment-export-example

Lors de l’exécution de l’étape Planifier l’exportation d’audiences , vous devez mapper manuellement les audiences activées depuis Experience Platform à leur champ personnalisé correspondant dans Salesforce.

Pour ce faire, sélectionnez chaque segment, puis saisissez le nom du champ personnalisé à partir de Salesforce dans le champ Salesforce CRM Mapping ID . Reportez-vous à la section Créer des champs personnalisés dans Salesforce pour obtenir des conseils et connaître les bonnes pratiques sur la création de champs personnalisés dans Salesforce.

Par exemple, si votre champ personnalisé Salesforce est crm_2_seg, spécifiez cette valeur dans le Salesforce CRM Mapping ID pour renseigner les audiences d’Experience Platform dans ce champ personnalisé.

Un exemple de champ personnalisé de Salesforce est illustré ci-dessous :
Capture d’écran de l’interface utilisateur Salesforce affichant le champ personnalisé.

Un exemple indiquant l’emplacement du Salesforce CRM Mapping ID est illustré ci-dessous :
Exemple de capture d’écran de l’interface utilisateur d’Experience Platform montrant la planification de l’exportation de l’audience.

Comme indiqué ci-dessus, le Salesforce Field Name correspond exactement à la valeur spécifiée dans Salesforce CRM Mapping ID.

Selon votre cas d’utilisation, toutes les audiences activées peuvent être mappées au même champ personnalisé Salesforce ou à différentes Field Name dans Salesforce CRM. Un exemple type basé sur l’image affichée ci-dessus pourrait être .

Salesforce CRM le nom du segment

Salesforce Field Name

Salesforce CRM Mapping ID

crm_1_seg

crm_1_seg

crm_2_seg

crm_2_seg

Répétez cette section pour chaque segment Experience Platform activé.

Valider l’exportation des données exported-data

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

Sélectionnez Destinations > Browse pour accéder à la liste des destinations.
Sélectionnez la destination et vérifiez que le statut est enabled.
Passez à l’onglet Activation data , puis sélectionnez un nom d’audience.
Surveillez le résumé de l’audience et assurez-vous que le nombre de profils correspond au nombre créé dans le segment.
Enfin, connectez-vous au site web de Salesforce et vérifiez si les profils de l’audience ont été mis à jour.

Utilisation des contacts
- Si vous avez sélectionné Contacts dans votre segment Experience Platform, accédez à la page Apps > Contacts.
- Sélectionnez un Contact et vérifiez si les champs sont mis à jour. Comme vous pouvez le constater, chaque statut d’audience dans Salesforce CRM a été mis à jour avec le statut d’audience correspondant d’Experience Platform, en fonction de la valeur Mapping ID fournie lors de la planification des audiences.
Utilisation des prospects
- Si vous avez sélectionné Prospects dans votre segment Experience Platform, accédez à la page Apps > Leads.
- Sélectionnez un prospect et vérifiez si les champs sont mis à jour. Comme vous pouvez le constater, chaque statut d’audience dans Salesforce CRM a été mis à jour avec le statut d’audience correspondant d’Experience Platform, en fonction de la valeur Mapping ID fournie lors de la planification des audiences.

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.

Erreurs et résolution des problèmes errors-and-troubleshooting

Erreurs inconnues rencontrées lors de la publication d’événements vers la destination unknown-errors

Lors de la vérification d’une exécution de flux de données, vous pouvez rencontrer le message d’erreur suivant : Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- Pour corriger cette erreur, vérifiez que le Mapping ID que vous avez fourni dans le workflow d’activation à la destination Salesforce CRM correspond exactement à la valeur du type de champ personnalisé que vous avez créé dans Salesforce. Reportez-vous à la section Créer des champs personnalisés dans Salesforce pour obtenir des conseils.
Lors de l’activation d’un segment, vous pouvez obtenir un message d’erreur : The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- Pour corriger cette erreur, contactez l’administrateur de votre compte Salesforce pour ajouter des adresses IP Experience Platform aux plages d’adresses IP approuvées de vos comptes Salesforce. Reportez-vous à la documentation Salesforce Limiter l’accès aux plages d’adresses IP de confiance pour une application connectée si vous avez besoin de conseils supplémentaires.

Ressources supplémentaires additional-resources

Retrouvez d’autres informations utiles du portail de développement Salesforce ci-dessous :

Démarrage rapide
Créer un enregistrement
Audiences de recommandations personnalisées
Utilisation de ressources composites
Cette destination utilise l’API Upsert Multiple Records au lieu de l’appel API Upsert Single Record.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6