ChatGPT Ads: Most-used fields

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

API name	Adverity UI name	Description	Use in Adverity
Date	Date	The date when the ad performance data was recorded, based on the selected time granularity for reporting. This field represents a specific day in the reporting period.	dimension
ad.created_at	ad.created_at	The Unix timestamp indicating when the ad was created in the system.	dimension
ad.creative.body	ad.creative.body	The main text content or body of the ad creative.	dimension
ad.creative.file_id	ad.creative.file_id	The unique identifier for the creative asset file associated with the ad, such as an image or video.	dimension
ad.creative.target_url	ad.creative.target_url	The URL where users are directed when they click on the ad creative.	dimension
ad.creative.title	ad.creative.title	The title displayed as part of the ad creative.	dimension
ad.creative.type	ad.creative.type	The type of ad creative, such as image, video, or text.	dimension
ad.id	ad.id	The unique identifier for the ad within the ad account.	dimension
ad.landing_page_configuration	ad.landing_page_configuration	Configuration details for the landing page associated with the ad, which may include settings for deep linking or specific destination behaviors.	dimension
ad.name	ad.name	The user-defined name of the ad.	dimension
ad.review.status	ad.review.status	The current review status of the ad, indicating whether it has been approved, rejected, or is pending review.	dimension
ad.review_status	ad.review_status	The current review status of the ad, indicating whether it has been approved, rejected, or is pending review.	dimension
ad.status	ad.status	The current operational status of the ad, such as enabled, paused, or archived.	dimension
ad.updated_at	ad.updated_at	The Unix timestamp indicating when the ad was last updated.	dimension
ad_account_id	ad_account_id	The unique identifier for the ad account.	dimension
ad_account_name	ad_account_name	The user-defined name of the ad account.	dimension
ad_group.id	ad_group.id	The unique identifier for the ad group.	dimension
ad_group_id	ad_group_id	The unique identifier for the ad group.	dimension
ad_group_name	ad_group_name	The user-defined name of the ad group.	dimension
ad_id	ad_id	The unique identifier for the ad within the ad account.	dimension
ad_name	ad_name	The user-defined name of the ad.	dimension
campaign.id	campaign.id	The unique identifier for the campaign.	dimension
campaign_id	campaign_id	The unique identifier for the campaign.	dimension
campaign_name	campaign_name	The user-defined name of the campaign.	dimension
clicks	clicks	The total number of clicks on the ad during the reporting period.	metric
end_time	end_time	The end of the reporting period for which insights data is collected, typically represented as a Unix timestamp.	dimension
id	id	A generic unique identifier. Its specific context depends on the aggregation level of the report (e.g., campaign ID, ad group ID, or ad ID).	dimension
impressions	impressions	The total number of times the ad was displayed during the reporting period.	metric
readable_time	readable_time	A human-readable representation of the time or date for reporting purposes.	dimension
spend	spend	The total amount of money spent on the ad during the reporting period, typically provided in micros.	metric
start_time	start_time	The start of the reporting period for which insights data is collected, typically represented as a Unix timestamp.	dimension