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
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
booking_date	booking_date		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
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.	metric
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
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