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.

API name	Adverity UI name	Description	Use in Adverity
DOB	DOB	The prospect’s date of birth, which can be a pre-filled demographic question from their Facebook profile.	dimension
EMAIL	EMAIL	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.	dimension
FULL_NAME	FULL_NAME	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.	dimension
PHONE	PHONE	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.	metric
account_fbid	account_fbid	The unique Facebook ID for the ad account associated with the lead generation campaign. This corresponds to ‘ad_account_id’ in the Marketing API.	dimension
account_name	account_name	The name of the Facebook Ad Account that managed the campaign from which the lead was generated.	dimension
ad_id	ad_id	The unique identifier of the ad that generated the lead.	dimension
ad_name	ad_name	The name of the specific ad creative that generated the lead. The corresponding API field is ‘ad_id’, and this is its descriptive name.	dimension
adset_id	adset_id	The unique identifier of the ad set (also known as adgroup_id) that generated the lead.	dimension
adset_name	adset_name	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.	dimension
campaign_id	campaign_id	The unique identifier of the campaign to which the Lead Ad belongs.	dimension
campaign_name	campaign_name	The name of the campaign to which the Lead Ad belongs.	dimension
company_name	company_name	The name of the company the prospect is associated with, as submitted through the Facebook Lead Ad form. This information is captured as a custom field.	dimension
created_time	created_time	The exact date and time when the lead was submitted, in ISO 8601 format.	dimension
date	date	The date and time when the lead was created or submitted through the Facebook Lead Ad form.	dimension
date_of_birth	date_of_birth	The date of birth provided by the prospect, corresponding to the DOB question type.	dimension
email	email	The email address of the prospect, as provided in the lead form. This is a custom field collected via the form.	dimension
facebook_lead_id	facebook_lead_id	A unique identifier assigned by Facebook to each lead submission, corresponding to the FACEBOOK_LEAD_ID question type.	dimension
first_name	first_name	The first name of the prospect, corresponding to the FIRST_NAME question type.	dimension
form_id	form_id	The unique identifier of the Facebook Lead Ad form used to capture the lead.	dimension
form_name	form_name	The name of the Facebook Lead Ad form that captured the lead.	dimension
full_name	full_name	The full name of the prospect, as provided in the lead form. This is a custom field collected via the form.	dimension
id	id	The unique identifier for the lead submission.	dimension
is_organic	is_organic	Indicates if the lead was generated from organic reach (1) or paid advertising (0).	dimension
last_name	last_name	The last name of the prospect, corresponding to the LAST_NAME question type.	dimension
location	location	This field captures location information provided by the prospect through a Facebook Lead Ad form. It typically corresponds to a custom field within the form, such as a ‘store locator’ question, where the prospect selects or inputs a specific location or store number.	dimension
name	name	The API field name for a specific data point collected from the lead form, such as ‘email’, ‘phone’, or a custom question identifier, as part of the field_data object.	dimension
page_id	page_id	The unique identifier of the Facebook Page associated with the Lead Ad form.	dimension
page_name	page_name	The name of the Facebook Page on which the lead generation form was published. Lead forms are associated with a Facebook Page ID.	dimension
phone	phone	The phone number provided by the prospect, corresponding to the PHONE question type.	metric
phone_number	phone_number	The phone number of the prospect, as provided in the lead form. This is a custom field collected via the form.	dimension
platform	platform	The platform from which the lead originated, indicating where the lead ad was displayed and submitted (e.g., Facebook, Instagram).	dimension
value	value	The data submitted by the prospect for a specific API field (‘name’) within the lead form, as part of the field_data object.	metric
what_is_your_age?	what_is_your_age?	The prospect’s answer to the custom question ‘what is your age?’, collected through the lead form.	dimension
what_is_your_height?	what_is_your_height?	The prospect’s answer to the custom question ‘what is your height?’, collected through the lead form.	dimension
what_is_your_weight?	what_is_your_weight?	The prospect’s answer to the custom question ‘what is your weight?’, collected through the lead form.	dimension
work_phone_number	work_phone_number	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.	dimension
zip_code	zip_code	The postal code or ZIP code provided by the prospect, corresponding to the ZIP or POST_CODE question type.	metric