Connexion Salesforce CRM

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 :

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

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

When activation des segments, vous pouvez choisir entre des pistes ou des 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 disposer d’un schema, un dataset, et segments créé 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 au Salesforce essai pour enregistrer et créer une Salesforce , si vous n’en avez pas déjà un.

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

Tout d’abord, vous devez configurer une Salesforce application connectée dans votre Salesforce , si vous n’en avez pas déjà un. Salesforce CRM exploite l’application connectée à laquelle se connecter Salesforce.

Ensuite, activez OAuth Settings for API Integration pour le Salesforce connected app. Voir Salesforce documentation à titre indicatif.

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

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

Enfin, assurez-vous que la variable password la subvention est activée dans votre Salesforce compte . Voir Salesforce Flux OAuth 2.0 Username-Password pour des scénarios spécifiques si vous avez besoin d’instructions.

IMPORTANT
Si votre Salesforce l’administrateur de compte a un accès limité aux plages d’adresses IP de confiance. Vous devez les contacter pour obtenir IP EXPERIENCE PLATFORM placé sur la liste autorisée. Voir Salesforce Limitation de 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 dans la variable Salesforce CRM destination, vous devez saisir une valeur dans la variable ID de mappage pour chaque audience activée, dans la variable Planification de l’audience étape .

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 pour Groupe de champs Détails de l’appartenance à une audience si vous avez besoin de conseils sur les états d’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. Voir Salesforce Types de champ personnalisés page de documentation pour plus d’informations sur les types de champ personnalisés. Consultez également la section Salesforce documentation à 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 trait de soulignement. (_) comme séparateur.
Within Salesforce vous devez créer des champs personnalisés avec un Nom du champ qui correspond exactement à la valeur spécifiée dans ID de mappage pour chaque segment Platform activé. Par exemple, la capture d’écran ci-dessous illustre un champ personnalisé nommé crm_2_seg. Lorsque vous activez une audience sur cette destination, ajoutez crm_2_seg as ID de mappage pour renseigner les audiences d’audience d’Experience Platform dans ce champ personnalisé.

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

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 affichant la création de champ personnalisé, Étape 2 - Saisissez les détails du champ personnalisé.

TIP
  • Pour distinguer les champs personnalisés utilisés pour les audiences Platform des 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 une nouvelle ID de mappage peut être utilisé.

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

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

Informations d’identification
Description
Exemple
Username
Votre Salesforce nom d’utilisateur du compte.
Password
Votre Salesforce mot de passe du compte.
Security Token
Votre Salesforce jeton de sécurité que vous ajouterez ultérieurement à la fin de votre Salesforce Mot de passe pour créer une chaîne concaténée à utiliser comme Password when authentification à la destination.
Voir Salesforce documentation à réinitialiser votre jeton de sécurité pour apprendre à le régénérer à partir de la Salesforce si vous ne disposez pas du jeton de sécurité.
Custom Domain
Votre Salesforce préfixe de domaine.
Voir Salesforce documentation pour savoir comment obtenir cette valeur de la fonction Salesforce .
Si votre Salesforce domain est
d5i000000isb4eak-dev-ed.my.salesforce.com,
vous aurez besoin de d5i000000isb4eak-dev-ed comme valeur.
Client ID
Votre Salesforce Consumer Key.
Voir Salesforce documentation pour savoir comment obtenir cette valeur de la fonction Salesforce .
Client Secret
Votre Salesforce Consumer Secret.
Voir Salesforce documentation pour savoir comment obtenir cette valeur de la fonction 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. Voir Limites de requête d’API et affectations pour plus d’informations.

Si votre Salesforce l’administrateur de compte a appliqué des restrictions d’adresse IP. Vous devrez ajouter Adresses IP Experience Platform à votre Salesforce plages d’adresses IP de confiance des comptes. Voir Salesforce Limitation de l’accès aux plages d’adresses IP approuvées pour une application connectée si vous avez besoin de conseils supplémentaires.

IMPORTANT
When activation des segments vous devez choisir entre Contact ou prospect types. 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
La variable Salesforce CRM identifiant 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 dans Salesforce CRM est mis à jour avec l’état d’audience correspondant de Platform, en fonction de la variable ID de mappage valeur fournie pendant la planification des audiences étape .
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 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 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, renseignez les champs obligatoires ci-dessous et sélectionnez Se connecter à la destination. Voir Collecte Salesforce CRM informations pour obtenir des conseils.
| Credential | Description | | — | — | | Nom d’utilisateur | Votre Salesforce nom d’utilisateur du compte. | | Password | Chaîne concaténée composée de votre Salesforce mot de passe du compte ajouté à votre Salesforce Jeton de sécurité.
La valeur concaténée prend la forme {PASSWORD}{TOKEN}.
Notez que n’utilisez pas d’accolades ni d’espaces.
Par exemple, si la variable Salesforce Le mot de passe est MyPa$$w0rd123 et Salesforce Le jeton de sécurité est TOKEN12345....0000, la valeur concaténée que vous utiliserez dans la variable Password est MyPa$$w0rd123TOKEN12345....0000. | | Domaine personnalisé | Votre Salesforce préfixe de domaine.
Par exemple, si votre domaine est d5i000000isb4eak-dev-ed.my.salesforce.com, vous devez fournir d5i000000isb4eak-dev-ed comme valeur. | | ID 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 une 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.

  • 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électionner Contact si les identités que vous souhaitez exporter ou mettre à jour sont de type Contact.
    • Sélectionner prospect si les identités que vous souhaitez exporter ou mettre à jour sont de type prospect.

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

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.

Attributs spécifiés dans la variable Champ cible doit être nommé exactement comme décrit dans le tableau mappings d’attributs , car ces attributs forment le corps de la requête.

