> 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 la performance de vos campagnes marketing LinkedIn, quel que soit l'endroit où se produit la conversion, et d'utiliser ces données pour optimiser les 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 principales fonctionnalités suivantes :

* **Structure des événements**: notre [Référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) correspondances du 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 s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping 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, 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 [Campaign Manager](https://www.linkedin.com/campaignmanager/) compte, puis sélectionnez <mark style="color:bleu;">`Analyze`</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. Dans la <mark style="color:bleu;">`Suivi des conversions`</mark> section, cliquez sur votre règle de conversion et accédez à 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" %}
Pour 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 à partir de [Campaign Manager](https://www.linkedin.com/help/lms/answer/a423304/enable-first-party-cookies-on-a-linkedin-insight-tag). Cela active des First party cookies 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 de mise en œuvre.
{% 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;">`ID de l'événement`</mark> , [Mappages de champs](#field-mappings) (Voir la propriété <mark style="color:bleu;">`eventId`</mark> ) ou ceci [LINK](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 API Token n'est pas fourni</code></strong></em><br>Vos identifiants LinkedIn Campaign Manager tels que définis dans l'interface Commanders Act, comme suit : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants de connecteur</code> ➜ <code>LinkedinAds</code></td></tr><tr><td><code>API Token</code></td><td><em><strong><code>Requis si les Credentials ne sont pas fournis</code></strong></em><br>Sélectionnez <code>Utiliser le API Token</code> pour saisir votre <code>API Token</code>. Celui-ci se trouve dans votre <a href="https://www.linkedin.com/campaignmanager/">Campaign Manager</a> compte en suivant <code>Données</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>Identifiants</code> ou <code>API Token</code>, et le second a la 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>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 en sélectionnant « Analyze » → « Suivi des conversions » dans le menu de gauche.</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events       | 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:bleu;">`Nom de la règle de conversion`</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 [Mappage intelligent](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.
{% endhint %}

{% hint style="warning" %}
Au moins l'une des affirmations suivantes, liées aux champs « Smart Mapping », doit être satisfaite :\
• Le champ <mark style="color:bleu;">`User Email SHA256`</mark> est défini.\
• Le champ <mark style="color:bleu;">`LinkedIn UUID`</mark> ou le cookie <mark style="color:bleu;">`li_fat_id`</mark> est défini.\
• Le champ <mark style="color:bleu;">`LiveRamp ACXIOM Id`</mark> est défini.\
• Le champ <mark style="color:bleu;">`Oracle MOAT Id`</mark> est défini.\
• Les deux champs <mark style="color:bleu;">`Prénom de l’utilisateur`</mark> et <mark style="color:bleu;">`Nom de famille de l’utilisateur`</mark> sont définis.\
De plus, si vous envoyez des informations utilisateur via les champs « Smart Mapping » (par ex. <mark style="color:bleu;">`User Company Name`</mark> , <mark style="color:bleu;">`User Job Title`</mark> , ou <mark style="color:bleu;">`Pays de l'utilisateur`</mark> ), vous devez configurer les <mark style="color:bleu;">`Prénom de l’utilisateur`</mark> et <mark style="color:bleu;">`Nom de famille de l’utilisateur`</mark> champs, que vous fournissiez ou non d'autres valeurs d'identité mentionnées ci-dessus. Plus de détails sont disponibles via ce [LINK](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>LinkedIn Properties</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>valeur</code></td><td><code>conversionValue.amount</code> <strong>[*]</strong></td></tr><tr><td><code>currency</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: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. Cela est utilisé pour la déduplication. Plus de détails sont disponibles via ce [LINK](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/deduplication?view=li-lms-2023-11).\
**3.** Si un e-mail utilisateur en clair est fourni, il est automatiquement haché 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 : <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> ou <mark style="color:bleu;">`ORACLE_MOAT_ID`</mark> . Plus de détails sont disponibles en suivant ce [LINK](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, 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.