Documentation Experience Platform Guide des destinations

Connexion Salesforce CRM

Last update: Thu Jul 18 2024 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 (CRM) populaire qui prend en charge les types de profils décrits ci-dessous :

Leads - Une prospect est le nom d'une personne ou d'une société qui peut (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 a été qualifié de client potentiel.

Cette Adobe Experience Platform destination exploite 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 pistes 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 à Salesforce CRM, afin de mettre à jour l’appartenance 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 les données vers la destination Salesforce CRM, vous devez avoir un schéma, un jeu de données et des 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 de Platform vers votre compte Salesforce :

Vous devez avoir un compte Salesforce. prerequisites-account

Accédez à la page Salesforce try pour vous enregistrer et créer un compte Salesforce si vous n'en avez pas déjà un.

Configurer 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 ce n'est déjà fait. Salesforce CRM exploitera l’application connectée pour se connecter à Salesforce.

Ensuite, activez OAuth Settings for API Integration pour le Salesforce connected app. Consultez la documentation Salesforce pour obtenir des conseils.

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

chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access

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

IMPORTANT

Si l'administrateur de votre compte Salesforce a restreint l'accès aux plages d'adresses IP de confiance, vous devez les contacter pour que les adresses IP Experience Platform soient placées sur la liste autorisée. Reportez-vous à la documentation Salesforce Limiter l’accès aux plages d’adresses IP approuvées 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 d’audiences vers la destination Salesforce CRM, vous devez saisir une valeur dans le champ ID de mappage pour chaque audience activée, à l’étape Planning d’audience .

Salesforce CRM nécessite cette valeur pour lire et interpréter correctement les audiences provenant d’un Experience Platform et pour mettre à jour leur état d’audience dans Salesforce. Reportez-vous à la documentation Experience Platform du groupe de champs de schéma Détails de l’appartenance à l’audiencesi vous avez besoin de conseils sur les états de l’audience.

Pour chaque audience que vous activez de Platform à 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 d’un champ d’une taille comprise entre 256 et 131 072 caractères en fonction des besoins de votre entreprise. Pour plus d’informations sur les types de champ personnalisés, consultez la page de documentation Salesforce Types de champ personnalisés . Reportez-vous également à la documentation Salesforce pour créer des champs personnalisés si vous avez besoin d’aide sur 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 nom de champ qui correspond exactement à la valeur spécifiée dans ID de mappage pour chaque segment de plateforme 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 comme ID de mappage pour renseigner les audiences d’audience de l’Experience Platform dans ce champ personnalisé.

Voici un exemple de création de champ personnalisé dans Salesforce, Etape 1 - Sélectionner le type de données :
Copie d’écran de l’interface utilisateur 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, Etape 2 - Saisissez les détails du champ personnalisé, est illustré ci-dessous :
Copie d’écran de l’interface utilisateur Salesforce montrant la création de champs personnalisés, Étape 2 - Saisissez les détails du champ personnalisé.

TIP

Pour faire la distinction entre les champs personnalisés utilisés pour les audiences 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 sont déjà créés dans Salesforce, vous pouvez utiliser le même nom que le segment Platform pour identifier facilement l’audience dans Salesforce.

NOTE

Les objets de Salesforce sont limités à 25 champs externes. Voir Attributs de champ personnalisés.
Cette restriction signifie 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 qui ont été utilisés pour stocker l’état de l’audience par rapport aux audiences plus anciennes dans Experience Platform avant de pouvoir utiliser un nouvel ID de mappage.

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

Votre nom d'utilisateur de compte Salesforce.

Password

Votre mot de passe de 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 mot de passe lors de l’ authentification à la destination.
Reportez-vous à la documentation Salesforce pour réinitialiser votre jeton de sécurité afin d’apprendre à 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 Salesforce est
d5i000000isb4eak-dev-ed.my.salesforce.com,
vous aurez besoin de d5i000000isb4eak-dev-ed comme valeur.

Client ID

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

Client Secret

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

Mécanismes de sécurisation guardrails

Salesforce équilibre les charges de transaction en imposant des limites de requête, de débit et de délai d’expiration. Pour plus d’informations, reportez-vous à la section Limites de requête d’API et Allocations .

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

IMPORTANT

Lorsque vous activez 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

L’identifiant Salesforce CRM des identités de contact ou de prospect que vous exportez ou mettez à jour par le biais de 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

Basé sur les profils

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 état d’audience de Salesforce CRM est mis à jour avec l’état d’audience correspondant de Platform, en fonction de la valeur ID de mappage fournie à l’étape planification d’audience.

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 et des 🔗 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 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 à la destination, remplissez les champs requis ci-dessous et sélectionnez Se connecter à la destination. Pour obtenir des conseils, reportez-vous à la section Rassembler Salesforce CRM les informations d’identification .

Informations d’identification

Description

Nom d’utilisateur

Votre nom d'utilisateur de compte Salesforce.

Mot de passe

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

Domaine personnalisé

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.

Identifiant du client

Votre Salesforce application connectée Consumer Key.

Secret du client

Votre Salesforce application connectée Consumer Secret.

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 état Connecté 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.

Nom : un nom par lequel vous reconnaîtrez cette destination à l’avenir.
Description : une description qui vous aidera à identifier cette destination à l’avenir.
Type d’identifiant Salesforce :
- 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 de Platform montrant les détails de 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 Suivant.

Activer des audiences vers cette destination activate

IMPORTANT

Pour activer les données, vous avez besoin des , Activer les destinations, et 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.
Pour exporter des identités, vous avez besoin de l'autorisation Afficher le graphique d'identités 🔗.
{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 Platform et leurs équivalents de la destination cible.

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

Les attributs spécifiés dans le champ Source ne suivent aucune restriction de ce type. Vous pouvez le 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 vers Salesforce échoue et vos contacts/pistes 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 Ajouter un nouveau mappage, une nouvelle ligne de mappage s’affiche à l’écran.
Dans la fenêtre Sélectionner le champ source, choisissez la catégorie Sélectionner les attributs et sélectionnez l’attribut XDM ou l’attribut Sélectionner l’espace de noms d’identité et sélectionnez une identité.

Dans la fenêtre Sélectionner le champ cible , choisissez l’espace de noms Sélectionner l’identité et sélectionnez une identité ou sélectionnez la catégorie Sélectionner des attributs personnalisés et sélectionnez un attribut ou définissez-en un à l’aide du champ Nom de l’attribut 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 travaillez avec Contacts dans votre segment, reportez-vous à la référence d’objet dans Salesforce pour Contact afin de définir les mappages des champs à mettre à jour.
Vous pouvez identifier les champs obligatoires en recherchant le mot Obligatoire mentionné dans la description des champs du 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	Notes
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`. Nom du contact (maximum 80 caractères).
`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 de pistes

Si vous utilisez Leads dans votre segment, reportez-vous à la référence d’objet dans Salesforce pour Lead afin de définir des mappages pour les champs à mettre à jour.
Vous pouvez identifier les champs obligatoires en recherchant le mot Obligatoire mentionné dans la description des champs du 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	Notes
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`. Nom de famille de l’avance (80 caractères maximum).
`xdm: b2b.companyName`	`Attribute: Company`	`Mandatory`. La compagnie du prospect.
`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 Suivant.

Planification de l’export d’audience et exemple schedule-segment-export-example

Lors de l’étape Planification de l’export d’audience , vous devez mapper manuellement les audiences activées à partir de Platform vers le champ personnalisé correspondant dans Salesforce.

Pour ce faire, sélectionnez chaque segment, puis saisissez le nom du champ personnalisé Salesforce dans le champ Salesforce CRM ID de mappage . Reportez-vous à la section Créer des champs personnalisés dans Salesforce pour obtenir des conseils et connaître les bonnes pratiques relatives à 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 l’ Salesforce CRM ID de mappage pour renseigner dans ce champ personnalisé les audiences d’audience provenant d’un Experience Platform.

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

Un exemple indiquant l’emplacement de l’ Salesforce CRM ID de mappage est illustré ci-dessous :
Exemple de capture d’écran de l’interface utilisateur de Platform montrant Planification de l’exportation des audiences.

Comme illustré ci-dessus, Salesforce Nom du champ correspond exactement à la valeur spécifiée dans Salesforce CRM ID de mappage.

Selon votre cas d’utilisation, toutes les audiences activées peuvent être mappées au même champ personnalisé Salesforce ou à un nom du champ différent dans Salesforce CRM. Un exemple type basé sur l’image illustrée ci-dessus peut être.

Salesforce CRM nom du segment

Salesforce Nom du champ

Salesforce CRM ID de mappage

crm_1_seg

crm_1_seg

crm_2_seg

crm_2_seg

Répétez cette section pour chaque segment 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 > Parcourir pour accéder à la liste des destinations.
Sélectionnez la destination et vérifiez que le statut est activé.
Passez à l’onglet Données d’activation , puis sélectionnez un nom d’audience.
Surveillez la synthèse de l’audience et assurez-vous que le nombre de profils correspond au nombre créé dans le segment.
Enfin, connectez-vous au site web Salesforce et vérifiez si les profils de l’audience ont été ajoutés ou mis à jour.

Utilisation des contacts
- Si vous avez sélectionné Contacts dans votre segment Platform, accédez à la page Apps > Contacts .
- Sélectionnez un Contact et vérifiez si les champs sont mis à jour. Vous pouvez constater que chaque état d’audience de Salesforce CRM a été mis à jour avec l’état d’audience correspondant de Platform, en fonction de la valeur ID de mappage fournie pendant la planification d’audience.
Utilisation de pistes
- Si vous avez sélectionné Pistes dans votre segment Platform, accédez à la page Apps > Leads .
- Sélectionnez une piste et vérifiez si les champs sont mis à jour. Vous pouvez constater que chaque état d’audience de Salesforce CRM a été mis à jour avec l’état d’audience correspondant de Platform, en fonction de la valeur ID de mappage fournie pendant la planification d’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.

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 l’ ID de mappage que vous avez fourni dans le workflow d’activation vers la destination Salesforce CRM correspond exactement à la valeur du type de champ personnalisé que vous avez créé dans Salesforce. Pour plus d’informations, reportez-vous à la section Créer des champs personnalisés dans Salesforce .
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 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 approuvées pour une application connectée si vous avez besoin de conseils supplémentaires.

Ressources supplémentaires additional-resources

Vous trouverez ci-dessous des informations utiles supplémentaires sur le portail développeur Salesforce :

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

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6