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.

API name	Adverity UI name	Description	Use in Adverity
access_requested_time	access_requested_time	The timestamp when an agency’s access to the ad account was requested.	dimension
access_status	access_status	The current status of an agency’s access request to the ad account (e.g., pending, approved).	dimension
access_updated_time	access_updated_time	The timestamp when an agency’s access request to the ad account was last updated.	dimension
account_id	account_id	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.	dimension
account_status	account_status	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.	dimension
ad_account_id	ad_account_id	The unique identifier for the Facebook Ad Account from which data is collected.	dimension
ad_account_name	ad_account_name	The human-readable name of the Facebook Ad Account.	dimension
business_id	business_id	The unique identifier for a specific business on Facebook.	dimension
business_name	business_name	The name of the business.	dimension
created_time_date	created_time_date	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.	dimension
currency	currency	The ISO 4217 currency code used for the ad account, impacting financial reporting and transactions.	dimension
id	id	The unique identifier of either a user assigned to the ad account or an agency associated with it.	dimension
name	name	The name of the object, which can be an assigned user or an agency/business.	dimension
permitted_tasks	permitted_tasks	A list of tasks or permissions that are assignable to a user on an ad account, or associated with an agency’s access request.	dimension
tasks	tasks	A list of all roles or tasks currently assigned to a specific user on the ad account.	dimension
timezone_name	timezone_name	The name of the timezone configured for the ad account, influencing data reporting, scheduling, and insights.	dimension