> 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éseautage 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 avec Meta afin de débloquer l’optimisation de leads de qualité.

## Fonctionnalités clés

La destination Facebook Lead Ads offre 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) exploite [é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)Google, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappings prédéfinis**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie la saisie 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 dans la [Planifiez le calendrier de votre projet](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration#plan-your-project-timeline) section via la documentation Meta : voir [**1 : Connexion de votre CRM avec 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 : Prise en main de l'intégration CRM**](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration/crm-integration/2-getting-started-with-integration) pour plus d'informations détaillées. Cette destination couvre [**3 : Mise en œuvre de l'intégration CRM**](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration/crm-integration/3-implementing-the-crm-integration) section dans le [projet](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration#plan-your-project-timeline).\
Avant de continuer, vous voudrez peut-être consulter [Vérifiez si votre entreprise est adaptée](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 bénéfique. De plus, vous devez consulter [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) les sections pour une liste de contrôle des éléments nécessaires et des contraintes actuelles.
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Pixel ID</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant pixel associé à vos événement(s) Conversions API. Vous pouvez récupérer votre identifiant pixel en accédant à la <a href="https://www.facebook.com/events_manager2/">Events Manager</a>.</td></tr><tr><td><code>Jeton d'accès</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vous pouvez générer un jeton d'accès en saisissant <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 ceci comme le nom du CRM/de l'outil d'où proviennent les leads (par ex. « Hubspot », « SAP », « Oracle », « Dynamics », « CRM interne », etc.).</td></tr><tr><td><code>Correspondance</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre correspondance entre les événements 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 cette <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">LINK</a>.</td></tr></tbody></table>

## Référence rapide

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

{% hint style="info" %}
**1.** Voir [Correspondance](#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 [Mappage intelligent](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> ou <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 cette [LINK](https://developers.facebook.com/docs/marketing-api/conversions-api/best-practices/).
{% endhint %}

<table><thead><tr><th width="404.6685580062746">Propriétés Commanders Act</th><th>Propriétés Facebook</th></tr></thead><tbody><tr><td><code>nom de l'événement Facebook</code></td><td><code>event_name</code> <strong>[*][1]</strong></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>event_time</code> <strong>[*][2]</strong></td></tr><tr><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>Lead ID</code></td><td><code>user_data.lead_id</code> <strong>[4]</strong></td></tr><tr><td><code>partners.facebook.fbc</code></td><td><code>user_data.fbc</code> <strong>[5]</strong></td></tr><tr><td><code>user.email</code></td><td><code>user_data.em</code> <strong>[6]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>user_data.ph</code> <strong>[7]</strong></td></tr><tr><td><code>user.id</code></td><td><code>user_data.external_id</code> <strong>[8]</strong></td></tr><tr><td><code>user.firstname</code></td><td><code>user_data.fn</code> <strong>[9]</strong></td></tr><tr><td><code>user.lastname</code></td><td><code>user_data.ln</code> <strong>[9]</strong></td></tr><tr><td><code>user.birthdate</code></td><td><code>user_data.db</code> <strong>[10]</strong></td></tr><tr><td><code>user.gender</code></td><td><code>user_data.ge</code> <strong>[11]</strong></td></tr><tr><td><code>user.city</code></td><td><code>user_data.ct</code> <strong>[12]</strong></td></tr><tr><td><code>user.state_short</code></td><td><code>user_data.st</code> <strong>[13]</strong></td></tr><tr><td><code>user.country</code></td><td><code>user_data.country</code> <strong>[14]</strong></td></tr><tr><td><code>user.zipcode</code></td><td><code>user_data.zp</code> <strong>[15]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>user_data.client_ip_address</code></td></tr><tr><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 [Correspondance](#configuration) pour plus de détails.\
**2.** Si ce champ n'est pas fourni, l'horodatage actuel est utilisé.\
**3.** Définissez ceci comme le nom du CRM/de l'outil d'où proviennent les leads (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 lead généré par Facebook à 15 ou 16 chiffres. Plus de détails sont disponibles en suivant cette [LINK](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 cette [LINK](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc).\
**6.** Adresse e-mail de l'utilisateur en minuscules, sans espaces, et hachée via SHA256. Si elle est transmise en clair, elle est automatiquement hachée.\
**7.** Numéro de téléphone de l'utilisateur : supprimez les symboles, les lettres et 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 numéro <mark style="color:bleu;">`1`</mark> doit précéder un numéro de téléphone aux États-Unis). Incluez toujours l'indicatif du 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 ce champ est transmis en clair, il est automatiquement haché via SHA256.\
**8.** Identifiant unique de l'utilisateur dans son espace, haché via SHA256, par ex. user\_id, loyalty\_id, etc. Si ce champ est transmis en clair, il est automatiquement haché.\
**9.** En minuscules, haché via SHA256. Si ce champ est transmis en clair, il est automatiquement haché.\
**10.** Date de naissance de l'utilisateur indiquée comme <mark style="color:bleu;">`YYYY-MM-DD`</mark> ou <mark style="color:bleu;">`YYYYMMDD`</mark> et hachée via SHA256. Si ce champ est transmis en clair, il est automatiquement haché.\
**11.** Genre de l'utilisateur, en minuscules, haché via SHA256. Si ce champ 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 ce champ 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 la forme [code d'abréviation ANSI à 2 caractères](https://en.wikipedia.org/wiki/Federal_Information_Processing_Standard_state_code), et haché via SHA256. Si ce champ est transmis en clair, il est automatiquement haché.\
**14.** Pays de l'utilisateur sous forme de code à deux caractères [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), et haché via SHA256. Si ce champ 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 utiliser le format area, district et sector pour le Royaume-Uni), et haché via SHA256. Si ce champ 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:

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