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.
Date Dimension
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.
ad.created_at Dimension
The Unix timestamp indicating when the ad was created in the system.
ad.creative.body Dimension
The main text content or body of the ad creative.
ad.creative.file_id Dimension
The unique identifier for the creative asset file associated with the ad, such as an image or video.
ad.creative.image_crop.height Metric
Height of the image crop for the ad creative.
ad.creative.image_crop.width Metric
Width of the image crop for the ad creative.
ad.creative.image_crop.x Metric
X-coordinate of the top-left corner of the image crop for the ad creative.
ad.creative.image_crop.y Metric
Y-coordinate of the top-left corner of the image crop for the ad creative.
ad.creative.price Dimension
The price associated with the ad's creative asset.
ad.creative.target_url Dimension
The URL where users are directed when they click on the ad creative.
ad.creative.title Dimension
The title displayed as part of the ad creative.
ad.creative.type Dimension
The type of ad creative, such as image, video, or text.
ad.id Dimension
The unique identifier for the ad within the ad account.
ad.landing_page_configuration Dimension
Configuration details for the ad's landing page.
ad.landing_page_configuration.query_string_template Dimension
The template used to generate the query string for the ad's landing page URL.
ad.name Dimension
The user-defined name of the ad.
ad.review.reason Dimension
The reason for the ad's review status.
ad.review.status Dimension
The current review status of the ad, indicating whether it has been approved, rejected, or is pending review.
ad.review_status Dimension
The current review status of the ad, indicating whether it has been approved, rejected, or is pending review.
ad.status Dimension
The current operational status of the ad, such as enabled, paused, or archived.
ad.updated_at Dimension
The Unix timestamp indicating when the ad was last updated.
ad_account.account_integrity_review.details.decision Dimension
The decision made during the ad account's integrity review.
ad_account.account_integrity_review.details.reason Dimension
The reason provided for the decision made during the ad account's integrity review.
ad_account.account_integrity_review.details.status_updated_at Dimension
The timestamp when the status of the ad account's integrity review was last updated.
ad_account.account_integrity_review.review.status Dimension
The overall status of the ad account's integrity review.
ad_account.currency_code Dimension
The currency code used for the ad account (e.g., USD).
ad_account.id Dimension
Unique identifier for the ad account.
ad_account.name Dimension
Name of the ad account.
ad_account.origin_country_code Dimension
The country where the ad account is registered, which is a key factor in determining geographic eligibility for launching campaigns.
ad_account.preview_url Dimension
A URL for previewing the ad account's settings or content.
ad_account.review.reason Dimension
The reason for the ad account's review status.
ad_account.review.status Dimension
The current review status of the ad account.
ad_account.status Dimension
The current operational status of the ad account.
ad_account.timezone Dimension
The timezone configured for the ad account.
ad_account.url Dimension
The main URL associated with the ad account.
ad_account_id Dimension
A unique identifier for the ad account.
ad_account_name Dimension
The user-defined name of the ad account.
ad_group.bidding_config.billing_event_type Dimension
The type of event that triggers billing for the ad group.
ad_group.bidding_config.max_bid Metric
The maximum bid amount set for the ad group.
ad_group.bidding_config.strategy Dimension
The bidding strategy employed for the ad group (e.g., highest value, lowest cost).
ad_group.context_hints Dimension
Hints or additional context associated with the ad group.
ad_group.created_at Dimension
Timestamp when the ad group was created.
ad_group.description Dimension
A descriptive text for the ad group.
ad_group.id Dimension
The unique identifier for the ad group.
ad_group.landing_page_configuration Dimension
Configuration details for the ad group's landing page.
ad_group.landing_page_configuration.query_string_template Dimension
The template used to generate the query string for the ad group's landing page URL.
ad_group.name Dimension
Name of the ad group.
ad_group.product_set Dimension
The product set associated with the ad group, defining which products are eligible for ads within this group.
ad_group.product_set.filters Dimension
Filters applied to the product set to narrow down the selection of products for the ad group.
ad_group.product_set.product_feed_id Dimension
The identifier of the product feed from which the product set draws its products.
ad_group.status Dimension
The current operational status of the ad group.
ad_group.updated_at Dimension
Timestamp when the ad group was last updated.
ad_group_id Dimension
A unique identifier for the ad group.
ad_group_name Dimension
The user-defined name of the ad group.
ad_id Metric
A unique identifier for the ad.
ad_name Dimension
The user-defined name of the ad.
campaign.bidding_type Dimension
The bidding type for the campaign (e.g., CPC, CPM).
campaign.billing_event_type Dimension
The billing event type defines the action for which an advertiser is charged within a campaign, such as a click or an impression.
campaign.budget.daily_spend_limit Metric
The daily spending limit set for the campaign budget.
campaign.conversion_event_setting_ids Dimension
Identifiers for conversion event settings applied to the campaign.
campaign.created_at Dimension
Timestamp when the campaign was created.
campaign.description Dimension
A descriptive text for the campaign.
campaign.end_time Dimension
The scheduled end time for the campaign.
campaign.id Dimension
The unique identifier for the campaign.
campaign.landing_page_configuration Dimension
Configuration details for the campaign's landing page.
campaign.landing_page_configuration.query_string_template Dimension
The template used to generate the query string for the campaign's landing page URL.
campaign.mode Dimension
The operational mode of the campaign, indicating its objective or strategy.
campaign.name Dimension
Name of the campaign.
campaign.objective Dimension
Specifies the primary goal of the campaign, such as driving impressions or conversions.
campaign.product_feed_id Dimension
Identifier for the product feed linked to the campaign for dynamic product ads.
campaign.start_time Dimension
The scheduled start time for the campaign.
campaign.status Dimension
The current operational status of the campaign.
campaign.targeting.excluded_locations.countries Dimension
A list of two-letter country codes (e.g., 'US', 'CA') where ads for the campaign will not be delivered. Exclusion targeting takes precedence over any included locations.
campaign.targeting.locations.countries Dimension
Specifies the countries where the campaign's ads will be displayed.
campaign.targeting.locations.include Dimension
Indicates whether the specified locations are included or excluded in targeting.
campaign.updated_at Dimension
Timestamp when the campaign was last updated.
campaign_id Dimension
A unique identifier for the campaign.
campaign_name Dimension
The user-defined name of the campaign.
clicks Metric
The total number of clicks on the ad during the reporting period.
country_name Dimension
The name of the country.
cpc Metric
Cost-per-click, representing the average cost for each click.
cpm Metric
Cost-per-mille (or cost-per-thousand impressions), representing the average cost for every thousand impressions.
ctr Metric
Click-through rate, the ratio of clicks to impressions.
device_type Dimension
The type of device (e.g., mobile, desktop) where the ad was shown.
end_time Dimension
The end date and time for which insights data is retrieved.
id Dimension
A unique identifier for the specific record being processed (e.g., ad account, campaign, ad group, or ad ID depending on the context).
impressions Metric
The total number of times the ad was displayed during the reporting period.
item_id Dimension
A unique identifier for an individual product item, particularly when reporting with product breakdown.
product_availability Dimension
The current availability status of a product (e.g., in stock, out of stock).
product_body Dimension
The main textual content or description of a product.
product_brand Dimension
The brand associated with the product.
product_description Dimension
A detailed description of the product.
product_feed_id Dimension
The identifier of the product feed where the product data originates.
product_image_url Dimension
The URL of the main image for the product.
product_price Dimension
The current selling price of the product.
product_seller_name Dimension
The name of the seller or merchant offering the product.
product_target_url Dimension
The URL that users are directed to when clicking on an ad for this product.
product_title Dimension
The title or name of the product.
readable_time Dimension
A human-readable representation of the time or date for reporting purposes.
spend Metric
The total amount of money spent.
start_time Dimension
The start date and time for which insights data is retrieved.