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.

IMPORTANT

Notez la différence entre cette connexion et l’autre Salesforce Marketing Cloud connection qui se trouve dans la section Catalogue des emails . L’autre connexion au Marketing Cloud Salesforce vous permet d’exporter des fichiers vers un emplacement de stockage spécifié, alors qu’il s’agit d’une connexion en continu basée sur l’API.

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.

IMPORTANT

Veillez à créer l’attribut personnalisé sous le Email Demographics attribute-set dans votre Salesforce Marketing Cloud compte .

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.

Informations d’identification Description Exemple
  • Salesforce Marketing Cloud préfixe
Voir Salesforce Marketing Cloud domain prefix pour plus d’informations.
  • Si votre domaine est tel que ci-dessous, vous avez besoin de la valeur mise en surbrillance.
    mcq4jrssqdlyc4lph19nnqgzzs84.login.accuracy.target.com
  • Identifiant client
  • Secret client
Reportez-vous à la section Salesforce Marketing Cloud documentation si vous avez besoin de conseils supplémentaires.
  • r23kxxxxxxxxxx0z05xxxxxx
  • ipxxxxxxxxxxT4xxxxxxxxxx

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.

Identité cible Description Considérations
contactKey Salesforce Marketing Cloud Clé de contact. Reportez-vous à la section Salesforce Marketing Cloud documentation si vous avez besoin de conseils supplémentaires. 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 Marketing Cloud 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, 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.
Capture d’écran de l’interface utilisateur de Platform montrant comment s’authentifier sur le Marketing Cloud Salesforce.

  • 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.
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.

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 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.

IMPORTANT

Bien que vos noms d’attribut soient conformes à Salesforce Marketing Cloud , les mappages des deux contactKey et personalEmail.address sont obligatoires.

  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 des attributs catégorie et sélectionnez contactKey.
    Exemple de capture d’écran de l’interface utilisateur de Platform pour le mappage source.

  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.

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

    • 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.

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

    • 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 :

      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 à 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 .

IMPORTANT

La valeur utilisée pour l’ID de mappage doit correspondre exactement au nom de l’attribut personnalisé créé dans Salesforce sous le jeu d’attributs "Démographie des emails".

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 Activation data , 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. 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.
    Capture d’écran de l’interface utilisateur du Marketing Cloud Salesforce montrant la page Contacts avec les profils utilisés dans le segment.

  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 .
    Capture d’écran de l’interface utilisateur de Marketing Cloud Salesforce montrant la page Courrier électronique des contacts sélectionnée avec les statuts 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 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.

Copie d’écran de l’interface utilisateur de Platform affichant l’erreur.

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

Sur cette page