Connexion Salesforce CRM

Présentation

Salesforce CRM est une plateforme de gestion de la relation client (CRM) populaire qui prend en charge les éléments suivants :

  • 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 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 de segment 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. Instructions pour vous authentifier à votre Salesforce CRM sont plus loin, dans la section Authentification à la destination .

Cas d'utilisation

En tant que marketeur, 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 segments à partir de vos données hors ligne et envoyer ces segments à Salesforce CRM, afin qu’ils s’affichent dans les flux des utilisateurs dès que les segments et les profils sont mis à jour dans Adobe Experience Platform.

Conditions préalables

Conditions préalables dans 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

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

Vous devez disposer d’un compte Salesforce.

Accédez à Salesforce essai pour enregistrer et créer un compte Salesforce, le cas échéant.

Configuration d’une application connectée

Ensuite, vous devez configurer une application connectée dans votre compte Salesforce, le cas échéant.

Dans l’application connectée, assurez-vous que Paramètres OAuth est activée.

Assurez-vous également que la variable portées mentionnés ci-dessous sont sélectionnés.

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

Créer un champ personnalisé dans Salesforce

Créer un champ personnalisé de type Text Area Long, que l’Experience Platform utilisera pour mettre à jour l’état du segment dans Salesforce CRM.
Reportez-vous à la documentation de Salesforce pour créer des champs personnalisés si vous avez besoin de conseils supplémentaires.

IMPORTANT

Assurez-vous qu’il n’y a aucun espace dans le nom du champ. Utilisez plutôt le trait de soulignement. (_) comme séparateur.

REMARQUE
  • Les objets de 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 aux segments Experience Platform principales à tout moment.
  • Si vous avez atteint cette limite dans Salesforce, vous devez supprimer l’attribut personnalisé de Salesforce qui a été utilisé pour stocker l’état du segment par rapport aux segments plus anciens dans Experience Platform avant un nouveau ID de mappage peut être utilisé.

Reportez-vous à la documentation Adobe Experience Platform pour Groupe de champs Détails de l’appartenance à un segment si vous avez besoin d’instructions sur les états de segment.

Collecte des informations d’identification Salesforce

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

Informations d’identification Description Exemple
  • Préfixe de domaine Salesforce
Voir Préfixe de domaine Salesforce pour plus d’informations.
  • Si votre domaine est tel que ci-dessous, vous avez besoin de la valeur mise en surbrillance.
    d5i000000isb4eak-dev-ed.my.salesforce.com
  • Clé client
  • Secret du client
Reportez-vous à la section Documentation de Salesforce si vous avez besoin de conseils supplémentaires.
  • r23kxxxxxxxxxx0z05xxxxxx
  • ipxxxxxxxxxxT4xxxxxxxxxx

Éléments de sécurité

Salesforce équilibre les charges de transaction en imposant des limites de demande, de taux et de délai d’expiration. Reportez-vous à la section Limites de requête d’API et affectations pour plus d’informations.

IMPORTANT

When activation des segments vous devez choisir entre Contact ou prospect types. Vous devez vous assurer que vos segments disposent du mappage de données approprié en fonction du type sélectionné.

Identités prises en charge

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

Identité cible Description Considérations
SalesforceId Le 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'export

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 email, numéro de téléphone, nom), en fonction de votre mappage de champs.
  • Chaque état de segment dans Salesforce CRM est mis à jour avec l’état du segment correspondant de Platform, en fonction de la variable ID de mappage valeur fournie pendant la planification des segments étape .
Fréquence des exports Diffusion en continu
  • Les destinations de diffusion en continu sont "toujours sur" des connexions basées sur l’API. Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des segments, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur destinations de diffusion en continu.

Se connecter à la destination

IMPORTANT

Pour vous connecter à la destination, vous avez besoin de l’événement Gestion des destinations autorisation de contrôle d’accès. Lisez le 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.

Within Destinations > Catalogue rechercher Salesforce CRM. Vous pouvez également la localiser sous le CRM catégorie.

Authentification à la destination

Pour vous authentifier à la destination, renseignez les champs requis et sélectionnez Se connecter à la destination.

Capture d’écran de l’interface utilisateur de Platform montrant comment vous authentifier.

  • Mot de passe: Votre mot de passe du compte Salesforce.
  • Domaine personnalisé: Votre domaine Salesforce.
  • ID client: Votre Clé de consommateur de l’application connectée Salesforce.
  • Secret du client: Votre application connectée Salesforce Consumer Secret.
  • Nom d’utilisateur: Votre nom d’utilisateur de compte Salesforce.

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

Renseignement des détails de 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: Description qui vous aidera à identifier cette destination ultérieurement.
  • 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.

