Connexion (API) Salesforce Marketing Cloud
Présentation overview
(API) Salesforce Marketing Cloud (anciennement connu sous le nom 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.
Comparé à Salesforce Marketing Cloud Account Engagement qui sont plus orientées vers B2B marketing, la variable (API) Salesforce Marketing Cloud destination est idéale pour B2C cas d’utilisation 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 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 externes. Salesforce. Remarque : Experience Platform dispose également d’une connexion pour la variable Salesforce Marketing Cloud Account Engagement.
Ceci Adobe Experience Platform destination utilise la variable Salesforce Marketing Cloud mettre à jour les contacts API qui vous permet de ajouter des contacts et mettre à jour les données de contact ; pour répondre aux besoins de votre entreprise après les avoir activés dans une nouvelle Salesforce Marketing Cloud segment.
Salesforce Marketing Cloud utilise OAuth 2 avec les informations d’identification du client comme mécanisme d’authentification pour communiquer avec le Salesforce Marketing Cloud API. 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 existants (et leurs adresses électroniques) via Adobe Experience Platform, créez des audiences à partir de leurs propres données hors ligne et envoyez ces audiences à Salesforce Marketing Cloud, qui peut ensuite être utilisé pour envoyer l’email 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 Salesforce Marketing Cloud compte :
Vous devez avoir un compte Salesforce Marketing Cloud. prerequisites-account
A Salesforce Marketing Cloud avec un abonnement au Marketing Cloud Engagement est obligatoire pour continuer.
Contacter pour Salesforce Assistance si vous n’avez pas de Salesforce Marketing Cloud ou votre compte ne contient pas le Marketing Cloud Engagement abonnement au produit.
Création d’attributs dans Salesforce Marketing Cloud prerequisites-attribute
Lors de l’activation d’audiences dans la variable (API) Salesforce Marketing Cloud 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 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 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, vous devez avoir un attribut de type Text
lié à la variable Email Demographics extension de données dans Salesforce Marketing Cloud. Utilisez la variable Salesforce Marketing Cloud Contact Builder pour créer des attributs. Voir Salesforce Marketing Cloud documentation à 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 la variable (API) Salesforce Marketing Cloud champ cible pendant la Mappage étape . Vous pouvez définir le caractère du champ avec un maximum de 4 000 caractères, en fonction des besoins de votre entreprise. Voir Salesforce Marketing Cloud Types de données des extensions de données page de documentation pour plus d’informations sur les types d’attributs.
Exemple de l’écran du concepteur de données dans Salesforce Marketing Cloud, dans lequel vous allez ajouter l’attribut est illustré ci-dessous :
Une vue Salesforce Marketing Cloud Email Data groupe d’attributs avec des attributs correspondant au statut de l’audience dans la variable Email Demographics l’extension de données est illustrée ci-dessous :
La variable (API) Salesforce Marketing Cloud destination utilise la variable 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 Champ cible de la fenêtre de sélection lors de la configuration de mapping dans le workflow de activation des audiences vers la destination.
salesforce_mc_segment_1
. Lorsque vous activez une audience sur cette destination, ajoutez salesforce_mc_segment_1
as ID de mappage pour renseigner les audiences d’audience d’Experience Platform dans cet attribut.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 d’espace dans le nom du champ. Utilisez plutôt le trait de soulignement.
(_)
comme séparateur. - Pour distinguer les attributs utilisés pour les audiences Platform des 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, au lieu de
test_segment
, utilisezAdobe_test_segment
outest_segment_Adobe
. - 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
As Salesforce Marketing Cloud prend en charge les 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 Salesforce Marketing Cloud a été affecté, vous devez également attribuer des autorisations au Salesforce Marketing Cloud extension des données liées aux champs que vous souhaitez mettre à jour.
Comme cette destination nécessite l’accès à la variable data extension
, vous devez les autoriser. Par exemple, pour la variable 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.
Voir 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 variable (API) Salesforce Marketing Cloud destination.
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,vous devez fournir
mcq4jrssqdlyc4lph19nnqgzzs84
comme valeur.Mécanismes de sécurisation guardrails
-
Salesforce impose certains limites de taux.
- Voir Salesforce Marketing Cloud documentation pour résoudre toutes les limites probables que vous pourriez rencontrer et réduire les erreurs lors de l’exécution.
- Voir Salesforce Marketing Cloud Prix de l'engagement page à Téléchargement du graphique de comparaison de l’édition complète en pdf qui détaille les limites imposées par votre plan.
- La variable Présentation des API détails de la page des limites supplémentaires.
- Voir here 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.
-
Voir 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
- Supprimer les anciens attributs avant d’ajouter de nouveaux attributs dans Salesforce Marketing Cloud.
- Mettez à jour ou supprimez toute audience activée dans les destinations Platform qui utilisent ces anciens noms d’attribut comme valeur fournie pour ID de mappage pendant la planification des audiences étape .
-
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 variable ID de mappage valeur fournie pendant la planification des audiences étape .
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.
Within Destinations > Catalogue, recherchez (API) Salesforce Marketing Cloud. Vous pouvez également la localiser sous le Marketing par e-mail catégorie.
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 Marketing Cloud informations pour obtenir des conseils.
Par exemple, si votre domaine est
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,vous devez fournir
mcq4jrssqdlyc4lph19nnqgzzs84
comme valeur.Client ID
.Client Secret
.
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.
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 de l’événement Affichage des destinations, Activation des destinations, Afficher les profils, et Affichage de segments 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 identités, vous avez besoin de la fonction Affichage du graphique des identités autorisation de contrôle d’accè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 à (API) Salesforce Marketing Cloud pour les champs de destination, suivez les étapes ci-dessous.
-
Bien que vos noms d’attribut soient conformes à Salesforce Marketing Cloud , les mappages des deux
contactKey
etpersonalEmail.address
sont obligatoires. -
L’intégration à la variable Salesforce Marketing Cloud L’API est soumise à une limite de pagination du nombre d’attributs qu’un Experience Platform peut récupérer de Salesforce. Cela signifie que pendant la Mappage , 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 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é.
-
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 et sélectionnez un attribut parmi les extensions de données affichées selon vos besoins. La variable (API) Salesforce Marketing Cloud destination utilise la variable 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 Champ cible lorsque vous configurez la variable mapping dans le workflow 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
de la Salesforce Marketing Cloud Email Addresses extension de données.Mandatory
, lors de l’ajout de nouveaux contacts.xdm: person.name.firstName
Attribute: First Name
de la Salesforce Marketing Cloud extension de données.- -
Un exemple d’utilisation de ces mappages est illustré ci-dessous :
-
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 , vous devez mapper manuellement les audiences de Platform à la variable Attributs in Salesforce Marketing Cloud.
Pour ce faire, sélectionnez chaque segment, puis saisissez le nom de l’attribut depuis Salesforce Marketing Cloud dans le (API) Salesforce Marketing Cloud ID de mappage champ . Voir Création d’un attribut dans Salesforce Marketing Cloud pour obtenir des conseils sur la création d’attributs dans Salesforce Marketing Cloud.
Par exemple, si la variable Salesforce Marketing Cloud attribute is salesforce_mc_segment_1
, indiquez cette valeur dans la variable (API) Salesforce Marketing Cloud ID de mappage pour renseigner les audiences d’audience d’Experience Platform dans cet attribut.
Un exemple d’attribut de Salesforce Marketing Cloud est illustré ci-dessous :
Un exemple indiquant l’emplacement de la variable (API) Salesforce Marketing Cloud ID de mappage est illustré ci-dessous :
Comme illustré (API) Salesforce Marketing Cloud ID 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 Platform activé.
Un exemple type basé sur l’image illustrée ci-dessus peut être.
| (API) Salesforce Marketing Cloud nom du segment | Salesforce Marketing Cloud NOM DU CHAMP | (API) Salesforce Marketing Cloud ID de mappage | | — | — | — | | audience mc Salesforce 1 | salesforce_mc_segment_1
| salesforce_mc_segment_1
| | audience mc Salesforce 2 | 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é.
-
Basculez vers le 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 Salesforce Marketing Cloud site web. Accédez ensuite à la 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 au Email et vérifiez si les valeurs d’attribut du profil de l’audience ont été mises à jour. En cas de réussite, vous pouvez voir que chaque état d’audience dans Salesforce Marketing Cloud a été mis à jour avec l’état d’audience correspondant de Platform, en fonction de la variable ID de mappage de la variable planification des audiences étape .
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 la variable ID de mappage que vous avez fourni dans le workflow d’activation au (API) Salesforce Marketing Cloud destination correspond exactement au nom de l’attribut créé dans Salesforce Marketing Cloud. Voir Création d’un attribut dans Salesforce Marketing Cloud 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...
- Pour corriger cette erreur, contactez votre Salesforce Marketing Cloud administrateur de compte à ajouter Adresses IP Experience Platform à votre Salesforce Marketing Cloud plages d’adresses IP de confiance des comptes. Voir Salesforce Marketing Cloud Adresses IP à inclure sur les Listes autorisées en 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 variable Conditions préalables dans le Marketing Cloud Salesforce (API) pour inclure un lien de référence indiquant 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. |