Salesforce Marketing Cloud - Data Extension Upsert Row

Salesforce est une société de logiciels basée sur le cloud fournissant des logiciels et des 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 vos segments vous pouvez créer ou mettre à jour (upsert) une ligne 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.

Fonctionnalités clés

La destination Salesforce Marketing Cloud - Data Extension Upsert Row 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 de l'utilisateur.

• Prise en charge du mode batch: vous pouvez activer librement le mode batch dans Configuration. Voir la section Batch mode pour plus de détails. Cette fonctionnalité est actuellement en phase de tests finaux et sera bientôt publiée.

• Configuration facile : sélectionnez vos variables de données, dans segments, depuis un menu déroulant.

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 Setup . Dans le menu de gauche, naviguez vers Apps → Installed Packages et sélectionnez le package que vous souhaitez utiliser ou créez-en un en cliquant sur New et ajoutez un nouveau API Integration composant. Ces informations sont requises pour définir vos Credentials . Voir la section suivante Configuration pour plus de détails.

Configuration

Paramètres	Description
Credentials	Requis Vos informations d'identification pour Salesforce Marketing Cloud telles que définies directement dans votre destination ou, dans le menu de gauche, en suivant : Administration ➜ Connector Credentials ➜ Ajouter des credentials de connector ➜ Salesforce Marketinng .
Data Extension Id	Requis L'identifiant unique pour la data extension.
Mapping de clé primaire	Requis Sélectionnez la Data variable contenant la valeur de la clé primaire à rechercher pour trouver l'enregistrement à mettre à jour/insérer et saisissez la Salesforce column représentant le nom de la colonne clé primaire. Une entrée est requise.
Mapping des champs d'enregistrement	Requis Sélectionnez la Data variable contenant la valeur à mettre à jour/insérer et saisissez la Salesforce column représentant le nom du champ associé. Une entrée est requise.
Activer le mode batch [1]	Lorsqu'il est coché, plusieurs enregistrements sont envoyés à votre data extension avec une seule requête au lieu d'un à la fois. Voir la section Batch mode pour plus de détails. [1]

[1] Cette fonctionnalité est actuellement en phase de tests finaux et sera bientôt publiée.

Mappings de champs

Les enregistrements créés dans la data extension incluent les propriétés suivantes :

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

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

Batch mode

Cette fonctionnalité est actuellement en phase de tests finaux et sera bientôt publiée.

L'activation du mode batch a ses avantages et ses inconvénients. Consultez 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 retardé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' upsertRowsetByKey associée, qui renvoie des informations limitées pour plusieurs enregistrements dans une requête batch.

Salesforce API limits

Salesforce protège ses services en imposant limits on API usage, entraînant les limites souples suivantes 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 sur l'ensemble des endpoints.

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

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