# Salesforce Marketing Cloud - Profile Sync (API)

[Salesforce ](https://www.salesforce.com)est une société de logiciels basée sur le cloud qui fournit des logiciels et des applications de gestion de la relation client (CRM) axés sur les ventes, le service client, l’automatisation marketing, l’analytique et le développement d’applications. En utilisant cette destination et vos [segments](https://doc.commandersact.com/features/customers/segment) vous pouvez créer ou mettre à jour (upsert) des lignes dans une [data extension](https://help.salesforce.com/s/articleView?id=data.c360_a_data_extensions.htm\&type=5) à l’aide de l’API REST synchrone Salesforce Marketing Cloud Engagement [upsertRowsetByKey](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc-data_extension_rows_sync?meta=upsertRowsetByKey) et activer une multitude de flux d’activation de données comme le panier abandonné.

## Fonctionnalités clés

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

* **Activation des données**: upserting [data extensions](https://help.salesforce.com/s/articleView?language=en_US\&id=data.c360_a_data_extensions.htm\&type=5) peut être utilisée pour activer divers flux d’activation de données basés sur le comportement de l’utilisateur (par exemple, synchronisation de profil en near-real-time, déclencheurs Journey et personnalisation sur site).
* **Prendre en charge le mode batch**: voir la section [Batch mode](#batch-mode) pour plus de détails.
* **Configuration facile :** sélectionnez vos variables de données dans [segments](https://doc.commandersact.com/features/customers/segment)et les champs Salesforce dans vos data extensions, à partir de menus déroulants intuitifs.

## Configuration de la destination

{% hint style="info" %}
Assurez-vous d’avoir accès à [Salesforce Marketing Cloud](https://mc.exacttarget.com/) avec les privilèges administrateur ou "Manage Connected Apps". Après authentification, notez les informations suivantes :\
• <mark style="color:bleu;">`Client ID`</mark>\
• <mark style="color:bleu;">`Client Secret`</mark>\
• <mark style="color:bleu;">`Tenant-Specific Subdomain`</mark>\
Vous pouvez trouver ces valeurs en cliquant sur votre nom d’utilisateur dans le coin supérieur droit et en sélectionnant <mark style="color:bleu;">`Setup`</mark> . Dans le menu de gauche, accédez à <mark style="color:bleu;">`Apps`</mark> → <mark style="color:bleu;">`Installed Packages`</mark> et sélectionnez le package que vous souhaitez utiliser ou créez-en un en cliquant sur <mark style="color:bleu;">`Nouveau`</mark> et ajoutez un nouveau composant <mark style="color:bleu;">`API Integration`</mark> .\
Ces informations sont nécessaires pour configurer votre <mark style="color:bleu;">`Identifiants`</mark> dans le [Configuration](#configuration) dans la section suivante.
{% endhint %}

### Configuration

<table><thead><tr><th width="331">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Identifiants</code></td><td><em><strong><code>Requis</code></strong></em><br>Vos identifiants avec Salesforce Marketing Cloud tels qu’ils sont définis directement dans votre destination ou, dans le menu de gauche, en suivant : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Ajouter des identifiants de connecteur</code> ➜ <code>Salesforce Marketinng</code> .</td></tr><tr><td><code>Data Extension</code></td><td><em><strong><code>Requis</code></strong></em><br>Sélectionnez votre data extension.</td></tr><tr><td><code>Primary Key Mapping</code></td><td><em><strong><code>Requis</code></strong></em><br>Sélectionnez la <mark style="color:bleu;"><code>Data variable</code></mark> contenant la valeur de clé primaire à rechercher pour trouver l’enregistrement à mettre à jour/insérer et le <mark style="color:bleu;"><code>Salesforce field</code></mark> représentant le nom de la colonne de clé primaire. Une entrée est requise.</td></tr><tr><td><code>Record Field Mapping</code></td><td><em><strong><code>Requis</code></strong></em><br>Sélectionnez la <mark style="color:bleu;"><code>Data variable</code></mark> contenant la valeur à mettre à jour/insérer et le <mark style="color:bleu;"><code>Salesforce field</code></mark> représentant le nom du champ associé. Une entrée est requise.</td></tr><tr><td><code>Activer le mode batch</code></td><td>Lorsqu’elle est cochée (par défaut), plusieurs enregistrements sont envoyés à votre data extension avec une seule requête au lieu d’être envoyés un par un. Voir la section <a href="#batch-mode">Batch mode</a> pour plus de détails.</td></tr></tbody></table>

## Mappings des champs

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

<table><thead><tr><th width="275">Nom de la propriété</th><th width="586">Valeur de la propriété</th></tr></thead><tbody><tr><td><code>Salesforce field</code> <strong>[1]</strong></td><td><code>Data variable</code> <strong>[1]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **1.** Voir <mark style="color:bleu;">`Record Field Mapping`</mark> dans [Configuration](#configuration) pour plus de détails.
> {% endhint %}

## Batch mode

Voir <mark style="color:bleu;">`Activer le mode batch`</mark> dans [Configuration](#configuration) pour gérer ce mode.\
L’activation du batch mode a ses avantages et ses inconvénients. Voir le tableau suivant pour plus de détails :

<table><thead><tr><th width="209">Activer le mode batch</th><th>Avantages</th><th>Inconvénients</th></tr></thead><tbody><tr><td><strong>Non cochée</strong></td><td>• Requêtes en temps réel.<br>• Meilleure gestion des erreurs.</td><td>• Plus susceptible d’être soumise aux <a href="#salesforce-api-limits">limites de l’API Salesforce</a>.</td></tr><tr><td><strong>Cochée</strong></td><td>• Moins susceptible d’être soumise aux <a href="#salesforce-api-limits">limites de l’API Salesforce</a>.</td><td>• Requêtes légèrement retardées.<br>• En cas d’erreur, tous les enregistrements d’une seule requête sont ignorés. <strong>[1]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **1.** La réponse d’erreur est héritée de l’API Salesforce associée [upsertRowsetByKey](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc-data_extension_rows_sync?meta=upsertRowsetByKey) qui renvoie des informations limitées pour plusieurs enregistrements dans une requête batch.
> {% endhint %}

## limites de l’API Salesforce

Salesforce protège ses services en imposant des [limites d’utilisation de l’API](https://help.salesforce.com/s/articleView?id=mktg.mc_overview_limits_api.htm\&type=5), ce qui entraîne les limites souples suivantes pour cette destination :

* Volume maximal 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 requêtes API synchrones : 2500 requêtes par minute sur l’ensemble des points de terminaison.
* Nombre maximal de connexions simultanées : 100 connexions.
* Taille maximale d’un batch pour les requêtes API synchrones : 50 objets.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/salesforce/salesforce-marketing-cloud-data-extension-upsert-row.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.