Facebook Lead Ads Source

Facebook Lead Ads help you capture contact information from people who have expressed interest in your product. Without leaving Facebook’s interface, your prospects can now share helpful information with you including work email, name, phone number, and more. Learn more about Facebook Lead Ads here.

Segment lets you make the most of your leads by automatically sending them to your business tools like CRM and email. Importantly, these destinations allow you to reach out to customers in real-time using your communication platform of choice, whether you’ve promised them a demo, a newsletter, a piece of content, or a call from a salesperson. Learn more about how you can use Facebook Lead Ads with Segment.

This is an Event Cloud Source which can not only export data into your Segment warehouse, but they can also federate the exported data into your other enabled Segment Destinations.

This source is maintained by Facebook. For any issues with the source, you may contact their team.

NOTE: Facebook Lead Ads is currently in beta and this doc was last updated on January 07, 2019. This means that there may still be some bugs for us to iron out and we’re excited to hear your thoughts. If you are interested in joining or have any feedback to help us improve the Facebook Lead Ads Destination and its documentation, and please let us know!

Getting Started

  1. Set up a Facebook Lead Ad campaign if you haven’t already. Instructions on how to do so are here.
  2. Search for “Facebook Lead Ads” within the Sources Catalog and confirm by clicking “Connect”
  3. Give the source a name. The name is a label used in the Segment interface, and Segment creates a related schema name which you query against in your warehouse. The nickname can be whatever you like, but we recommend sticking to something that reflects the source itself, like Facebook Lead Ads or Facebook Lead Ads Prod.
  4. Click Create And Continue then Connect to OAuth into Facebook.
  5. Select which accounts you would like to sync (you may change this selection later).
  6. Verify that your leads are now flowing into Segment. You can quickly test this connection by sending a test lead to Segment with Facebook’s Lead Ad testing tool.
  7. Click on the Debugger to see a live stream of data coming in from Facebook. You should see your leads come in as Identify calls.

Permissions

Setup Admin permissions are required for setup. Advertiser or lower permissions will prevent the source from connecting.

Use Leads Access Permissions are required to retrieve leads generated by Facebook Lead Ads. This is the default permissions for most roles. Learn more about permissions by following this link.

Components

Stream

Facebook Lead Ads uses our stream Source component to send events to Segment. These events are then available in any destination that accepts server-side events, including your data warehouse.

Events

Below is a table of events that Facebook Lead Ads sends to Segment. These events will show up as tables in your Warehouse, and as regular events in your other destinations.

Event NameDescription
IdentifyWhen a Facebook user clicks on your Lead Ad and fills out your form, Segment will fire an identify call with the user’s Anonymous ID and any other traits from the form.

Event Properties

The event properties included in the identify calls are dependent on the fields included in your Lead Ads form. When the user submits the form, an identify call is made. From the Segment Debugger, you can look at the raw code from the identify call.

See the example below:

{
 "anonymousId":"254875448264245",
 "messageId":"fb_leadads-MND7ItD0c2-254875448264245",
 "timestamp":"2016-12-08T16:39:58.000Z",
 "traits": {
   "adId": 6052204319312,
   "email":"-----------@gmail.com",
   "formId": 225571381194652,
   "First_Name":"------------",
   "Last_Name":"------------",
   "job_title":"warehouse",
   "work_email":"----------@gmail.com"
  },
 "type":"identify",
 "writeKey":"-------------------",
 "context": {
   "integration": {
     "name":"facebook-lead-ads",
     "version":"0.0.3"
    },
   "library": {
     "name":"unknown",
     "version":"unknown"
    }
  },
 "integrations": {},
 "receivedAt":"2016-12-08T16:40:05.490Z",
 "originalTimestamp":"2016-12-08T16:39:58.000Z"
}

Adding Destinations

Now that your Source is set up, you can connect it with destinations.

Only the destinations listed below can be used with Facebook Lead Ads. Facebook only passes an email address as a customer identifier, but not all destinations can use an email address instead of a User ID.

Destinations that can be used with the Facebook Lead Ads Source:

CRM

  • Salesforce
  • Freshsales

Email Marketing

  • Mailchimp
  • Marketo
  • Eloqua
  • AutopilotHQ
  • Mailjet
  • ActiveCampaign
  • Seg
  • Drip
  • Pardot

Live Chat

  • Intercom

Analytics

  • Hubspot
  • Woopra

SMS and Push Notifications

  • Iterable

Customer Success

  • HelpScout
  • Natero
  • Zendesk

Enrichment

  • Clearbit
  • Madkudu

Log into your downstream tools and check that your events are populating, and contain all of the properties you expect. If all your events and properties are not showing up, refer to the Destination docs for troubleshooting.

If there are any issues with how the events are arriving to Segment, please contact the Facebook team.


If you have any questions, or see anywhere we can improve our documentation, please let us know!