Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
DOBDimension

The prospect's date of birth, which can be a pre-filled demographic question from their Facebook profile.

EMAILDimension

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_NAMEDimension

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.

PHONEMetric

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_fbidDimension

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_nameDimension

The name of the Facebook Ad Account that managed the campaign from which the lead was generated.

ad_idDimension

The unique identifier of the ad that generated the lead.

ad_nameDimension

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_idDimension

The unique identifier of the ad set (also known as adgroup_id) that generated the lead.

adset_nameDimension

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_idDimension

The unique identifier of the campaign to which the Lead Ad belongs.

campaign_nameDimension

The name of the campaign to which the Lead Ad belongs.

created_timeDimension

The exact date and time when the lead was submitted, in ISO 8601 format.

dateDimension

The date and time when the lead was created or submitted through the Facebook Lead Ad form.

emailDimension

The email address of the prospect, as provided in the lead form. This is a custom field collected via the form.

follow_up_action_urlDimension

The URL where users are redirected after submitting the Facebook Lead Ad form, allowing for a follow-up action or further engagement.

form_idDimension

The unique identifier of the Facebook Lead Ad form used to capture the lead.

form_nameDimension

The name of the Facebook Lead Ad form that captured the lead.

full_nameDimension

The full name of the prospect, as provided in the lead form. This is a custom field collected via the form.

idMetric

The unique identifier for the lead submission.

is_organicDimension

Indicates if the lead was generated from organic reach (1) or paid advertising (0).

page_idDimension

The unique identifier of the Facebook Page associated with the Lead Ad form.

page_nameDimension

The name of the Facebook Page on which the lead generation form was published. Lead forms are associated with a Facebook Page ID.

phone_numberDimension

The phone number of the prospect, as provided in the lead form. This is a custom field collected via the form.

platformDimension

The platform from which the lead originated, indicating where the lead ad was displayed and submitted (e.g., Facebook, Instagram).