Facebook is an online social media and social networking service owned by Meta. This destination leverages Conversions API to help you get improved performance in lead ads by sharing your CRM data about your leads back to Meta to unlock quality lead optimization.
The Facebook Lead Ads destination provides the following key features:
Events structure: our Events reference leverages Facebook events, meaning that your data is properly bridged to the expected fields in an optimized way.
Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.
Smart mapping: data mapping can be readjusted using your datalayer defined fields.
Integrating your CRM is required and documented following the Plan Your Project Timeline section via Meta documentation: see 1: Connecting Your CRM With Lead Ads and 2: Getting Started With the CRM Integration for detailed information. This destination covers 3: Implementing the CRM Integration section in the project. Before continuing, you may want to inspect Check If Your Business Is a Good Fit section to see if the optimization model can be beneficial to you. Moreover, you need to review Before you begin and Limitations sections for a checklist of what is needed and current constraints.
Pixel Id
Access Token
Lead Id
Lead Event Source
Required
Set this to the name of the CRM/tool where the leads are coming from (E.g. "Hubspot", "SAP", "Oracle", "Dynamics", "In-house CRM", etc...).
Mapping
[Any Event] [1]
[Any Event] [1]
[1] See Mapping for more details.
Most properties can be remapped using our "Smart Mapping" feature.
Facebook properties are set starting from the path data.0 .
Facebook event name
event_name [*][1]
context.event_timestamp
event_time [*][2]
Lead Id
user_data.lead_id [*]
Lead Event Source
custom_data.lead_event_source [*]
[*] Mandatory property. [1] See Mapping for more details. [2] If this field is not provided, the current timestamp is used.
Required
Your pixel identifier associated with your Conversions API event(s). You can retrieve your pixel identifier by accessing the .
Required
You can generate an access token by entering the , selecting your pixel, and clicking the "Settings" tab. In the "Conversions API" section, you can click the button "Generate access token".
Required
The 15 or 16 digit Facebook generated lead identifier from your . More details are available by following this .
Required
Your mapping between Facebook's events and yours. In Facebook event name , you can set either a or a . At least one entry is required. More details are available by following this .