Facebook Audiences: Most-used fields#
The table below gives information about most-used fields that you can import from Facebook Audiences. 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.
account_id Metric
The unique identifier for the ad account associated with the audience.
account_name Dimension
The name of the Facebook Ad Account or Business Account associated with the audience.
approximate_count_lower_bound Dimension
The estimated lower bound of the number of people in the audience.
approximate_count_upper_bound Dimension
The upper bound of the approximate number of people in this audience. Returns -1 for inactive lookalike audiences.
audience_type Dimension
A classification indicating whether the audience is a 'Custom Audience' or a 'Saved Audience', added by the data integration platform for differentiation.
data_source.sub_type Dimension
The specific method or source from which the custom audience was created, such as 'CUSTOMER_FILE' for customer lists or 'WEBSITE' for website visitors. Some subtypes are only creatable via Ads Manager.
data_source.type Dimension
The general category of the data source used to create the audience, derived from the original data source.
description Dimension
A descriptive text provided by the user for the audience, often used to explain its purpose or criteria.
external_event_source.id Dimension
The unique identifier of the Facebook Pixel or other event source whose traffic generated the custom audience.
id Metric
The unique identifier for the audience.
is_value_based Dimension
Indicates whether the custom audience is a value-based audience, which includes an arbitrary numeric value for each user to determine their worth.
lookalike_audience_ids Dimension
A list of unique identifiers for lookalike audiences that were generated from this custom audience.
lookalike_spec Dimension
A JSON object defining the specifications for a Lookalike Audience, including parameters like type (e.g., 'reach'), ratio (audience size percentage), and location targeting.
name Dimension
The name of the audience, used for identification and display.
pixel_id Dimension
The ID of the Facebook Pixel whose traffic contributed to generating this website custom audience.
report_date Dimension
The date when the audience metadata and metrics were reported by the data integration platform, as historical date ranges are not supported by the API for audience metrics.
retention_days Metric
The number of days to retain a user in the custom audience. This value can range from 1 to 180 days. If not specified, the audience members are retained indefinitely. This field is primarily available for Customer File Custom Audiences.
rule Dimension
A JSON object defining the rules applied to create or filter the audience, especially for website custom audiences, product audiences, or video remarketing audiences.
subtype Dimension
The specific subtype of the audience, such as 'CUSTOM' for custom audiences or 'LOOKALIKE' for lookalike audiences.
time_content_updated Dimension
The timestamp indicating the last time the audience's content, such as the list of included people, was updated. This field is primarily supported for Customer List Custom Audiences.
time_created Dimension
The timestamp indicating when the audience was created.
time_updated Dimension
The timestamp indicating when the audience object was last updated or modified.