Connexion (API) Salesforce Marketing Cloud

Présentation

Salesforce Marketing Cloud (anciennement connu sous le nom de 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.

Ceci Adobe Experience Platform destination tire parti de Salesforce Marketing Cloud mettre à jour les contacts API qui vous permet d’ajouter des contacts/de mettre à jour les données de contact pour vos besoins professionnels 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. Instructions pour vous authentifier à votre Salesforce Marketing Cloud sont plus loin, dans la section Authentification à la destination .

Cas d'utilisation

Pour vous aider à mieux comprendre comment et à quel moment utiliser la variable Salesforce Marketing Cloud destination, voici un exemple de cas d’utilisation que les clients Adobe Experience Platform peuvent résoudre en utilisant cette destination.

Envoyer des emails aux contacts pour les campagnes marketing

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 segments à partir de leurs propres données hors ligne et envoyez ces segments à Salesforce Marketing Cloud, qui peut ensuite être utilisé pour envoyer l’email de la campagne marketing.

Conditions préalables

Conditions préalables dans Experience Platform

Avant d’activer des données dans la variable Salesforce Marketing Cloud destination, vous devez avoir une schema, un dataset, et segments créé dans Experience Platform.

Conditions préalables dans Salesforce Marketing Cloud

Notez les conditions préalables suivantes pour exporter des données de Platform vers votre Salesforce Marketing Cloud compte :

Vous devez avoir une Salesforce Marketing Cloud account

Contactez votre Salesforce Account Executive pour vous abonner au Salesforce Marketing Cloud Account Engagement produit si vous ne l’avez pas déjà.

Créer un champ personnalisé dans Salesforce Marketing Cloud

Vous devez créer un attribut personnalisé de type Text Area Long, que l’Experience Platform utilisera pour mettre à jour l’état du segment dans Salesforce Marketing Cloud. Dans le workflow d’ activation des segments vers la destination, dans la variable Planification du segment , vous utiliserez l’attribut personnalisé comme ID de mappage pour chaque segment que vous activez.

Reportez-vous à la section Salesforce Marketing Cloud documentation à créer des champs personnalisés si vous avez besoin de conseils supplémentaires.

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 Marketing Cloud destination.

Limites dans Salesforce Marketing Cloud

• Salesforce impose certains limites de taux.
  • Reportez-vous à la section 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.
  • Reportez-vous à la section 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.
  • Le 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.
  • Reportez-vous à la section 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 champs personnalisés avant d’ajouter de nouveaux champs personnalisés dans Salesforce Marketing Cloud.
    • Mettez à jour ou supprimez toutes les destinations dans Platform qui utilisent ces anciens noms de champ personnalisés comme valeur fournie pour ID de mappage pendant la planification des segments étape .

Identités prises en charge

Salesforce Marketing Cloud prend en charge l’activation des identités décrites dans le tableau ci-dessous. En savoir plus sur identités.

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.

Se connecter à la destination

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.

Authentification à la destination

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

• Subdomain: Votre Salesforce Marketing Cloud préfixe de domaine. Par exemple, si votre domaine est mcq4jrssqdlyc4lph19nnqgzzs84.login.accuracy.target.com, vous avez besoin de la valeur mise en surbrillance.
• ID client: Votre Salesforce Marketing Cloud ID client.
• Secret du client: Votre Salesforce Marketing Cloud Secret du client.

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.

• Nom: Un nom par lequel vous reconnaîtrez cette destination à l’avenir.
• Description: Description qui vous aidera à identifier cette destination ultérieurement.

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

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 Marketing Cloud 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 Marketing Cloud pour les 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.
   

2. Dans le Sélectionner le champ source , choisissez la Sélectionner des attributs catégorie et sélectionnez contactKey.
   

3. Dans le Sélectionner le champ cible sélectionnez le type de champ cible vers lequel vous souhaitez mapper votre champ source.

   • Sélectionner un espace de noms d’identité: sélectionnez cette option pour mapper votre champ source à un espace de noms d’identité de la liste.

     

   • Ajoutez le mappage suivant entre votre schéma de profil XDM et votre Salesforce Marketing Cloud instance : |Schéma de profil XDM|Salesforce Marketing Cloud Instance| Obligatoire| |—|—|—| |contactKey|salesforceContactKey| Oui |

   • Sélectionner des attributs personnalisés: sélectionnez cette option pour mapper votre champ source à un attribut personnalisé que vous définissez dans la variable Nom de l’attribut champ . Voir Salesforce Marketing Cloud documentation pour obtenir une liste des attributs pris en charge. Notez également que la destination utilise la variable API REST des définitions d’ensemble d’attributs de recherche Salesforce pour récupérer les attributs définis dans Salesforce pour vos contacts et spécifiques à votre compte.

     

   • Par exemple, en fonction des valeurs que vous souhaitez mettre à jour, ajoutez le mappage suivant entre votre schéma de profil XDM et votre Salesforce Marketing Cloud instance : |Schéma de profil XDM|Salesforce Marketing Cloud Instance| |—|—| |person.name.firstName|Email Demographics.First Name| |personalEmail.address|Email Addresses.Email Address|

   • Un exemple d’utilisation de ces mappages est illustré ci-dessous :

     

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 à la variable attribut personnalisé dans Salesforce.

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

Voici un exemple :

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.
   

2. Sélectionnez la destination et vérifiez que l’état est enabled.
   

3. Basculez vers le Activation data , puis sélectionnez un nom de segment.
   

4. Surveillez le résumé du segment et assurez-vous que le nombre de profils correspond au nombre créé dans le segment.
   

5. 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 du segment ont été ajoutés.
   

6. Pour vérifier si des profils ont été mis à jour, accédez au Email et vérifiez si les valeurs d’attribut du profil du segment ont été mises à jour. En cas de réussite, vous pouvez voir que chaque état de segment dans Salesforce Marketing Cloud a été mis à jour avec l’état du segment correspondant de Platform, en fonction de la variable ID de mappage valeur fournie dans la variable planification des segments étape .
   

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 le Marketing Cloud Salesforce

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 Salesforce Marketing Cloud pour votre segment Platform valide et existe dans Salesforce Marketing Cloud.

Ressources supplémentaires

• Salesforce Marketing Cloud API

Ressources Business.Adobe.com