Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Facebook Metadata: Most-used fields

The table below gives information about most-used fields that you can import from Facebook Metadata. 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
access_requested_timeDimension

The timestamp indicating when access to an asset was initially requested.

access_statusDimension

Indicates the current status of an access request to an asset (e.g., ad account or page), which can be 'CONFIRMED' for approved access or 'PENDING' if a review is required.

access_updated_timeDimension

The timestamp indicating when an access-related record was last updated. For example, in the Graph API, this field is used to show the update time for page agencies.

account_idDimension

The unique identifier for a Facebook Ad Account. This ID is used to retrieve metadata related to the specific ad account, such as assigned users or agency relationships.

account_statusDimension

The current status of the Facebook ad account. This indicates whether the account is active, disabled, or in various other states such as pending review or closure.

ad_account_idDimension

A unique identifier for an ad account. This ID is used to retrieve data related to a specific ad account, such as assigned users or agency relationships.

ad_account_nameDimension

The user-defined name of the Facebook Ad Account.

amount_spentMetric

The estimated total amount of money spent on a campaign, ad set, or individual ad during its scheduled run. This metric provides insights into advertising expenditures.

business_idDimension

The unique identifier for a specific business on Facebook.

business_nameDimension

The name of the business.

created_time_dateDimension

The date and time when an entity, such as an access request or another record, was initially created within the Facebook platform. This field is used for historical tracking and filtering.

currencyDimension

The ISO 4217 currency code used for the ad account, impacting financial reporting and transactions.

idDimension

The unique identifier for the object, such as an assigned user, agency, ad account, or product catalog.

nameDimension

The name of the object, which can be an assigned user or an agency/business.

permitted_tasksDimension

A list of tasks or roles that a user or agency is allowed to perform on a specific asset (e.g., ad account, page, or pixel), such as 'ADVERTISE' or 'ANALYZE'.

spend_capMetric

The total amount that an ad account can spend, after which all associated campaigns will be paused. A value of 0 indicates no spending cap. Setting a new spend cap only applies to spending incurred after the update time.

tasksDimension

A list of all roles and responsibilities that a user currently holds on a given object, such as an ad account or business asset.

timezone_nameDimension

The name of the timezone configured for the ad account, influencing data reporting, scheduling, and insights.