# 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 les données de votre CRM concernant vos leads обратно to Meta afin de débloquer l’optimisation des leads de qualité.

## Key features

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

* **Events structure**: notre [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) exploite [Facebook events](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.
* **Prebuilt mappings**: le mapping des données pour les destinations basées sur les events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Smart mapping**: le mapping 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 dans le [project](https://developers.facebook.com/docs/marketing-api/conversions-api/conversion-leads-integration#plan-your-project-timeline).\
Avant de continuer, vous voudrez peut-être examiner 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 bénéfique. De plus, vous devez consulter les [Before you begin](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 une liste de ce qui est nécessaire et des contraintes actuelles.
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Pixel Id</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre identifiant de pixel associé à vos événement(s) Conversions API. Vous pouvez récupérer votre identifiant de pixel en accédant à la <a href="https://www.facebook.com/events_manager2/">Events Manager</a>.</td></tr><tr><td><code>Access Token</code></td><td><em><strong><code>Requis</code></strong></em><br>Vous pouvez générer un access token en saisissant le <a href="https://www.facebook.com/events_manager2/">Events Manager</a>de 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>Lead Event Source</code></td><td><em><strong><code>Requis</code></strong></em><br>Définissez ce champ sur le nom du CRM/outil d’où proviennent les leads (par exemple "Hubspot", "SAP", "Oracle", "Dynamics", "In-house CRM", etc...).</td></tr><tr><td><code>Mappage</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre correspondance entre les événements Facebook et les vôtres. Dans <code>Facebook event name</code> , vous pouvez définir soit un <a href="https://developers.facebook.com/docs/meta-pixel/implementation/conversion-tracking#standard-events">standard event</a> soit un <a href="https://developers.facebook.com/docs/meta-pixel/implementation/conversion-tracking#custom-events">custom event name</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  | Facebook Events        |
| ---------------------- | ---------------------- |
| `[Any Event]` **\[1]** | `[Any Event]` **\[1]** |

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

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité "Smart Mapping".\
Les propriétés Facebook sont définies à partir du chemin <mark style="color:bleu;">`data.0`</mark> .
{% endhint %}

{% hint style="warning" %}
Meta requiert 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 supplémentaires sur l’utilisateur peut améliorer Event Match Quality. Plus de détails sont disponibles en suivant ce [LIEN](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>Facebook event name</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>Lead Event Source</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.\
> \&#xNAN;**\[1]** Voir [Mappage](#configuration) pour plus de détails.\
> \&#xNAN;**\[2]** Si ce champ n’est pas fourni, l’horodatage actuel est utilisé.\
> \&#xNAN;**\[3]** Définissez ce champ sur le nom du CRM/outil d’où proviennent les leads (par exemple <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;">`In-house CRM`</mark> , etc...).\
> \&#xNAN;**\[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).\
> \&#xNAN;**\[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).\
> \&#xNAN;**\[6]** E-mail de l’utilisateur en minuscules, sans espaces et haché via SHA256. Si ce champ est transmis en texte clair, il est automatiquement haché.\
> \&#xNAN;**\[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 pays pour être utilisés pour la correspondance (par exemple, 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 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 texte clair, il est automatiquement haché via SHA256.\
> \&#xNAN;**\[8]** Identifiant unique de l’utilisateur pour un utilisateur dans son espace, haché via SHA256, par ex. user\_id, loyalty\_id, etc. Si ce champ est transmis en texte clair, il est automatiquement haché.\
> \&#xNAN;**\[9]** En minuscules, haché via SHA256. Si ce champ est transmis en texte clair, il est automatiquement haché.\
> \&#xNAN;**\[10]** Date de naissance de l’utilisateur sous la forme <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 texte clair, il est automatiquement haché.\
> \&#xNAN;**\[11]** Sexe de l’utilisateur, en minuscules, haché via SHA256. Si ce champ est transmis en texte 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> ).\
> \&#xNAN;**\[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 texte clair, il est automatiquement haché.\
> \&#xNAN;**\[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 texte clair, il est automatiquement haché.\
> \&#xNAN;**\[14]** Pays de l’utilisateur sous la forme d’un [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 texte clair, il est automatiquement haché.\
> \&#xNAN;**\[15]** Code postal de l’utilisateur en minuscules, sans espaces, sans tiret (5 chiffres pour les codes postaux américains et utilisez le format area, district et sector pour le Royaume-Uni), et haché via SHA256. Si ce champ est transmis en texte clair, il est automatiquement haché.
> {% endhint %}