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 |
The date and time selected by the prospect for an appointment or booking via the lead form. |
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 |
city |
city |
The city provided by the prospect in the lead form. This is a custom field collected via the form. |
dimension |
company_name |
company_name |
The name of the prospect’s company, as provided in the lead form. This is a custom field collected via the form. |
dimension |
company_size |
company_size |
The size of the prospect’s company, as provided in the lead form. This is a custom field collected via the form. |
dimension |
country |
country |
The country of the prospect, as provided in the lead form. This is a custom field collected via the form. |
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 |
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 |
The unique identifier for the lead submission, as assigned by Facebook. |
dimension |
first_name |
first_name |
The first name 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 |
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 |
gender |
gender |
The gender 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 |
job_title |
job_title |
The job title of the prospect, as provided in the lead form. This is a custom field collected via the form. |
dimension |
last_name |
last_name |
The last name of the prospect, as provided in the lead form. This is a custom field collected via the form. |
dimension |
name |
name |
For custom fields within ‘field_data’, this represents the name of the custom question or field. |
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 of the prospect, as provided in the lead form. This is a custom field collected via the form. |
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 |
dimension |
|
post_code |
post_code |
The postal code of the prospect, as provided in the lead form. This is a custom field collected via the form. |
dimension |
state |
state |
The state or province of the prospect, as provided in the lead form. This is a custom field collected via the form. |
dimension |
street_address |
street_address |
The street address of the prospect, as provided in the lead form. This is a custom field collected via the form. |
dimension |
value |
value |
For custom fields within ‘field_data’, this represents the value(s) provided by the prospect for the corresponding custom field. |
dimension |
work_email |
work_email |
The work email address of the prospect, as provided in the lead form. This is a custom field collected via the form. |
dimension |
work_phone_number |
work_phone_number |
The work phone number of the prospect, as provided in the lead form. This is a custom field collected via the form. |
metric |
zip_code |
zip_code |
The ZIP code of the prospect, as provided in the lead form. This is a custom field collected via the form. |
metric |