> 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/linkedin_capi.md).

# LinkedIn Conversions API

[LinkedIn](https://www.linkedin.com/) est une plateforme de médias sociaux axée sur les affaires et l’emploi.\
Grâce à cette destination, vous pouvez diffuser des événements de conversion vers LinkedIn via leur [Conversions API](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api?view=li-lms-2023-11\&tabs=http#streaming-conversion-events). Cela permet de mesurer les performances de vos campagnes marketing LinkedIn, quel que soit l’endroit où la conversion a lieu, et d’utiliser ces données pour alimenter l’optimisation des campagnes. Cette destination peut aider à renforcer les performances et à réduire le coût par action grâce à une attribution plus complète, une fiabilité des données améliorée et une diffusion mieux optimisée.

## Fonctionnalités clés

La destination LinkedIn fournit les fonctionnalités clés suivantes :

* **Structure des événements**: notre [référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) modèle correspond à [les règles de conversion de LinkedIn](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api?view=li-lms-2023-07\&tabs=curl#create-a-conversion-rule), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être réajusté à l’aide des champs définis dans votre datalayer.

## Configuration de la destination

Avant d’utiliser cette destination, vérifiez vos règles de conversion et vos campagnes dans LinkedIn :

{% hint style="info" %}
Tout d’abord, assurez-vous qu’au moins une règle de conversion est définie dans LinkedIn en accédant à votre [Campaign Manager](https://www.linkedin.com/campaignmanager/) et sélectionnez <mark style="color:bleu;">`Analyser`</mark> `(1)` → <mark style="color:bleu;">`suivi des conversions`</mark> `(2)` dans le menu de gauche :

![](/files/776fa743cfea954a6d4ca3d6b1ccc2171904d0d9)\
Vous pouvez également créer une nouvelle règle de conversion en cliquant sur <mark style="color:bleu;">`Créer une conversion`</mark> `(3)` → <mark style="color:bleu;">`Conversions API ou conversion CSV`</mark> `(4)` :

<img src="/files/dbb30961f5a7cf32c69c03e15475bf3c73697001" alt="" data-size="original">

Enfin, vous devez associer votre règle de conversion à une ou plusieurs campagnes. Depuis la <mark style="color:bleu;">`suivi des conversions`</mark> section, cliquez sur votre règle de conversion et passez à l’étape 3 où vous pouvez sélectionner les campagnes que vous souhaitez suivre avec la conversion :

<img src="/files/b5ab57c13d4037e829d72571e717ef12c680f02e" alt="" data-size="original">
{% endhint %}

{% hint style="info" %}
Afin de définir le champ facultatif "Smart Mapping" <mark style="color:bleu;">`Linkedin UUID`</mark> ou le cookie associé <mark style="color:bleu;">`li_fat_id`</mark> , les annonceurs doivent activer le suivi amélioré des conversions depuis [Campaign Manager](https://www.linkedin.com/help/lms/answer/a423304/enable-first-party-cookies-on-a-linkedin-insight-tag). Cela active les cookies First party qui ajoutent un paramètre d’identifiant de clic ("li\_fat\_id") aux URL de clic. Consultez [Activation des Click IDs](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/enabling-first-party-cookies?view=li-lms-2023-11) pour les détails d’implémentation.
{% endhint %}

{% hint style="info" %}
LinkedIn CAPI prend en charge la déduplication avec votre client-side [Insight Tag](https://business.linkedin.com/marketing-solutions/insight-tag).\
Vérifiez le champ "Smart Mapping" <mark style="color:bleu;">`Event Id`</mark> , [Mappages de champs](#field-mappings) (Voir la propriété <mark style="color:bleu;">`eventId`</mark> ) ou ce [LIEN](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/deduplication?view=li-lms-2023-11) pour plus de détails.
{% endhint %}

### Configuration

<table><thead><tr><th width="349">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Identifiants</code></td><td><em><strong><code>Requis si le jeton API n’est pas fourni</code></strong></em><br>Vos identifiants avec LinkedIn Campaign Manager tels que définis dans l’interface Commanders Act en suivant : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants du connecteur</code> ➜ <code>LinkedinAds</code></td></tr><tr><td><code>Jeton API</code></td><td><em><strong><code>Requis si les identifiants ne sont pas fournis</code></strong></em><br>Sélectionner <code>Utiliser le jeton API</code> pour saisir votre <code>Jeton API</code>. Cela se trouve dans votre <a href="https://www.linkedin.com/campaignmanager/">Campaign Manager</a> compte en suivant <code>Données</code> → <code>gestionnaire de signaux</code> → <code>API directe</code> → <code>Générer le jeton d’accès</code>. Au moins l’un des éléments suivants est requis : <code>Identifiants</code> ou <code>Jeton API</code>, et ce dernier a priorité sur le premier.</td></tr><tr><td><code>Mappage</code></td><td><em><strong><code>Requis</code></strong></em><br>Mappez les règles de conversion LinkedIn avec vos événements en définissant au moins une paire <code>Nom de la règle de conversion</code> et <code>Nom de votre événement</code> . Une entrée est requise. Vous pouvez créer/modifier une règle de conversion en accédant à votre <a href="https://www.linkedin.com/campaignmanager/">Campaign Manager</a> compte et sélectionnez "Analyze" → "suivi des conversions" dans le menu de gauche.</td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act   | Suivi LinkedIn                         |
| --------------------------- | -------------------------------------- |
| `[Tout événement]` **\[1]** | `[Toute règle de conversion]` **\[2]** |

{% hint style="info" %}
**1.** Utiliser [**Filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements correspondants.\
**2.** Voir <mark style="color:bleu;">`Nom de la règle de conversion`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l’aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.
{% endhint %}

{% hint style="warning" %}
Au moins l’un des champs "Smart Mapping" suivants doit être défini avec une valeur correcte, sauf si un autre identifiant utilisateur valide est fourni :\
• <mark style="color:bleu;">`E-mail utilisateur SHA256`</mark> \
• <mark style="color:bleu;">`Linkedin UUID`</mark> ou le cookie <mark style="color:bleu;">`li_fat_id`</mark>\
• <mark style="color:bleu;">`LiveRamp ACXIOM Id`</mark>\
• <mark style="color:bleu;">`Oracle MOAT Id`</mark>\
• <mark style="color:bleu;">`IP de l’appareil`</mark> \
• <mark style="color:bleu;">`Identifiant mobile de l’appareil`</mark> \
De plus, si vous envoyez des informations utilisateur via des champs "Smart Mapping" (<mark style="color:bleu;">`Nom de l’entreprise de l’utilisateur`</mark> , <mark style="color:bleu;">`Intitulé du poste de l’utilisateur`</mark> , ou <mark style="color:bleu;">`Pays de l’utilisateur`</mark> ), vous devez définir les <mark style="color:bleu;">`Prénom de l’utilisateur`</mark> et <mark style="color:bleu;">`Nom de famille de l’utilisateur`</mark> champs, quelle que soit la valeur d’identité que vous fournissez parmi celles listées ci-dessus. Plus de détails sont disponibles en suivant ce [LIEN](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api-schema?view=li-lms-2026-07\&source=recommendations#input-data-validation).
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Champs Smart Mapping</th><th>Propriétés par défaut de Commanders Act</th><th>Propriétés LinkedIn</th></tr></thead><tbody><tr><td><code>-</code></td><td><code>Nom de la règle de conversion</code></td><td><code>conversion</code> <strong>[1][*]</strong></td></tr><tr><td><code>Horodatage de l’événement</code></td><td><code>context.event_timestamp</code></td><td><code>conversionHappenedAt</code> <strong>[*]</strong></td></tr><tr><td><code>Valeur de la transaction</code></td><td><code>value</code></td><td><code>conversionValue.amount</code></td></tr><tr><td><code>Devise</code></td><td><code>devise</code></td><td><code>conversionValue.currencyCode</code></td></tr><tr><td><code>Event Id</code></td><td><code>context.event_id</code></td><td><code>eventId</code> <strong>[2]</strong></td></tr><tr><td><p><code>E-mail utilisateur SHA256</code></p><p><code>Linkedin UUID</code></p><p><code>LiveRamp ACXIOM Id</code></p><p><code>Oracle MOAT Id</code></p><p><code>IP de l’appareil</code></p><p><code>Identifiant mobile de l’appareil</code></p></td><td><p><code>user.email_sha256</code></p><p><code>partners.linkedin.uuid</code></p><p><code>partners.linkedin.acxiom_id</code></p><p><code>partners.linkedin.moat_id</code></p><p><code>context.device.ip</code></p><p><code>context.device.advertising_id</code></p></td><td><code>user.userIds.X.idValue</code> <strong>[3]</strong></td></tr><tr><td><p><code>E-mail utilisateur SHA256</code></p><p><code>Linkedin UUID</code></p><p><code>LiveRamp ACXIOM Id</code></p><p><code>Oracle MOAT Id</code></p><p><code>IP de l’appareil</code></p><p><code>Identifiant mobile de l’appareil</code></p></td><td><p><code>user.email_sha256</code></p><p><code>partners.linkedin.uuid</code></p><p><code>partners.linkedin.acxiom_id</code></p><p><code>partners.linkedin.moat_id</code></p><p><code>context.device.ip</code></p><p><code>context.device.advertising_id</code></p></td><td><code>user.userIds.X.idType</code> <strong>[4]</strong></td></tr><tr><td><code>Prénom de l’utilisateur</code></td><td><code>user.firstname</code></td><td><code>user.userInfo.firstName</code></td></tr><tr><td><code>Nom de famille de l’utilisateur</code></td><td><code>user.lastname</code></td><td><code>user.userInfo.lastName</code></td></tr><tr><td><code>Pays de l’utilisateur</code></td><td><code>user.country</code></td><td><code>user.userInfo.countryCode</code></td></tr><tr><td><code>Intitulé du poste de l’utilisateur</code></td><td><code>user.title</code></td><td><code>user.userInfo.title</code></td></tr><tr><td><code>Nom de l’entreprise de l’utilisateur</code></td><td><code>user.company_name</code></td><td><code>user.userInfo.companyName</code></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** La valeur inclut la chaîne statique "urn:lla:llaPartnerConversion:". Voir <mark style="color:bleu;">`Mappage`</mark> dans [Configuration](#configuration) pour plus de détails.\
**2.** L’ID unique généré par les annonceurs pour indiquer chaque événement. Il est utilisé pour la déduplication. Plus de détails sont disponibles en suivant ce [LIEN](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/deduplication?view=li-lms-2023-11).\
**3.** Si une adresse e-mail utilisateur en clair est fournie, elle est automatiquement hachée via SHA256. Le champ "Smart Mapping" <mark style="color:bleu;">`Linkedin UUID`</mark> a priorité sur le cookie <mark style="color:bleu;">`li_fat_id`</mark> .\
**4.** Selon la valeur définie dans <mark style="color:bleu;">`user.userIds.X.idValue`</mark> , il s’agit de l’une des chaînes suivantes :\
&#x20;   • <mark style="color:bleu;">`SHA256_EMAIL`</mark> \
&#x20;   • <mark style="color:bleu;">`LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID`</mark> \
&#x20;   • <mark style="color:bleu;">`ACXIOM_ID`</mark> \
&#x20;   • <mark style="color:bleu;">`ORACLE_MOAT_ID`</mark> \
&#x20;   • <mark style="color:bleu;">`PLAINTEXT_IP_ADDRESS`</mark> \
&#x20;   • <mark style="color:bleu;">`GOOGLE_AID`</mark>\
Plus de détails sont disponibles en suivant ce [LIEN](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api-schema?view=li-lms-2026-07\&source=recommendations#idtype).
{% endhint %}


---

# 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/linkedin_capi.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.