> 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 CAPI

[LinkedIn](https://www.linkedin.com/) est une plateforme de réseaux sociaux axée sur le monde professionnel et l’emploi.\
Cette destination vous permet d’envoyer des événements de conversion à LinkedIn via sa [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). Vous pouvez ainsi mesurer les performances de vos campagnes marketing LinkedIn, quel que soit l’endroit où la conversion a lieu, et utiliser ces données pour optimiser vos campagnes. Cette destination peut contribuer à améliorer les performances et à réduire le coût par action grâce à une attribution plus complète, à une meilleure fiabilité des données et à une diffusion optimisée.

## Fonctionnalités clés

La destination LinkedIn offre les principales fonctionnalités suivantes :

* **Structure des événements** : notre [référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) correspond au modèle des [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 garantit que vos données sont correctement associées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur les événements s’effectue automatiquement, ce qui simplifie la saisie.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.

## Configuration de la destination

Avant d’utiliser cette destination, examinez 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 compte [Campaign Manager](https://www.linkedin.com/campaignmanager/) et en sélectionnant <mark style="color:bleu;">`Analyze`</mark> `(1)` → <mark style="color:bleu;">`Conversion tracking`</mark> `(2)` dans le menu de gauche :

![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-a4ec547c2879fc6d41ccb37fc9e3c05991f0de70%2Flinkedin_1.png?alt=media)\
Vous pouvez également créer une règle de conversion en cliquant sur <mark style="color:bleu;">`Create conversion`</mark> `(3)` → <mark style="color:bleu;">`Conversions API or CSV conversion`</mark> `(4)` :

<img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-014c33147fa87d647320fd6d0d18eb8a46f17961%2Flinkedin_2.png?alt=media" alt="" data-size="original">

Enfin, vous devez associer votre règle de conversion à une ou plusieurs campagnes. Dans la section <mark style="color:bleu;">`Conversion tracking`</mark> , cliquez sur votre règle de conversion, puis passez à l’étape 3, où vous pourrez sélectionner les campagnes dont vous souhaitez suivre les conversions :

<img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-d850493db54ec731e65031f8f1a832ce3a9d2155%2Flinkedin_3.png?alt=media" alt="" data-size="original">
{% endhint %}

{% hint style="info" %}
Pour renseigner 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). Cette opération active les cookies First party qui ajoutent un paramètre d’identifiant de clic (« li\_fat\_id ») aux URL de clic. Consultez [Activation des identifiants de clic](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/enabling-first-party-cookies?view=li-lms-2023-11) pour en savoir plus sur la mise en œuvre.
{% endhint %}

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

### Configuration

<table><thead><tr><th width="349">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Credentials</code></td><td><em><strong><code>Required if API Token is not provided</code></strong></em><br>Vos identifiants LinkedIn Campaign Manager, tels qu’ils sont définis dans l’interface Commanders Act : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Ajouter des identifiants de connexion au connecteur</code> ➜ <code>LinkedinAds</code></td></tr><tr><td><code>API Token</code></td><td><em><strong><code>Required if Credentials is not provided</code></strong></em><br>Sélectionner <code>Use API Token</code> pour saisir votre <code>API Token</code>. Vous le trouverez dans votre compte <a href="https://www.linkedin.com/campaignmanager/">Campaign Manager</a> en suivant ces étapes : <code>Data</code> → <code>Signals manager</code> → <code>Direct API</code> → <code>Generate access token</code>. Au moins l’un des éléments suivants est requis : <code>Credentials</code> ou <code>API Token</code>, le second étant prioritaire sur le premier.</td></tr><tr><td><code>Mapping</code></td><td><em><strong><code>Required</code></strong></em><br>Associez les règles de conversion LinkedIn à vos événements en renseignant au moins un <code>Conversion rule name</code> et <code>Your event name</code> . Une entrée est requise. Vous pouvez créer ou modifier une règle de conversion dans votre compte <a href="https://www.linkedin.com/campaignmanager/">Campaign Manager</a> et en sélectionnant « Analyser » → « Suivi des conversions » dans le menu de gauche.</td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act | Suivi LinkedIn                   |
| ------------------------- | -------------------------------- |
| `[Any Event]` **\[1]**    | `[Any Conversion Rule]` **\[2]** |

{% hint style="info" %}
**1.** Utilisez les [**filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier les événements correspondants.\
**2.** Voir <mark style="color:bleu;">`Conversion Rule Name`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Correspondances des champs

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

{% hint style="warning" %}
Au moins l’un des champs « Smart Mapping » suivants doit être renseigné avec une valeur valide, sauf si un autre identifiant utilisateur valide est fourni :\
• <mark style="color:bleu;">`User Email 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;">`Device IP`</mark>\
• <mark style="color:bleu;">`Device Mobile Identifier`</mark>\
De plus, si vous envoyez des informations utilisateur via les champs « Smart Mapping » (<mark style="color:bleu;">`User Company Name`</mark> , <mark style="color:bleu;">`User Job Title`</mark> , ou <mark style="color:bleu;">`User Country`</mark> ), vous devez définir les <mark style="color:bleu;">`User First Name`</mark> et <mark style="color:bleu;">`User Last Name`</mark> champs, que vous fournissiez ou non d’autres valeurs d’identité répertoriées ci-dessus. Pour plus de détails, consultez 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>Conversion rule name</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>currency</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>User Email 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>Device IP</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>User Email 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>Device IP</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 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>User Job Title</code></td><td><code>user.title</code></td><td><code>user.userInfo.title</code></td></tr><tr><td><code>User Company Name</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;">`Mapping`</mark> dans [Configuration](#configuration) pour plus de détails.\
**2.** ID unique généré par les annonceurs pour identifier chaque événement. Il est utilisé pour la déduplication. Pour plus de détails, consultez 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 avec SHA256. Le champ « Smart Mapping » <mark style="color:bleu;">`Linkedin UUID`</mark> est prioritaire 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 :\
• <mark style="color:bleu;">`SHA256_EMAIL`</mark>\
• <mark style="color:bleu;">`LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID`</mark>\
• <mark style="color:bleu;">`ACXIOM_ID`</mark>\
• <mark style="color:bleu;">`ORACLE_MOAT_ID`</mark>\
• <mark style="color:bleu;">`PLAINTEXT_IP_ADDRESS`</mark>\
• <mark style="color:bleu;">`GOOGLE_AID`</mark>\
Plus de détails sont disponibles ci-après [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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/linkedin_capi.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
