Facebook Lead Ads: Most-used fields#
The table below gives information about most-used fields that you can import from Facebook Lead Ads. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
DOB Dimension
The prospect's date of birth, which can be a pre-filled demographic question from their Facebook profile.
EMAIL Dimension
The prospect's email address as provided in the Facebook Lead Ad form. This field is part of the lead submission data collected via the 'field_data' object in the Facebook Graph API.
FULL_NAME Dimension
The prospect's full name as submitted through the Facebook Lead Ad form. This field is part of the lead submission data collected via the 'field_data' object in the Facebook Graph API.
PHONE Metric
The prospect's phone number as entered in the Facebook Lead Ad form. This field is part of the lead submission data collected via the 'field_data' object in the Facebook Graph API.
account_fbid Dimension
The unique Facebook ID for the ad account associated with the lead generation campaign. This corresponds to 'ad_account_id' in the Marketing API.
account_name Dimension
The name of the Facebook Ad Account that managed the campaign from which the lead was generated.
ad_id Dimension
The unique identifier of the ad that generated the lead.
ad_name Dimension
The name of the specific ad creative that generated the lead. The corresponding API field is 'ad_id', and this is its descriptive name.
adset_id Dimension
The unique identifier of the ad set (also known as adgroup_id) that generated the lead.
adset_name Dimension
The name of the ad set within the campaign that contained the ad creative responsible for generating the lead. Ad sets are created with a 'name' parameter.
campaign_id Dimension
The unique identifier of the campaign to which the Lead Ad belongs.
campaign_name Dimension
The name of the campaign to which the Lead Ad belongs.
company_name Dimension
The name of the company provided by the prospect when submitting a Facebook Lead Ad form. This data is captured as a custom field within the lead submission.
created_time Dimension
The exact date and time when the lead was submitted, in ISO 8601 format.
date Dimension
The date and time when the lead was created or submitted through the Facebook Lead Ad form.
date_of_birth Dimension
The date of birth provided by the prospect, corresponding to the DOB question type.
email Dimension
The email address of the prospect, as provided in the lead form. This is a custom field collected via the form.
email_address Dimension
The email address provided by the prospect in the lead ad form. This corresponds to the 'email' field within the lead form's field_data.
facebook_lead_id Dimension
A unique identifier assigned by Facebook to each lead submission, corresponding to the FACEBOOK_LEAD_ID question type.
first_name Dimension
The first name of the prospect, corresponding to the FIRST_NAME question type.
follow_up_action_url Dimension
The URL where users are redirected after submitting the Facebook Lead Ad form, allowing for a follow-up action or further engagement.
form_id Dimension
The unique identifier of the Facebook Lead Ad form used to capture the lead.
form_name Dimension
The name of the Facebook Lead Ad form that captured the lead.
full_name Dimension
The full name of the prospect, as provided in the lead form. This is a custom field collected via the form.
id Metric
The unique identifier for the lead submission.
is_organic Dimension
Indicates if the lead was generated from organic reach (1) or paid advertising (0).
last_name Dimension
The last name of the prospect, corresponding to the LAST_NAME question type.
page_id Dimension
The unique identifier of the Facebook Page associated with the Lead Ad form.
page_name Dimension
The name of the Facebook Page on which the lead generation form was published. Lead forms are associated with a Facebook Page ID.
phone Metric
The phone number provided by the prospect, corresponding to the PHONE question type.
phone_number Dimension
The phone number of the prospect, as provided in the lead form. This is a custom field collected via the form.
platform Dimension
The platform from which the lead originated, indicating where the lead ad was displayed and submitted (e.g., Facebook, Instagram).
surname Dimension
The surname (last name) provided by the prospect when completing the Facebook Lead Ad form. This data is part of the 'field_data' array, which contains the submitted form fields as name/value pairs.
work_phone_number Dimension
The prospect's professional phone number, as provided in the Facebook Lead Ad form. This data is collected as a custom field within the form's submitted information.
zip_code Metric
The postal code or ZIP code provided by the prospect, corresponding to the ZIP or POST_CODE question type.