Facebook Lead Ads

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.

Key features

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.

Destination setup

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.

Configuration

Settings	Description
Pixel Id	Required Your pixel identifier associated with your Conversions API event(s). You can retrieve your pixel identifier by accessing the Events Manager.
Access Token	Required You can generate an access token by entering the Events Manager, selecting your pixel, and clicking the "Settings" tab. In the "Conversions API" section, you can click the button "Generate access token".
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	Required Your mapping between Facebook's events and yours. In Facebook event name , you can set either a standard event or a custom event name. At least one entry is required. More details are available by following this LINK.

Quick reference

Commanders Act Events	Facebook Events
[Any Event] [1]	[Any Event] [1]

1. See Mapping for more details.

Field mappings

Properties can be remapped using our Smart Mapping feature. Facebook properties are set starting from the path data.0 .

Meta requires at least one property for two of the following four groups: 1. ct , country , st , zp , ge or client_user_agent . 2. db . 3. fn . 4. ln . Sending additional user information may improve Event Match Quality. More details are available following this LINK.

Smart Mapping Fields	Commanders Act Default Properties	Facebook Properties
-	Facebook event name	event_name [*][1]
Event Timestamp	context.event_timestamp	event_time [*][2]
-	Lead Event Source	custom_data.lead_event_source [*][3]
Lead Id	partners.facebook.lead_id	user_data.lead_id [4]
Click Id	partners.facebook.fbc	user_data.fbc [5]
User Email	user.email	user_data.em [6]
User Phone	user.phone	user_data.ph [7]
User Id	user.id	user_data.external_id [8]
User First Name	user.firstname	user_data.fn [9]
User Last Name	user.lastname	user_data.ln [9]
User Birthdate	user.birthdate	user_data.db [10]
User Gender	user.gender	user_data.ge [11]
User City	user.city	user_data.ct [12]
User State	user.state_short	user_data.st [13]
User Country	user.country	user_data.country [14]
User Zipcode	user.zipcode	user_data.zp [15]
Device IP	context.device.ip	user_data.client_ip_address
Device User Agent	context.device.user_agent	user_data.client_user_agent

* Mandatory property. 1. See Mapping for more details. 2. If this field is not provided, the current timestamp is used. 3. 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...). 4. The 15 or 16 digit Facebook generated lead identifier. More details are available following this LINK. 5. The Meta click identifier. More details are available following this LINK. 6. User email in lowercase, without spaces and hashed via SHA256. If this is passed in clear text, it's automatically hashed. 7. User phone number: remove symbols, letters, and any leading zeros. Phone numbers must include a country code to be used for matching (E.g., the number 1 must precede a phone number in the United States). Always include the country code as part of your customers' phone numbers, even if all of your data is from the same country. If this is passed in clear text, it's automatically hashed via SHA256. 8. User unique identifier for a user in their space and hashed via SHA256, e.g. user_id, loyalty_id, etc. If this is passed in clear text, it's automatically hashed. 9. In lowercase, hashed via SHA256. If this is passed in clear text, it's automatically hashed. 10. User birthdate given as YYYY-MM-DD or YYYYMMDD and hashed via SHA256. If this is passed in clear text, it's automatically hashed. 11. User gender, in lowercase, hashed via SHA256. If this is passed in clear text, it's automatically hashed. Accepted values: f (also female ) or m (also male ). 12. User city, in lowercase with no punctuation, no special characters, no spaces, and hashed via SHA256. If this is passed in clear text, it's automatically hashed. 13. User state, in lowercase with no punctuation, no special characters, no spaces, as 2-character ANSI abbreviation code, and hashed via SHA256. If this is passed in clear text, it's automatically hashed. 14. User country as two-character ISO 3166-1 alpha-2, and hashed via SHA256. If this is passed in clear text, it's automatically hashed. 15. User zipcode in lowercase, no spaces, no dash (5 digits for US zip codes and use the area, district, and sector format for the UK), and hashed via SHA256. If this is passed in clear text, it's automatically hashed.