> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/salesforce/salesforce-marketing-cloud-data-extension-upsert-row.md).

# Salesforce Marketing Cloud - Profile Sync (API)

[Salesforce ](https://www.salesforce.com)est une entreprise de logiciels cloud qui fournit des logiciels et applications de gestion de la relation client (CRM) axés sur les ventes, le service client, l’automatisation du marketing, l’analytique et le développement d’applications. En utilisant cette destination et votre [segments](https://doc.commandersact.com/features/customers/segment) vous pouvez créer ou mettre à jour (upsert) des lignes dans un [data extension](https://help.salesforce.com/s/articleView?id=data.c360_a_data_extensions.htm\&type=5) à l’aide de l’API REST synchrone de Salesforce Marketing Cloud Engagement [upsertRowsetByKey](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc-data_extension_rows_sync?meta=upsertRowsetByKey) et permettre 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) offre les fonctionnalités clé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) peuvent être utilisées pour activer divers flux d’activation de données basés sur le comportement de l’utilisateur (par ex. synchronisation de profil quasi en temps réel, déclencheurs de Journey et personnalisation sur site).
* **Prise en charge du mode batch**: voir la section [Mode batch](#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 des privilèges d’administrateur ou d’utilisateur "Manage Connected Apps". Après authentification, prenez note des informations suivantes :\
• <mark style="color:bleu;">`Client ID`</mark>\
• <mark style="color:bleu;">`Client Secret`</mark>\
• <mark style="color:bleu;">`Sous-domaine spécifique au tenant`</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;">`Configuration`</mark> . Dans le menu de gauche, accédez à <mark style="color:bleu;">`Applications`</mark> → <mark style="color:bleu;">`Packages installés`</mark> et sélectionnez le package que vous souhaitez utiliser ou en créer un en cliquant sur <mark style="color:bleu;">`Nouveau`</mark> et ajoutez un nouveau <mark style="color:bleu;">`intégration API`</mark> composant.\
Ces informations sont nécessaires pour configurer votre <mark style="color:bleu;">`Identifiants`</mark> dans le [Configuration](#configuration) 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>Obligatoire</code></strong></em><br>Vos identifiants Salesforce Marketing Cloud tels qu’ils sont configurés directement dans votre destination ou, dans le menu de gauche, en suivant : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants de connecteur</code> ➜ <code>Salesforce Marketing</code> .</td></tr><tr><td><code>Data Extension</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez votre Data Extension.</td></tr><tr><td><code>Mappage de clé primaire</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez la <mark style="color:bleu;"><code>variable de données</code></mark> contenant la valeur de clé primaire à rechercher pour trouver l’enregistrement à mettre à jour/insérer et le <mark style="color:bleu;"><code>champ Salesforce</code></mark> représentant le nom de la colonne de clé primaire. Une entrée est requise.</td></tr><tr><td><code>Mappage du champ d’enregistrement</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez la <mark style="color:bleu;"><code>variable de données</code></mark> contenant la valeur à mettre à jour/insérer et le <mark style="color:bleu;"><code>champ Salesforce</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 via une seule requête au lieu d’un envoi un par un. Voir la section <a href="#batch-mode">Mode batch</a> pour plus de détails.</td></tr></tbody></table>

## Correspondances 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>champ Salesforce</code> <strong>[1]</strong></td><td><code>variable de données</code> <strong>[1]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir <mark style="color:bleu;">`Mappage du champ d’enregistrement`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mode batch

Voir <mark style="color:bleu;">`Activer le mode batch`</mark> dans [Configuration](#configuration) pour gérer ce mode.\
L’activation du mode batch présente des avantages et des inconvénients. Consultez 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 aux <a href="#salesforce-api-limits">limites de l’API Salesforce</a>.</td></tr><tr><td><strong>Cochée</strong></td><td>• Moins susceptible aux <a href="#salesforce-api-limits">limites de l’API Salesforce</a>.</td><td>• Requêtes légèrement différées.<br>• En cas d’erreur, tous les enregistrements d’une même 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 synchrones API : 2500 requêtes par minute sur l’ensemble des endpoints.
* Nombre maximal de connexions simultanées : 100 connexions.
* Taille maximale du batch pour les requêtes synchrones API : 50 objets.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.