Connexion (API) Salesforce Marketing Cloud
Présentation overview
(API) Salesforce Marketing Cloud (anciennement ExactTarget) est une suite de 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, plus axé sur le marketing B2B, la destination (API) Salesforce Marketing Cloud est idéale pour les cas d’utilisation B2C avec des cycles de décision transactionnels plus courts. Vous pouvez consolider des jeux de données plus volumineux représentant le comportement de votre audience cible pour ajuster et améliorer les campagnes marketing en hiérarchisant et en segmentant les contacts, en particulier à partir de jeux de données en dehors de Salesforce. Remarque : l’Experience Platform a également une connexion pour 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 de mettre à jour les données de contact pour vos besoins professionnels après les avoir activés dans un nouveau segment 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 emails aux contacts pour les campagnes marketing use-case-send-emails
Le service des ventes d’une plateforme de location de maisons souhaite diffuser un email marketing à un public client ciblé. L’équipe marketing de la plateforme peut ajouter de nouveaux contacts/mettre à jour des contacts (et leurs adresses électroniques) via Adobe Experience Platform, créer des audiences à partir de leurs propres données hors ligne et envoyer ces audiences à Salesforce Marketing Cloud, qui peuvent ensuite être utilisées pour envoyer le courrier électronique de la 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 de 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 si vous n’avez pas de compte Salesforce Marketing Cloud ou si l’abonnement au produit Marketing Cloud Engagement manque à votre compte.
Créer des attributs dans Salesforce Marketing Cloud prerequisites-attribute
Lors de l’activation d’audiences vers la destination (API) Salesforce Marketing Cloud, vous devez saisir une valeur dans le champ ID de mappage pour chaque audience activée, à l’étape Planning d’audience .
Salesforce 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 Marketing Cloud. 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, un attribut de type Text
doit être associé à l’extension de données Email Demographics dans Salesforce Marketing Cloud. Utilisez Salesforce Marketing Cloud Contact Builder pour créer des attributs. Reportez-vous à la documentation Salesforce Marketing Cloud de créer des attributs si vous avez besoin d’instructions 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 Mapping . Vous pouvez définir le caractère du champ avec un maximum de 4 000 caractères, en fonction des besoins de votre entreprise. Pour plus d’informations sur les types d’attributs, consultez la documentation Salesforce Marketing Cloud Types de données des extensions de données .
Un exemple de l’écran du concepteur de données dans Salesforce Marketing Cloud, dans lequel vous allez ajouter l’attribut est illustré ci-dessous :
La vue d'un groupe d'attributs Salesforce Marketing Cloud Email Data avec des attributs correspondant à l'état de l'audience dans l'extension de données Email Demographics est présentée ci-dessous :
La destination (API) Salesforce Marketing Cloud utilise l’ 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 dans le workflow pour activer les audiences vers la destination.
salesforce_mc_segment_1
. Lors de l’activation d’une audience vers cette destination, ajoutez salesforce_mc_segment_1
comme ID de mappage pour renseigner les audiences d’audience de l’Experience Platform dans cet attribut.Voici un exemple de création d’attributs dans Salesforce Marketing Cloud :
- Lors de la création de l’attribut, n’incluez pas d’espace 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 Platform et d’autres attributs dans Salesforce Marketing Cloud, vous pouvez inclure un préfixe ou un suffixe reconnaissable pour les attributs utilisés pour les segments d’Adobe. Par exemple, utilisez
Adobe_test_segment
outest_segment_Adobe
au lieu detest_segment
. - Si d’autres attributs sont déjà créés dans Salesforce Marketing Cloud, vous pouvez utiliser le même nom que le segment Platform pour identifier facilement l’audience dans Salesforce Marketing Cloud.
Attribution de rôles utilisateur et d’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. Vous trouverez ci-dessous un exemple de rôles attribués à un utilisateur :
Selon les rôles attribués à votre utilisateur Salesforce Marketing Cloud, vous devez également attribuer des autorisations à l’extension de données Salesforce Marketing Cloud liée aux champs que vous souhaitez mettre à jour.
Comme cette destination nécessite l’accès à data extension
, vous devez les autoriser. Par exemple, pour Email
data extension 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.
Consultez les 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.exacte.target.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 résoudre toutes les limites probables que vous pouvez rencontrer et réduire les erreurs lors de l’exécution.
- Reportez-vous à la page Salesforce Marketing Cloud Prix de l'engagement vers Télécharger le graphique de comparaison de l'édition complète en tant que pdf qui détaille les limites imposées par votre plan.
- La page Présentation de l’API détaille les limites supplémentaires.
- Consultez ici pour une page qui rassemble ces détails.
-
Le nombre de champs personnalisés autorisés par objet varie en fonction de votre édition Salesforce.
-
Pour plus d'informations, reportez-vous à la Salesforce documentation .
-
Si vous avez atteint la limite définie pour les 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 Platform qui utilisent ces anciens noms d’attribut comme valeur fournie pour ID de mappage au cours de l’étape planification d’audience .
-
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 état de segment dans Salesforce Marketing Cloud 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.
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 la localiser sous la catégorie Marketing par e-mail.
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 Marketing Cloud les informations d’identification .
Par exemple, si votre domaine est
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacte.target.com,vous devez fournir
mcq4jrssqdlyc4lph19nnqgzzs84
comme valeur.Client ID
.Client Secret
.
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.
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 , 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 (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 Platform et leurs équivalents de la destination cible.
Pour mapper correctement vos champs XDM aux champs de destination (API) Salesforce Marketing Cloud, procédez comme suit.
-
Bien que vos noms d’attribut soient conformes à votre compte Salesforce Marketing Cloud, les mappages pour
contactKey
etpersonalEmail.address
sont obligatoires. -
L’intégration à l’API Salesforce Marketing Cloud est soumise à une limite de pagination du nombre d’attributs que l’Experience Platform peut récupérer de Salesforce. Cela signifie que lors de l’étape Mapping, le schéma de champ cible peut afficher un maximum de 2 000 attributs à partir 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 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 la catégorie Sélectionner les attributs et sélectionnez un attribut parmi les extensions de données affichées selon vos besoins. La destination (API) Salesforce Marketing Cloud utilise l’ 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 mappage dans le workflow d’activation des 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: contactKey
Identity: salesforceContactKey
Mandatory
xdm: personalEmail.address
Attribute: Email Address
à partir de l’extension de données Salesforce Marketing Cloud Email Addresses.Mandatory
, lors de l’ajout de nouveaux contacts.xdm: person.name.firstName
Attribute: First Name
de 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.
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 Platform aux attributs dans Salesforce Marketing Cloud.
Pour ce faire, sélectionnez chaque segment, puis saisissez le nom de l’attribut 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 en matière de 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 dans cet attribut les audiences d’audience provenant d’un Experience Platform.
Un exemple d’attribut de Salesforce Marketing Cloud est illustré ci-dessous :
Un exemple indiquant l’emplacement de l’ (API) Salesforce Marketing Cloud ID de mappage est illustré ci-dessous :
Comme illustré, l’ (API) Salesforce Marketing Cloud ID de mappage doit correspondre exactement à la valeur spécifiée dans Salesforce Marketing Cloud FIELD NAME.
Répétez cette section pour chaque segment Platform activé.
Un exemple type basé sur l’image illustrée ci-dessus peut être.
salesforce_mc_segment_1
salesforce_mc_segment_1
salesforce_mc_segment_2
salesforce_mc_segment_2
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 Activation data, 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.
-
Connectez-vous au site web Salesforce Marketing Cloud. Ensuite, accédez à 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 Email et vérifiez si les valeurs d’attribut du profil de l’audience ont été mises à jour. En cas de succès, vous pouvez constater que chaque état d’audience de Salesforce Marketing Cloud a été mis à jour avec l’état d’audience correspondant de Platform, en fonction de la valeur ID 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 vers le Marketing Cloud Salesforce 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 (API) Salesforce Marketing Cloud correspond exactement au nom de l’attribut que vous avez créé dans Salesforce Marketing Cloud. Pour plus d’informations, reportez-vous à la section Créer un attribut dans Salesforce Marketing Cloud .
-
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 adresses IP Experience Platform aux plages d’adresses IP de confiance de vos comptes Salesforce Marketing Cloud. Reportez-vous à la documentation Salesforce Marketing Cloud Adresses IP pour l’inclusion sur les Listes autorisées 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 précisant que Salesforce Marketing Cloud Engagement est un abonnement obligatoire pour utiliser cette destination. |
Février 2023 | Mise à jour des fonctionnalités | Correction d’un problème en raison duquel une configuration incorrecte dans la destination provoquait l’envoi d’un JSON incorrect à Salesforce. Cela entraînait l’échec de certains utilisateurs qui voyaient un grand nombre d’identités lors de l’activation. (PLATIR-26299) |
Janvier 2023 | Mise à jour de la documentation |
|
Octobre 2022 | Version initiale | Version initiale de la destination et publication de la documentation. |