Activer les alertes

Vous pouvez activer les alertes pour recevoir des notifications sur l’état du 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 les abonnement aux alertes de destinations à l’aide de l’interface utilisateur.

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

Activer des segments vers cette destination

IMPORTANT

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

Lecture Activation des profils et des segments vers des destinations d’exportation de segments en continu pour obtenir des instructions sur l’activation des segments d’audience vers cette destination.

Considérations sur le mappage et exemple

Pour envoyer correctement vos données d’audience de Adobe Experience Platform vers le Salesforce CRM 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 à Salesforce CRM champs de destination, procédez comme suit :

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

  2. Dans le Sélectionner le champ source , choisissez la Sélectionner un espace de noms d’identité ou Sélectionner des attributs catégorie et sélectionnez crmID.
    Exemple de capture d’écran de l’interface utilisateur de Platform pour le mappage source.

  3. Dans le Sélectionner le champ cible , choisissez la Sélectionner un espace de noms d’identité catégorie et sélectionnez SalesforceId.
    Copie d’écran de l’interface utilisateur de Platform montrant le mappage de Target pour SalesforceId.

    • Ajoutez le mappage suivant entre votre schéma de profil XDM et votre Salesforce CRM instance :
    Schéma de profil XDM Salesforce CRM Instance Obligatoire
    crmID SalesforceId Oui
    • Sélectionner des attributs personnalisés: sélectionnez cette option pour mapper votre champ source à un attribut personnalisé que vous avez défini dans la variable Nom de l’attribut champ . Reportez-vous à la section Salesforce CRM documentation pour plus d’informations sur les attributs pris en charge.

      Copie d’écran de l’interface utilisateur de Platform montrant le mappage de Target pour le nom de famille.

    • 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 votre Salesforce CRM instance :

    Schéma de profil XDM Salesforce CRM Instance Remarques
    person.name.lastName LastName Required. Nom du contact (maximum 80 caractères).
    person.name.firstName FirstName Prénom du contact (40 caractères maximum).
    personalEmail.address Email Adresse électronique du contact.
    • Un exemple d’utilisation de ces mappages est illustré ci-dessous :

      Exemple de capture d’écran de l’interface utilisateur de Platform montrant les mappages Target.

    • 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 votre Salesforce CRM instance :

    Schéma de profil XDM Salesforce CRM Instance Remarques
    person.name.lastName LastName Required. Nom du contact (maximum 80 caractères).
    b2b.companyName Company Required. La compagnie du prospect.
    personalEmail.address Email Adresse électronique du contact.
    • Un exemple d’utilisation de ces mappages est illustré ci-dessous :

      Exemple de capture d’écran de l’interface utilisateur de Platform montrant les mappages Target.

Planification de l’exportation de segments et exemple

Lors de l’exécution de la variable Planification de l’exportation de segments vous devez mapper manuellement les segments Platform à l’attribut de champ personnalisé dans Salesforce.

Pour ce faire, sélectionnez chaque segment, puis saisissez l’attribut de champ personnalisé correspondant à partir de Salesforce dans la variable ID de mappage champ .

IMPORTANT
  • La valeur utilisée pour la variable ID de mappage doit correspondre exactement au nom de l’attribut de champ personnalisé créé dans Salesforce.
  • Assurez-vous que le nom de l’attribut de champ personnalisé que vous avez créé dans Salesforce n’utilise pas d’espace.

Voici un exemple :
Exemple de capture d’écran de l’interface utilisateur de Platform montrant Planification de l’exportation de segments.

Validation de l’exportation des données

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

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

  2. Sélectionnez la destination et vérifiez que l’état est enabled.
    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 de segment.
    Exemple de capture d’écran de l’interface utilisateur de Platform montrant les données d’activation des destinations.

  4. Surveillez le résumé du segment 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 Segment.

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

    • Si vous aviez 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 de segment dans Salesforce CRM a été mis à jour avec l’état du segment correspondant de Platform, en fonction de la variable ID de mappage valeur fournie pendant la planification des segments.

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

    • Si vous aviez 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 de segment dans Salesforce CRM a été mis à jour avec l’état du segment correspondant de Platform, en fonction de la variable ID de mappage valeur fournie pendant la planification des segments.

      Capture d’écran Salesforce CRM affichant la page Détails de l’piste avec les états de segment mis à jour.

Utilisation et gouvernance des données

Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux stratégies 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, voir Présentation de la gouvernance des données.

Erreurs et résolution des problèmes

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

Lors de la vérification d’une exécution de flux de données, si vous obtenez 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 vous avez fourni dans Salesforce CRM pour votre segment Platform valide et existe dans Salesforce CRM.

Ressources supplémentaires

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

Sur cette page