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_idDimension
The unique identifier for the ad account associated with the audience.
account_nameDimension
The name of the Facebook Ad Account or Business Account associated with the audience.
approximate_count_lower_boundMetric
The estimated lower bound of the number of people in the audience.
approximate_count_upper_boundMetric
The upper bound of the approximate number of people in this audience. Returns -1 for inactive lookalike audiences.
audience_typeDimension
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_typeDimension
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.typeDimension
The general category of the data source used to create the audience, derived from the original data source.
descriptionDimension
A descriptive text provided by the user for the audience, often used to explain its purpose or criteria.
external_event_source.idDimension
The unique identifier of the Facebook Pixel or other event source whose traffic generated the custom audience.
idMetric
The unique identifier for the audience.
is_value_basedDimension
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_idsDimension
A list of unique identifiers for lookalike audiences that were generated from this custom audience.
lookalike_specDimension
A JSON object defining the specifications for a Lookalike Audience, including parameters like type (e.g., 'reach'), ratio (audience size percentage), and location targeting.
nameDimension
The name of the audience, used for identification and display.
pixel_idDimension
The ID of the Facebook Pixel whose traffic contributed to generating this website custom audience.
report_dateDimension
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_daysMetric
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.
ruleDimension
A JSON object defining the rules applied to create or filter the audience, especially for website custom audiences, product audiences, or video remarketing audiences.
subtypeDimension
The specific subtype of the audience, such as 'CUSTOM' for custom audiences or 'LOOKALIKE' for lookalike audiences.
time_content_updatedDimension
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_createdDimension
The timestamp indicating when the audience was created.
time_updatedDimension
The timestamp indicating when the audience object was last updated or modified.