Attributs spécifiés dans la variable Champ source ne suivez 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 en fonction de la variable Salesforce documentation. Si les données d’entrée ne sont pas valides, l’appel de mise à jour vers 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 :

  1. Dans le Mappage étape, sélectionnez Ajouter un nouveau mappage, une nouvelle ligne de mappage s’affiche à l’écran.
    Capture d’écran de l’interface utilisateur de Platform montrant l’ajout d’un nouveau mappage.

  2. Dans le Sélectionner le champ source , choisissez la Sélectionner des attributs et sélectionnez l’attribut XDM ou choisissez l’option Sélectionner un espace de noms d’identité et sélectionnez une identité.

  3. Dans le Sélectionner le champ cible , choisissez la Sélectionner un espace de noms d’identité et sélectionnez une identité ou choisissez Sélectionner des attributs personnalisés et sélectionnez un attribut ou définissez-en un à l’aide de la fonction Nom de l’attribut selon les besoins. Voir Salesforce CRM documentation pour plus d’informations 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 de contacts

    • Si vous utilisez des Contacts dans votre segment, reportez-vous à la référence d’objet dans Salesforce pour Contact pour définir les mappages des champs à mettre à jour.

    • Vous pouvez identifier les champs obligatoires en recherchant le mot Obligatoire, qui est 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: |Champ source|Champ cible| Remarques | | — | — | — | |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 :

      Capture d’écran de l’interface utilisateur de Platform montrant les mappings de ciblage.

    Utilisation de pistes

    • Si vous utilisez des Pistes dans votre segment, reportez-vous à la référence d’objet dans Salesforce pour prospect pour définir les mappages des champs à mettre à jour.

    • Vous pouvez identifier les champs obligatoires en recherchant le mot Obligatoire, qui est 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: |Champ source|Champ cible| Remarques | | — | — | — | |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 :

      Capture d’écran de l’interface utilisateur de Platform montrant les mappings de ciblage.

Une fois les mappages fournis pour la connexion à la destination, sélectionnez Suivant.

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

Lors de l’exécution du Planification de l’exportation des audiences étape vous devez mapper manuellement les audiences activées à partir de Platform à leur champ personnalisé correspondant dans Salesforce.

Pour ce faire, sélectionnez chaque segment, puis saisissez le nom du champ personnalisé de Salesforce dans le Salesforce CRM ID de mappage champ . Voir Créer des champs personnalisés dans Salesforce pour obtenir des conseils sur la création de champs personnalisés dans Salesforce.

Par exemple, si la variable Salesforce champ personnalisé crm_2_seg, indiquez cette valeur dans la variable Salesforce CRM ID de mappage pour renseigner les audiences d’audience d’Experience Platform dans ce champ personnalisé.

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

Un exemple indiquant l’emplacement de la variable 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 d’audience.

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

Selon le cas d’utilisation, toutes les audiences activées peuvent être mappées sur le même Salesforce champ personnalisé ou différent Nom du champ in 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_1_seg | | crm_2_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 :

  1. Sélectionnez Destinations > Parcourir pour accéder à la liste des destinations.
    Capture d’écran de l’interface utilisateur de Platform montrant la navigation des destinations.

  2. Sélectionnez la destination et vérifiez que le statut est activé.
    Capture d’écran de l’interface utilisateur de Platform montrant l’exécution du flux de données des destinations.

  3. Basculez vers le Données d’activation , puis sélectionnez un nom d’audience.
    Exemple de capture d’écran de l’interface utilisateur de Platform montrant les données d’activation des destinations.

  4. Surveillez la synthèse de l’audience et assurez-vous que le nombre de profils correspond au nombre créé dans le segment.
    Exemple de capture d’écran de l’interface utilisateur de Platform montrant le segment.

  5. Enfin, connectez-vous au site web Salesforce et vérifiez si les profils de l’audience ont été ajoutés ou mis à jour.

    Utilisation de contacts

    • Si vous avez sélectionné Contacts dans votre segment Platform, accédez au Apps > Contacts page.

      Capture d’écran Salesforce CRM affichant la page Contacts avec les profils du segment.

    • Sélectionnez une Contact et vérifiez si les champs sont mis à jour. Vous pouvez voir que chaque état d’audience dans Salesforce CRM a été mis à jour avec l’état d’audience correspondant de Platform, en fonction de la variable ID de mappage valeur fournie pendant la planification des audiences.

      Capture d’écran Salesforce CRM affichant la page Détails du contact avec les statuts d’audience mis à jour.

    Utilisation de pistes

    • Si vous avez sélectionné Pistes dans votre segment Platform, puis accédez au Apps > Leads page.

      Capture d’écran Salesforce CRM affichant la page Pistes avec les profils du segment.

    • Sélectionnez une prospect et vérifiez si les champs sont mis à jour. Vous pouvez voir que chaque état d’audience dans Salesforce CRM a été mis à jour avec l’état d’audience correspondant de Platform, en fonction de la variable ID de mappage valeur fournie pendant la planification des audiences.

      Capture d’écran Salesforce CRM affichant la page Détails du prospect avec les statuts d’audience mis à jour.

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.
    Copie d’écran de l’interface utilisateur de Platform affichant l’erreur.

    • Pour corriger cette erreur, vérifiez que la variable ID de mappage que vous avez fourni dans le workflow d’activation au Salesforce CRM destination correspond exactement à la valeur du type de champ personnalisé que vous avez créé dans Salesforce. Voir Créer des champs personnalisés dans Salesforce pour plus d’informations.
  • Lors de l’activation d’un segment, un message d’erreur peut s’afficher : The client's IP address is unauthorized for this account. Allowlist the client's IP address...

Ressources supplémentaires additional-resources

Informations utiles supplémentaires de la section Portail de développement Salesforce est ci-dessous :

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6