Salesforce Marketing Cloud - Profile Sync (API)

Salesforce est une entreprise de logiciels basée sur le cloud fournissant des logiciels et applications de gestion de la relation client (CRM) axés sur les ventes, le service client, l'automatisation marketing, l'analytics et le développement d'applications. En utilisant cette destination et votre segments vous pouvez créer ou mettre à jour (upsert) des lignes dans une data extension en utilisant l'API REST synchrone de Salesforce Marketing Cloud Engagement upsertRowsetByKey et activer une multitude de flux d'activation de données comme l'abandon de panier.

Principales fonctionnalités

La destination Salesforce Marketing Cloud - Profile Sync (API) fournit les fonctionnalités clés suivantes :

• Activation des données: upserting data extensions peuvent être utilisées pour activer divers flux d'activation de données basés sur le comportement utilisateur (par ex. synchronisation de profil quasi-temps réel, déclencheurs de Journey, et personnalisation sur site).

• Prise en charge du mode batch: voir la section Mode batch pour plus de détails.

• Configuration facile : sélectionnez vos variables de données dans segments, et les champs Salesforce dans vos data extensions, à partir de menus déroulants intuitifs.

Configuration de la destination

Assurez-vous d'avoir accès à Salesforce Marketing Cloud avec les privilèges d'administrateur ou l'autorisation "Manage Connected Apps". Après authentification, notez les informations suivantes : • Client ID • Client Secret • Tenant-Specific Subdomain Vous pouvez trouver ces valeurs en cliquant sur votre nom d'utilisateur en haut à droite et en sélectionnant Installation . Dans le menu à gauche, naviguez vers Apps → Installed Packages et sélectionnez le package que vous souhaitez utiliser ou créez-en un en cliquant sur Nouvelle et ajoutez un nouveau API Integration composant. Ces informations sont requises pour configurer votre Identifiants dans le Configuration section suivante.

Configuration

Settings	Description
Identifiants	Obligatoire Vos identifiants avec Salesforce Marketing Cloud tels que définis directement dans votre destination ou, dans le menu gauche, en suivant : Administration ➜ Identifiants du connecteur ➜ Ajouter des identifiants de connecteur ➜ Salesforce Marketinng .
Data Extension	Obligatoire Sélectionnez votre data extension.
Mappage de clé primaire	Obligatoire Sélectionnez la Data variable contenant la valeur de la clé primaire à rechercher pour trouver l'enregistrement à mettre à jour/insérer et le Salesforce field représentant le nom de la colonne de clé primaire. Une entrée est requise.
Mappage des champs d'enregistrement	Obligatoire Sélectionnez la Data variable contenant la valeur à mettre à jour/insérer et le Salesforce field représentant le nom du champ associé. Une entrée est requise.
Activer le mode batch	Lorsque coché (par défaut), plusieurs enregistrements sont envoyés à votre data extension avec une seule requête au lieu d'un par un. Voir la section Mode batch pour plus de détails.

Mappings de champs

Les enregistrements de data extension créés ou mis à jour incluent les propriétés suivantes :

Nom de la propriété	Valeur de la propriété
Salesforce field [1]	Data variable [1]

[1] Voir Mappage des champs d'enregistrement dans Configuration pour plus de détails.

Mode batch

Voir Activer le mode batch dans Configuration pour gérer ce mode. L'activation du mode batch a ses avantages et ses inconvénients. Voir le tableau suivant pour plus de détails :

Activer le mode batch	Avantages	Inconvénients
Non coché	• Requêtes en temps réel. • Meilleure gestion des erreurs.	• Plus susceptible aux Salesforce API limits.
Coché	• Moins susceptible aux Salesforce API limits.	• Requêtes légèrement reportées. • En cas d'erreur, tous les enregistrements d'une même requête sont rejetés. [1]

[1] La réponse d'erreur est héritée de l'API Salesforce associée upsertRowsetByKey qui retourne des informations limitées pour plusieurs enregistrements dans une requête batch.

Salesforce API limits

Salesforce protège ses services en imposant des limits on API usage, résultant dans les soft limits suivants pour cette destination :

• Volume maximum de requêtes API. La limite dépend de votre édition :

  • Pro: 2 millions de requêtes par an.

  • Corporate: 6 millions de requêtes par an.

  • Enterprise: 200 millions de requêtes par an.

• Taux maximal de requêtes pour les API synchrones : 2500 requêtes par minute tous endpoints confondus.

• Nombre maximum de connexions simultanées : 100 connexions.

• Taille maximale de batch pour les requêtes API synchrones : 50 objets.