Tealium + Facebook Lead Ads Guide | Technology Partners |Tealium Docs

Prerequisites

Tealium EventStream API Hub and/or Tealium AudienceStream CDP
LeadsBridge or Zapier account
Facebook Business Manager - Lead Access
For more information, see Configure Real Time Lead Access.

How it works

Facebook Lead ads are a type of lead generation ads that collects the user’s information from within the ad without redirecting the user to a landing page. Facebook Lead ads collect the user’s information through forms within the ad, which makes the collection process faster and more convenient for the user. You can use the collected information for follow-up activities such as email marketing or direct sales outreach.

To pass customer information from Facebook Lead ads to Tealium EventStream or AudienceStream, you will need to use a LeadsBridge or Zapier webhook. This document describes how to set up a LeadsBridge webhook, but you can also use a Zapier webhook with a similar configuration.

Ensure that you include the tealium_account, tealium_profile, tealium_datasource, and the Lead ID values from your Facebook Lead ad in your webhook coniguration.

Add a Facebook Leads data source

To add the Facebook Leads data source to your Tealium Customer Data Hub profile, follow the instructions in Create a data source.
After you create your Facebook Leads data source, follow the instructions in Connect to your data source to locate your Data Source Key and your Data Source URL.
After adding and connecting the data source, save and publish your profile.

Data source URL

Adding the Facebook Leads data source to your Tealium Customer Data Hub profile generates a unique URL to use in your Facebook Lead ads configuration in following format:

https://collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY

Configure Facebook Leads using the Facebook Business Manager

Log into your Facebook account and navigate to Business Manager and Select Instant Forms.
Select the form you want to use to send data to Tealium.
Select CRM Setup and search for Webhook.
Setup the webhook to use your integration URL and LeadsBridge.
Complete the steps listed in Connect Your CRM System to Facebook, in the Facebook documentation.

Integrate your LeadsBridge webhook with Facebook Lead Ads

Configure your Facebook Lead ad.
In your LeadsBridge account, navigate to Facebook Suite > Lead Ads Bridges from the main menu.
Click +Create new Bridge.
Under Select source, search for Facebook Lead Ads and select the source from the drop down list.
Under Select destination, search for Webhook and select the destination from the drop down list.
LeadsBridge will prompt you to use an advanced editor. Click Take me to a complex bridge.
In the Facebook Lead Ads Let’s Start screen, configure the following settings. When you are done, click Next.
- Bridge’s name - Enter a name for the bridge.
- Select source - Leave Facebook Lead Ads as the selection for the source.
- Select destination - Enter Webhooks and select Create New Destination from the webhooks drop down list.
In the Source screen, configure the following fields. When you are done, click Next.
- User - Select your user. You may be required to use the +Connect with Facebook option to authenticate.
- Facebook Page - Select the Facebook Page from the drop down list. You may be required to authorize your Facebook account.
- Facebook Form - Select the Facebook Form from drop down list. You may be required to authorize your Facebook account.
In the Destination > Configure you destination integration screen, configure the following fields. When you are done, click Next.
- Integration’s Name - Enter a name for the integration.
- Method - Select POST.
- URL - Enter your Tealium data source URL.
- Access Secret - Leave blank.
- Timeout (seconds) - Enter a timeout, in seconds, for the webhook. We recommend 30 seconds.
- Custom Fields - Enter the following fields: tealium_account, tealium_profile, tealium_datasource, and any other fields from your Facebook Leads ads submission, such as lead_id, email, and tealium_event.
In the Destination > Choose where you want to send the incoming lead screen, configure the following settings. When you are done, click Next.
- Destination and Which Action fields will be completed with the information from the previous screen.
- (Optional) If you want to receive an email receipt for each lead, enable the Active? option. Enter email addresses in the Receivers field and an email subject in the Subject field.
In the Fields Mapping screen, select the values required to trigger data to Tealium from the drop down lists. Additionally, configure the following mapping fields: tealium_account, tealium_profile, and tealium_datasource.
Click Next.
(Optional) In the Test screen, enter values for your the fields you specified and click Test Now.
You can also test your configuration using the Facebook Lead Ads testing tool.
Accept the LeadsBridge access permissions and click Save & Publish.

Events and attributes

All incoming Facebook Leads event attributes are automatically prefixed with fblead_. For example, when Currents sends id, the matching EventStream event attribute is fblead_id (all lowercase).

Key	Type	Example
’tealium_account'	String	`sbx-facebook`
`tealium_profile`	String	`main`
`tealium_datasource`	String	`r9zxm1`
`tealium_event`	String	`facebook_add_event`
`tealium_visitor_id`	String	`cb7425dd8b1742c68851b049f22a0154`
`fblead_email`	String	`facebook@fb.com`
`fblead_full_name`	String	`Bob White`
`fblead_address`	String	`25 First Street`
`fblead_other_field`	String	`Other fields`