> 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 le monde professionnel et l'emploi.\
Grâce à cette destination, vous pouvez diffuser les é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ù se produit la conversion, et d'utiliser ces données pour piloter 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 offre 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) correspondances de modèle [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 la saisie utilisateur.
* **Hachage automatique** : les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Smart Mapping**: le mappage des données peut être réajusté à l'aide de vos champs définis dans le data layer.

## 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/) compte et sélectionnez <mark style="color:bleue;">`Analyser`</mark> `(1)` → <mark style="color:bleue;">`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:bleue;">`Créer une conversion`</mark> `(3)` → <mark style="color:bleue;">`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:bleue;">`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:bleue;">`LinkedIn UUID`</mark> ou le cookie associé <mark style="color:bleue;">`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 First party cookies qui ajoutent un paramètre d'identifiant de clic ("li\_fat\_id") aux URL de clic. Consultez [Activation des ID de clic](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:bleue;">`Event ID`</mark> , [Mappages de champs](#field-mappings) (Voir la propriété <mark style="color:bleue;">`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 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électionnez <code>Utiliser le jeton API</code> pour saisir votre <code>jeton API</code>. Vous pouvez le trouver 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 un jeton d'accès</code>. Au moins l'une des options suivantes est requise : <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>Obligatoire</code></strong></em><br>Associez les règles de conversion LinkedIn à vos événements en définissant au moins une paire <code>nom de la règle de conversion</code> et <code>Votre nom d'é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 en sélectionnant "Analyser" → "Suivi des conversions" dans le menu de gauche.</td></tr></tbody></table>

## Référence rapide

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

{% hint style="info" %}
**1.** Utilisez [**Filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements correspondants.\
**2.** Voir <mark style="color:bleue;">`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'une des affirmations suivantes, relatives aux champs "Smart Mapping", doit être satisfaite :\
• Le champ <mark style="color:bleue;">`User Email SHA256`</mark> est défini.\
• Le champ <mark style="color:bleue;">`LinkedIn UUID`</mark> ou le cookie <mark style="color:bleue;">`li_fat_id`</mark> est défini.\
• Le champ <mark style="color:bleue;">`LiveRamp ACXIOM Id`</mark> est défini.\
• Le champ <mark style="color:bleue;">`Oracle MOAT Id`</mark> est défini.\
• Les deux champs <mark style="color:bleue;">`User First Name`</mark> et <mark style="color:bleue;">`User Last Name`</mark> sont définis.\
De plus, si vous envoyez des informations utilisateur via les champs "Smart Mapping" (p. ex. <mark style="color:bleue;">`User Company Name`</mark> , <mark style="color:bleue;">`User Job Title`</mark> , ou <mark style="color:bleue;">`User Country`</mark> ), vous devez renseigner les <mark style="color:bleue;">`User First Name`</mark> et <mark style="color:bleue;">`User Last Name`</mark> champs, que vous fournissiez ou non les autres valeurs d'identité 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?view=li-lms-2023-11\&tabs=http#input-data-validation).
{% endhint %}

<table><thead><tr><th width="341.6685580062746">Propriétés Commanders Act</th><th>Propriétés LinkedIn</th></tr></thead><tbody><tr><td><code>nom de la règle de conversion</code></td><td><code>conversion</code> <strong>[1][*]</strong></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>conversionHappenedAt</code> <strong>[*]</strong></td></tr><tr><td><code>value</code></td><td><code>conversionValue.amount</code> <strong>[*]</strong></td></tr><tr><td><code>devise</code></td><td><code>conversionValue.currencyCode</code> <strong>[*]</strong></td></tr><tr><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>partners.linkedin.uuid</code></p><p><code>partners.linkedin.acxiom_id</code></p><p><code>partners.linkedin.moat_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>partners.linkedin.uuid</code></p><p><code>partners.linkedin.acxiom_id</code></p><p><code>partners.linkedin.moat_id)</code></p></td><td><code>user.userIds.X.idType</code> <strong>[4]</strong></td></tr><tr><td><code>user.firstname</code></td><td><code>user.userInfo.firstName</code></td></tr><tr><td><code>user.lastname</code></td><td><code>user.userInfo.lastName</code></td></tr><tr><td><code>user.country</code></td><td><code>user.userInfo.countryCode</code></td></tr><tr><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.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:bleue;">`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. Cela 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:bleue;">`LinkedIn UUID`</mark> a priorité sur le cookie <mark style="color:bleue;">`li_fat_id`</mark> .\
**4.** Selon la valeur définie dans <mark style="color:bleue;">`user.userIds.X.idValue`</mark> , il s'agit de l'une des chaînes suivantes : <mark style="color:bleue;">`SHA256_EMAIL`</mark> , <mark style="color:bleue;">`LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID`</mark> , <mark style="color:bleue;">`ACXIOM_ID`</mark> ou <mark style="color:bleue;">`ORACLE_MOAT_ID`</mark> . Plus de détails sont disponibles en suivant ce [LIEN](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api?view=li-lms-2023-11\&tabs=http#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:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/linkedin_capi.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.