TikTok GMV Max: Most-used fields#
The table below gives information about most-used fields that you can import from TikTok GMV Max. 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 |
|---|---|---|---|
ad_click_rate |
ad_click_rate |
The percentage of impressions that resulted in a destination click on your ads. |
metric |
ad_conversion_rate |
ad_conversion_rate |
The percentage of results you received out of all destination clicks on your ads. |
metric |
ad_video_view_rate_p100 |
ad_video_view_rate_p100 |
The percentage of an ad video that was viewed to 100% completion. |
metric |
ad_video_view_rate_p25 |
ad_video_view_rate_p25 |
The percentage of an ad video that was viewed to 25% completion. |
metric |
ad_video_view_rate_p50 |
ad_video_view_rate_p50 |
The percentage of an ad video that was viewed to 50% completion. |
metric |
ad_video_view_rate_p75 |
ad_video_view_rate_p75 |
The percentage of an ad video that was viewed to 75% completion. |
metric |
advertiser_brand |
advertiser_brand |
The brand name associated with the advertiser account running the GMV Max campaign. This field helps identify the brand promoting the products. |
dimension |
advertiser_country |
advertiser_country |
The country code of the advertiser. |
dimension |
advertiser_id |
advertiser_id |
The unique identifier for the advertiser account within the TikTok for Business platform. |
dimension |
advertiser_name |
advertiser_name |
The display name of the advertiser account associated with the GMV Max campaign. |
dimension |
campaign_id |
campaign_id |
Unique identifier for the TikTok GMV Max campaign. |
dimension |
campaign_name |
campaign_name |
Name of the TikTok GMV Max campaign. |
dimension |
cost |
cost |
Total cost incurred for the campaign. |
metric |
creative_delivery_status |
creative_delivery_status |
The current status of the ad creative’s delivery within the GMV Max campaign. This can indicate if the creative is actively promoting, is in a learning phase, or has encountered issues like rejection. Possible values include ‘DELIVERING’, ‘LEARNING’, ‘REJECTED’, or ‘UNAVAILABLE’. |
dimension |
date |
date |
This field represents the reporting date for the collected GMV Max campaign data, indicating when the performance metrics were recorded or are relevant. |
dimension |
gross_revenue |
gross_revenue |
Total gross revenue generated by the campaign. |
metric |
item_id |
item_id |
The ID of a TikTok post used as a Spark Ad. |
dimension |
operation_status |
operation_status |
This field indicates the current operational status of the GMV Max campaign, such as whether it is active, paused, or ended. |
dimension |
orders |
orders |
Number of orders attributed to the campaign. |
metric |
product_click_rate |
product_click_rate |
The rate at which users click on products after viewing product-related ads, excluding live clicks. |
metric |
product_clicks |
product_clicks |
The number of times viewers clicked on a product, either from an instant page leading to detail page views or during a LIVE session. |
metric |
product_impressions |
product_impressions |
The number of times product-related ads or content were displayed to users. |
metric |
product_name |
product_name |
The name or title of the product featured in the GMV Max campaign. This field helps identify the specific product being advertised or sold. |
dimension |
product_status |
product_status |
The current status of the product in the TikTok Shop or catalog, indicating its availability and eligibility for campaigns. While not directly returned in the GMV Max report, this status influences product visibility and campaign performance. |
dimension |
roi |
roi |
The Return on Investment (ROI) generated from GMV Max campaigns, indicating the profitability of the ad spend. This is a core performance metric for account-level analysis. |
dimension |
stat_time_day |
stat_time_day |
This field represents the specific date for which the GMV Max campaign performance statistics are reported. It serves as a dimension for analyzing daily performance. |
dimension |
store_id |
store_id |
The unique identifier for the TikTok Shop store. This field is used for filtering reports to specific stores. |
dimension |
store_name |
store_name |
The display name of the TikTok Shop store, used to enrich reports with descriptive information. |
dimension |
tt_account_name |
tt_account_name |
The name of the associated TikTok account. |
dimension |