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
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
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
email	email	The email address of the prospect, as provided in the lead form. This is a custom field collected via the form.	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
location	location	The geographical location provided by the prospect as a custom answer in the Facebook Lead Ad form. This data is collected as part of the lead form’s custom fields.	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_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