> 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/facebook/facebook-lead-ads.md).

# Facebook Lead Ads

[Facebook ](https://www.facebook.com/)est un service de médias sociaux et de réseau social en ligne détenu par [Meta](https://www.meta.com/).\
Cette destination exploite [Conversions API](https://developers.facebook.com/docs/marketing-api/guides/lead-ads/v2.3/#conversions-api-integration) pour vous aider à obtenir de meilleures performances dans [lead ads](https://developers.facebook.com/docs/marketing-api/guides/lead-ads/v2.3/) en partageant vos données CRM sur vos leads à Meta afin de débloquer l’optimisation de lead de qualité.

## Fonctionnalités clés

La destination Facebook Lead Ads fournit les fonctionnalités clés suivantes :

* **Structure des événements**: notre [référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) s’appuie sur [événements Facebook](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration/crm-integration/3-implementing-the-crm-integration#step-1--build-a-payload), 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.
* **Mappage intelligent**: le mappage des données peut être réajusté à l’aide des champs définis dans votre datalayer.

## Configuration de la destination

{% hint style="warning" %}
L’intégration de votre CRM est requise et documentée en suivant la [Plan Your Project Timeline](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration#plan-your-project-timeline) section via la documentation Meta : voir [**1: Connecting Your CRM With Lead Ads**](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration/crm-integration/1-connecting-your-crm-with-lead-ads) et [**2: Getting Started With the CRM Integration**](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration/crm-integration/2-getting-started-with-integration) pour des informations détaillées. Cette destination couvre la [**3: Implementing the CRM Integration**](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration/crm-integration/3-implementing-the-crm-integration) section du [projet](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration#plan-your-project-timeline).\
Avant de continuer, vous pouvez consulter la [Check If Your Business Is a Good Fit](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration#check-if-your-business-is-a-good-fit) section pour voir si le modèle d’optimisation peut vous être utile. De plus, vous devez consulter les [Avant de commencer](https://developers.facebook.com/docs/marketing-api/guides/lead-ads/v2.3/#before-you-begin) et [Limitations](https://developers.facebook.com/docs/marketing-api/guides/lead-ads/v2.3/#limitations) sections pour obtenir la liste des éléments requis et des contraintes actuelles.
{% endhint %}

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>ID de pixel</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant de pixel associé à vos événements Conversions API. Vous pouvez récupérer votre identifiant de pixel en accédant à <a href="https://www.facebook.com/events_manager2/">Events Manager</a>.</td></tr><tr><td><code>Access Token</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vous pouvez générer un access token en accédant au <a href="https://www.facebook.com/events_manager2/">Events Manager</a>, en sélectionnant votre pixel, puis en cliquant sur l’onglet "Settings". Dans la section "Conversions API", vous pouvez cliquer sur le bouton "Generate access token".</td></tr><tr><td><code>Source de l’événement lead</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Définissez cette valeur sur le nom du CRM/outil d’où proviennent les lead (par ex. "Hubspot", "SAP", "Oracle", "Dynamics", "CRM interne", etc.).</td></tr><tr><td><code>Mappage</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre mappage entre les events de Facebook et les vôtres. Dans <code>nom de l’événement Facebook</code> , vous pouvez définir soit un <a href="https://developers.facebook.com/docs/meta-pixel/implementation/conversion-tracking#standard-events">événement standard</a> ou un <a href="https://developers.facebook.com/docs/meta-pixel/implementation/conversion-tracking#custom-events">nom d’événement personnalisé</a>. Au moins une entrée est requise. Plus de détails sont disponibles en suivant ce <a href="https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration/crm-integration/3-implementing-the-crm-integration#step-1--build-a-payload">LIEN</a>.</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events       | événements Facebook         |
| --------------------------- | --------------------------- |
| `[Tout événement]` **\[1]** | `[Tout événement]` **\[1]** |

{% hint style="info" %}
**1.** Voir [Mappage](#configuration) pour plus de détails.
{% endhint %}

## Mappages des 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é.\
Les propriétés Facebook sont définies à partir du chemin <mark style="color:bleu;">`data.0`</mark> .
{% endhint %}

{% hint style="warning" %}
Meta exige au moins une propriété pour deux des quatre groupes suivants :\
1\. <mark style="color:bleu;">`ct`</mark> , <mark style="color:bleu;">`country`</mark> , <mark style="color:bleu;">`st`</mark> , <mark style="color:bleu;">`zp`</mark> , <mark style="color:bleu;">`ge`</mark> or <mark style="color:bleu;">`client_user_agent`</mark> .\
2\. <mark style="color:bleu;">`db`</mark> .\
3\. <mark style="color:bleu;">`fn`</mark> .\
4\. <mark style="color:bleu;">`ln`</mark> .\
L’envoi d’informations utilisateur supplémentaires peut améliorer la qualité de correspondance des événements. Plus de détails sont disponibles en suivant ce [LIEN](https://developers.facebook.com/docs/marketing-api/conversions-api/best-practices/).
{% 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 Facebook</th></tr></thead><tbody><tr><td><code>-</code></td><td><code>nom de l’événement Facebook</code></td><td><code>event_name</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>event_time</code> <strong>[*][2]</strong></td></tr><tr><td><code>-</code></td><td><code>Source de l’événement lead</code></td><td><code>custom_data.lead_event_source</code> <strong>[*][3]</strong></td></tr><tr><td><code>ID du lead</code></td><td><code>partners.facebook.lead_id</code></td><td><code>user_data.lead_id</code> <strong>[4]</strong></td></tr><tr><td><code>ID du clic</code></td><td><code>partners.facebook.fbc</code></td><td><code>user_data.fbc</code> <strong>[5]</strong></td></tr><tr><td><code>E-mail de l’utilisateur</code></td><td><code>user.email</code></td><td><code>user_data.em</code> <strong>[6]</strong></td></tr><tr><td><code>Téléphone de l’utilisateur</code></td><td><code>user.phone</code></td><td><code>user_data.ph</code> <strong>[7]</strong></td></tr><tr><td><code>ID de l’utilisateur</code></td><td><code>user.id</code></td><td><code>user_data.external_id</code> <strong>[8]</strong></td></tr><tr><td><code>Prénom de l’utilisateur</code></td><td><code>user.firstname</code></td><td><code>user_data.fn</code> <strong>[9]</strong></td></tr><tr><td><code>Nom de famille de l’utilisateur</code></td><td><code>user.lastname</code></td><td><code>user_data.ln</code> <strong>[9]</strong></td></tr><tr><td><code>Date de naissance de l’utilisateur</code></td><td><code>user.birthdate</code></td><td><code>user_data.db</code> <strong>[10]</strong></td></tr><tr><td><code>Genre de l’utilisateur</code></td><td><code>user.gender</code></td><td><code>user_data.ge</code> <strong>[11]</strong></td></tr><tr><td><code>Ville de l’utilisateur</code></td><td><code>user.city</code></td><td><code>user_data.ct</code> <strong>[12]</strong></td></tr><tr><td><code>État de l’utilisateur</code></td><td><code>user.state_short</code></td><td><code>user_data.st</code> <strong>[13]</strong></td></tr><tr><td><code>Pays de l’utilisateur</code></td><td><code>user.country</code></td><td><code>user_data.country</code> <strong>[14]</strong></td></tr><tr><td><code>Code postal de l’utilisateur</code></td><td><code>user.zipcode</code></td><td><code>user_data.zp</code> <strong>[15]</strong></td></tr><tr><td><code>IP de l’appareil</code></td><td><code>context.device.ip</code></td><td><code>user_data.client_ip_address</code></td></tr><tr><td><code>User Agent de l’appareil</code></td><td><code>context.device.user_agent</code></td><td><code>user_data.client_user_agent</code></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Voir [Mappage](#configuration) pour plus de détails.\
**2.** Si ce champ n’est pas fourni, l’horodatage actuel est utilisé.\
**3.** Définissez cette valeur sur le nom du CRM/outil d’où proviennent les lead (par ex. <mark style="color:bleu;">`Hubspot`</mark> , <mark style="color:bleu;">`SAP`</mark> , <mark style="color:bleu;">`Oracle`</mark> , <mark style="color:bleu;">`Dynamics`</mark> , <mark style="color:bleu;">`CRM interne`</mark> , etc.).\
**4.** L’identifiant de lead généré par Facebook à 15 ou 16 chiffres. Plus de détails sont disponibles en suivant ce [LIEN](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration/how-to-find-the-lead-id).\
**5.** L’identifiant de clic Meta. Plus de détails sont disponibles en suivant ce [LIEN](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc).\
**6.** E-mail de l’utilisateur en minuscules, sans espaces et haché via SHA256. Si cela est transmis en clair, il est automatiquement haché.\
**7.** Numéro de téléphone de l’utilisateur : supprimez les symboles, les lettres et tous les zéros initiaux. Les numéros de téléphone doivent inclure un indicatif de pays pour être utilisés pour la correspondance (par ex., le nombre <mark style="color:bleu;">`1`</mark> doit précéder un numéro de téléphone aux États-Unis). Incluez toujours l’indicatif de pays dans les numéros de téléphone de vos clients, même si toutes vos données proviennent du même pays. Si cela est transmis en clair, il est automatiquement haché via SHA256.\
**8.** Identifiant unique de l’utilisateur pour un utilisateur dans son espace et haché via SHA256, par ex. user\_id, loyalty\_id, etc. Si cela est transmis en clair, il est automatiquement haché.\
**9.** En minuscules, haché via SHA256. Si cela est transmis en clair, il est automatiquement haché.\
**10.** Date de naissance de l’utilisateur fournie sous la forme <mark style="color:bleu;">`YYYY-MM-DD`</mark> or <mark style="color:bleu;">`YYYYMMDD`</mark> et hachée via SHA256. Si cela est transmis en clair, il est automatiquement haché.\
**11.** Genre de l’utilisateur, en minuscules, haché via SHA256. Si cela est transmis en clair, il est automatiquement haché. Valeurs acceptées : <mark style="color:bleu;">`f`</mark> (également <mark style="color:bleu;">`female`</mark> ) ou <mark style="color:bleu;">`m`</mark> (également <mark style="color:bleu;">`male`</mark> ).\
**12.** Ville de l’utilisateur, en minuscules sans ponctuation, sans caractères spéciaux, sans espaces, et hachée via SHA256. Si cela est transmis en clair, il est automatiquement haché.\
**13.** État de l’utilisateur, en minuscules sans ponctuation, sans caractères spéciaux, sans espaces, sous forme de [code d’abréviation ANSI à 2 caractères](https://en.wikipedia.org/wiki/Federal_Information_Processing_Standard_state_code), et haché via SHA256. Si cela est transmis en clair, il est automatiquement haché.\
**14.** Pays de l’utilisateur sous forme de [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), et haché via SHA256. Si cela est transmis en clair, il est automatiquement haché.\
**15.** Code postal de l’utilisateur en minuscules, sans espaces, sans tiret (5 chiffres pour les codes postaux américains et utilisez le format zone, district et secteur pour le Royaume-Uni), et haché via SHA256. Si cela est transmis en clair, il est automatiquement haché.
{% 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/facebook/facebook-lead-ads.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.