Connexion (API) Salesforce Marketing Cloud
Présentation overview
(API) Salesforce Marketing Cloud (anciennement appelée ExactTarget) est une suite marketing numérique qui vous permet de créer et de personnaliser des parcours pour que les visiteurs et les clients puissent personnaliser leur expérience.
Par rapport à Salesforce Marketing Cloud Account Engagement qui est plus orienté vers le marketing B2B, la destination (API) Salesforce Marketing Cloud est idéale pour les cas d’utilisation B2C avec des cycles de prise de décision transactionnelle plus courts. Vous pouvez consolider des jeux de données plus volumineux représentant le comportement de votre audience cible afin d’ajuster et d’améliorer les campagnes marketing en hiérarchisant et en segmentant les contacts, en particulier à partir de jeux de données en dehors de l’Salesforce. Notez qu’Experience Platform dispose également d’une connexion pour le Salesforce Marketing Cloud Account Engagement.
Cette Adobe Experience Platform destination utilise l’API Salesforce Marketing Cloud mettre à jour les contacts, qui vous permet d’ajouter des contacts et mettre à jour les données de contact pour les besoins de votre entreprise après les avoir activés dans un nouveau segment de Salesforce Marketing Cloud.
Salesforce Marketing Cloud utilise OAuth 2 avec les informations d’identification du client comme mécanisme d’authentification pour communiquer avec l’API Salesforce Marketing Cloud. Les instructions vous permettant de vous authentifier sur votre instance Salesforce Marketing Cloud sont plus loin dans la section Authentifier à la destination.
Cas d’utilisation use-cases
Pour mieux comprendre quand et comment utiliser la destination (API) Salesforce Marketing Cloud, 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.
Envoyer des e-mails aux contacts pour les campagnes marketing use-case-send-emails
Le service commercial d’une plateforme de location d’habitations souhaite diffuser un e-mail marketing à un public ciblé. L’équipe marketing de la plateforme peut ajouter de nouveaux contacts ou mettre à jour les contacts existants (et leurs adresses e-mail) via Adobe Experience Platform, créer des audiences à partir de leurs propres données hors ligne et envoyer ces audiences à Salesforce Marketing Cloud, qui peut ensuite être utilisée pour envoyer l’e-mail de campagne marketing.
Conditions préalables prerequisites
Conditions préalables dans Experience Platform prerequisites-in-experience-platform
Avant d’activer des données dans la destination (API) Salesforce Marketing Cloud, vous devez avoir un schéma, un jeu de données, ainsi que des segments créés dans Experience Platform.
Conditions préalables dans (API) Salesforce Marketing Cloud prerequisites-destination
Notez les conditions préalables suivantes pour exporter des données d’Experience Platform vers votre compte Salesforce Marketing Cloud :
Vous devez avoir un compte Salesforce Marketing Cloud. prerequisites-account
Un compte Salesforce Marketing Cloud avec un abonnement au produit Marketing Cloud Engagement est obligatoire pour continuer.
Contactez l’Salesforce assistance technique si vous ne disposez pas d’un compte Salesforce Marketing Cloud ou si votre compte ne dispose pas de l’abonnement au produit Marketing Cloud Engagement.
Création d’attributs dans Salesforce Marketing Cloud prerequisites-attribute
Lors de l’activation des audiences vers la destination (API) Salesforce Marketing Cloud, vous devez saisir une valeur dans le champ Identifiant de mappage pour chaque audience activée, à l’étape Planning des audiences.
Salesforce 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 Marketing Cloud. 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, vous devez disposer d’un attribut de type Text lié à l’extension de données Email Demographics dans Salesforce Marketing Cloud. Utilisez le Contact Builder Salesforce Marketing Cloud pour créer des attributs. Reportez-vous à la documentation Salesforce Marketing Cloud pour créer des attributs si vous avez besoin de conseils sur la création d’attributs.
Les noms des champs d’attribut sont utilisés pour le champ cible (API) Salesforce Marketing Cloud lors de l’étape Mappage. Vous pouvez définir le caractère du champ avec un maximum de 4 000 caractères, en fonction des besoins de votre entreprise. Consultez la page de documentation Salesforce Marketing Cloud Types de données des extensions de données pour plus d’informations sur les types d’attributs.
Voici un exemple d’écran du concepteur de données dans Salesforce Marketing Cloud, auquel vous allez ajouter l’attribut :
Une vue d’un groupe d’attributs Salesforce Marketing Cloud Email Data avec des attributs correspondant au statut de l’audience dans l’extension de données Email Demographics est affichée ci-dessous :
La destination (API) Salesforce Marketing Cloud utilise la Salesforce Marketing Cloud Search Attribute-Set Definitions REST API pour récupérer dynamiquement les extensions de données et leurs attributs liés' définis dans Salesforce Marketing Cloud.
Elles s’affichent dans la fenêtre de sélection Champ cible lorsque vous configurez le mapping du workflow pour activer les audiences vers la destination.
salesforce_mc_segment_1. Lors de l’activation d’une audience vers cette destination, ajoutez des salesforce_mc_segment_1 en tant qu’ID de mappage pour renseigner les audiences d’Experience Platform dans cet attribut.Un exemple de création d’attributs dans Salesforce Marketing Cloud est illustré ci-dessous :
- Lors de la création de l’attribut, n’incluez pas de caractères blancs dans le nom du champ. Utilisez plutôt le caractère de soulignement
(_)comme séparateur. - Pour faire la distinction entre les attributs utilisés pour les audiences Experience Platform et les autres attributs dans Salesforce Marketing Cloud, vous pouvez inclure un préfixe ou un suffixe reconnaissable pour les attributs utilisés pour les segments Adobe. Par exemple, au lieu de
test_segment, utilisezAdobe_test_segmentoutest_segment_Adobe. - Si d’autres attributs ont déjà été créés dans Salesforce Marketing Cloud, vous pouvez utiliser le même nom que le segment Experience Platform pour identifier facilement l’audience dans Salesforce Marketing Cloud.
Attribuer des rôles utilisateur et des autorisations dans Salesforce Marketing Cloud prerequisites-roles-permissions
Comme Salesforce Marketing Cloud prend en charge des rôles personnalisés en fonction de votre cas d’utilisation, les rôles appropriés doivent être attribués à votre utilisateur pour mettre à jour vos attributs dans Salesforce Marketing Cloud. Voici un exemple de rôles affectés à un utilisateur :
En fonction des rôles qui ont été attribués à votre utilisateur Salesforce Marketing Cloud, vous devez également attribuer des autorisations à l’extension de données Salesforce Marketing Cloud qui sont liées aux champs que vous souhaitez mettre à jour.
Comme cette destination nécessite l’accès aux data extension, vous devez les autoriser. Par exemple, pour les data extension de Email que vous devez autoriser, comme illustré ci-dessous :
Pour restreindre le niveau d’accès, vous pouvez également remplacer l’accès individuel à l’aide de privilèges granulaires.
Reportez-vous aux pages Marketing Cloud Roles et Marketing Cloud Roles and Permissions pour obtenir des conseils détaillés.
Collectez les informations d’identification de Salesforce Marketing Cloud. gather-credentials
Notez les éléments ci-dessous avant de vous authentifier à la destination (API) Salesforce Marketing Cloud.
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,vous devez fournir
mcq4jrssqdlyc4lph19nnqgzzs84 comme valeur.Mécanismes de sécurisation guardrails
-
Salesforce impose certaines limites de taux.
- Reportez-vous à la Salesforce Marketing Cloud documentation pour prendre en compte les limites probables que vous pouvez rencontrer et réduire les erreurs lors de l’exécution.
- Reportez-vous à la page Salesforce Marketing Cloud Tarification de l’engagement pour Télécharger le graphique comparatif de l’édition complète au format PDF, qui détaille les limites imposées par votre plan.
- La page Aperçu de l’API détaille les limites supplémentaires.
- Reportez-vous ici pour une page qui regroupe ces détails.
-
Le nombre de champs personnalisés autorisés par objet varie en fonction de votre édition Salesforce.
-
Reportez-vous à la Salesforce documentation pour plus d’informations.
-
Si vous avez atteint la limite définie pour champs personnalisés autorisés par objet dans Salesforce Marketing Cloud, vous devrez :
- Supprimez les anciens attributs avant d’ajouter de nouveaux attributs dans Salesforce Marketing Cloud.
- Mettez à jour ou supprimez toutes les audiences activées dans les destinations Experience Platform qui utilisent ces anciens noms d’attribut comme valeur fournie pour ID de mappage lors de l’étape planification des audiences.
-
Identités prises en charge supported-identities
(API) Salesforce Marketing Cloud prend en charge l’activation des identités décrites dans le tableau ci-dessous. En savoir plus sur les identités.
Audiences prises en charge supported-audiences
Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination.
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.
- 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 du segment dans Salesforce Marketing Cloud est mis à jour avec le statut de l’audience correspondant d’Experience Platform, en fonction de la valeur Identifiant de mappage fournie lors de l’étape planification de l’audience.
Se connecter à la destination connect
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 (API) Salesforce Marketing Cloud. Vous pouvez également localiser cet élément dans la catégorie Marketing par e-mail.
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 Se connecter à la destination. Reportez-vous à la section Collecter Salesforce Marketing Cloud informations d’identification pour obtenir des conseils.
Par exemple, si votre domaine est
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,vous devez fournir
mcq4jrssqdlyc4lph19nnqgzzs84 comme valeur.Client ID Salesforce Marketing Cloud.Client Secret Salesforce Marketing Cloud.
Si les détails fournis sont valides, l’interface utilisateur affiche un statut Connecté avec une coche verte, vous pouvez alors 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.
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
- 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.
- Pour exporter des identités, vous devez disposer de l’autorisation de contrôle d’accès 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 (API) Salesforce Marketing Cloud, 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 aux champs de destination (API) Salesforce Marketing Cloud, procédez comme suit.
-
Bien que les noms d’attributs correspondent à votre compte Salesforce Marketing Cloud, les mappages pour
contactKeyetpersonalEmail.addresssont obligatoires. -
L’intégration à l’API Salesforce Marketing Cloud est soumise à une limite de pagination du nombre d’attributs qu’Experience Platform peut récupérer de Salesforce. Cela signifie que pendant l’étape Mappage, le schéma des champs cibles peut afficher un maximum de 2 000 attributs de votre compte Salesforce.
-
Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affichera à 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 choisissez l’espace de noms d’identité Sélectionner et sélectionnez une identité.
-
Dans la fenêtre Sélectionner le champ cible, choisissez la catégorie Sélectionner l’espace de noms d’identité et sélectionnez une identité ou choisissez Sélectionner des attributs et sélectionnez un attribut parmi les extensions de données affichées, le cas échéant. La destination (API) Salesforce Marketing Cloud utilise la Salesforce Marketing Cloud Search Attribute-Set Definitions REST API pour récupérer dynamiquement les extensions de données et leurs attributs liés' définis dans Salesforce Marketing Cloud. Elles s’affichent dans la fenêtre contextuelle Champ cible lorsque vous configurez le mapping dans le workflow Activer les audiences.
-
Répétez ces étapes pour ajouter les mappages suivants entre votre schéma de profil XDM et (API) Salesforce Marketing Cloud :
table 0-row-3 1-row-3 2-row-3 3-row-3 Champ source Champ cible Obligatoire IdentityMap: contactKeyIdentity: salesforceContactKeyMandatoryxdm: personalEmail.addressAttribute: Email Addressde l’extension de données Salesforce Marketing Cloud Email Addresses.Mandatory, lors de l’ajout de nouveaux contacts.xdm: person.name.firstNameAttribute: First Namede l’extension de données Salesforce Marketing Cloud souhaitée.- -
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.
Planifier l’exportation de l’audience et exemple schedule-segment-export-example
Lors de l’exécution de l’étape Planifier l’exportation d’audience , vous devez mapper manuellement les audiences Experience Platform aux attributs dans Salesforce Marketing Cloud.
Pour ce faire, sélectionnez chaque segment, puis saisissez le nom de l’attribut à partir de Salesforce Marketing Cloud dans le champ (API) Salesforce Marketing Cloud ID de mappage. Reportez-vous à la section Créer un attribut dans Salesforce Marketing Cloud pour obtenir des conseils et connaître les bonnes pratiques sur la création d’attributs dans Salesforce Marketing Cloud.
Par exemple, si votre attribut Salesforce Marketing Cloud est salesforce_mc_segment_1, spécifiez cette valeur dans l’(API) Salesforce Marketing Cloud ID de mappage pour renseigner les audiences d’Experience Platform dans cet attribut.
Un exemple d’attribut de Salesforce Marketing Cloud est illustré ci-dessous :
Un exemple indiquant l’emplacement de l’(API) Salesforce Marketing Cloud identifiant de mappage est illustré ci-dessous :
Comme indiqué, la (API) Salesforce Marketing Cloud Identifiant de mappage doit correspondre exactement à la valeur spécifiée dans Salesforce Marketing Cloud NOM DU CHAMP.
Répétez cette section pour chaque segment Experience Platform activé.
Un exemple type basé sur l’image affichée ci-dessus pourrait être .
salesforce_mc_segment_1salesforce_mc_segment_1salesforce_mc_segment_2salesforce_mc_segment_2Valider 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 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.
-
Connectez-vous au site Web Salesforce Marketing Cloud. Accédez ensuite à la page Audience Builder > Contact Builder > All contacts > Email et vérifiez si les profils de l’audience ont été ajoutés.
-
Pour vérifier si des profils ont été mis à jour, accédez à la page E-mail et vérifiez si les valeurs d’attribut du profil de l’audience ont été mises à jour. En cas de réussite, vous pouvez constater que chaque statut d’audience dans Salesforce Marketing Cloud a été mis à jour avec le statut d’audience correspondant d’Experience Platform, en fonction de la valeur Identifiant de mappage fournie à l’étape planification 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.
Erreurs et résolution des problèmes errors-and-troubleshooting
Erreurs inconnues rencontrées lors de la publication d’événements dans Salesforce Marketing Cloud 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’identifiant de mappage que vous avez fourni dans le workflow d’activation vers la destination (API) Salesforce Marketing Cloud correspond exactement au nom de l’attribut que vous avez créé dans Salesforce Marketing Cloud. Reportez-vous à la section Créer un attribut dans Salesforce Marketing Cloud 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 Marketing Cloud pour ajouter des adresses IP Experience Platform aux plages d’adresses IP approuvées de vos comptes Salesforce Marketing Cloud. Reportez-vous à la documentation Salesforce Marketing Cloud Adresses IP à inclure sur les Places sur la liste autorisée dans Marketing Cloud si vous avez besoin de conseils supplémentaires.
Ressources supplémentaires additional-resources
- Salesforce Marketing Cloud API
- Salesforce Marketing Cloud documentation expliquant comment les contacts sont mis à jour avec les informations spécifiées.
Journal des modifications changelog
Cette section répertorie les nouvelles fonctionnalités et les mises à jour importantes de la documentation consacrée au connecteur de destination.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto | ||
|---|---|---|
| Mois de publication | Type de mise à jour | Description |
| Octobre 2023 | Mise à jour de la documentation |
|
| Avril 2023 | Mise à jour de la documentation |
|
| Février 2023 | Mise à jour de la documentation | Nous avons mis à jour la section Conditions préalables dans le Marketing Cloud Salesforce (API) afin d’inclure un lien de référence indiquant qu’Salesforce Marketing Cloud Engagement est un abonnement obligatoire pour utiliser cette destination. |
| Février 2023 | Mise à jour des fonctionnalités | Nous avons corrigé un problème en raison duquel une configuration incorrecte dans la destination provoquait l’envoi d’un fichier JSON incorrect à Salesforce. Certains utilisateurs et utilisatrices ont ainsi constaté un grand nombre d’échecs d’identités lors de l’activation. (PLATIR-26299) |
| Janvier 2023 | Mise à jour de la documentation |
|
| Octobre 2022 | Version initiale | Publication de la destination initiale et de la documentation. |