# LinkedIn Conversions API

[LinkedIn](https://www.linkedin.com/) est une plateforme de médias sociaux axée sur les affaires et l’emploi.\
En utilisant 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 se produit, 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 meilleure fiabilité des données et une diffusion mieux optimisée.

## Fonctionnalités clés

La destination LinkedIn fournit 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 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 les é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, consultez vos règles de conversion et vos campagnes dans LinkedIn :

{% hint style="info" %}
Commencez par vous assurer 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:bleu;">`Analyze`</mark> `(1)` → <mark style="color:bleu;">`Conversion tracking`</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;">`Create conversion`</mark> `(3)` → <mark style="color:bleu;">`Conversions API or CSV conversion`</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;">`Conversion tracking`</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" %}
Afin de définir le champ optionnel "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 des conversions amélioré 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 [Enabling 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> , [Field Mappings](#field-mappings) (Voir la propriété <mark style="color:bleu;">`eventId`</mark> ) ou ceci [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>Credentials</code></td><td><em><strong><code>Required if API Token is not provided</code></strong></em><br>Vos credentials avec LinkedIn Campaign Manager tels que définis dans l’interface Commanders Act en suivant : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Add connector credentials</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électionnez <code>Use API Token</code> pour saisir votre <code>API Token</code>. Vous pouvez le trouver dans votre <a href="https://www.linkedin.com/campaignmanager/">Campaign Manager</a> compte en suivant <code>Data</code> → <code>Signals manager</code> → <code>Direct API</code> → <code>Generate access token</code>. Au moins un des éléments suivants est requis : <code>Credentials</code> ou <code>API Token</code>, et ce dernier a priorité sur le premier.</td></tr><tr><td><code>Mapping</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Mappez les règles de conversion LinkedIn avec vos événements en définissant au moins une paire <code>Conversion rule name</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" → "Conversion tracking" dans le menu de gauche.</td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act   | LinkedIn Tracking                |
| --------------------------- | -------------------------------- |
| `[Tout événement]` **\[1]** | `[Any Conversion Rule]` **\[2]** |

{% hint style="info" %}

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

## Mappages des champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l'aide de notre fonctionnalité "Smart Mapping".
{% 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;">`User First Name`</mark> et <mark style="color:bleu;">`User Last Name`</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;">`User Country`</mark> ), vous devez définir les champs <mark style="color:bleu;">`User First Name`</mark> et <mark style="color:bleu;">`User Last Name`</mark> , quelle que soit la présence d’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>LinkedIn Properties</th></tr></thead><tbody><tr><td><code>Conversion rule name</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></td></tr><tr><td><code>currency</code></td><td><code>conversionValue.currencyCode</code></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.\
> \&#xNAN;**\[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.\
> \&#xNAN;**\[2]** L’identifiant unique généré par les annonceurs pour indiquer chaque événement. Ceci 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).\
> \&#xNAN;**\[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> .\
> \&#xNAN;**\[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 [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: 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.