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_currency	advertiser_currency	The currency used in the advertiser’s account for reporting financial metrics within GMV Max campaigns.	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
cost_per_order	cost_per_order	The average cost incurred for each order generated by the GMV Max campaign. It is calculated by dividing the total cost by the number of orders.	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
currency	currency	The currency in which the financial metrics are reported.	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_group_id	item_group_id	An identifier for a group of product variants. This is used to group similar products, such as different colors or sizes of the same item, to optimize ad performance and avoid recommending product variants individually.	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 a product within the GMV Max campaign. This field indicates whether the product is available, such as ‘in stock’ or ‘out of stock’.	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
shop_content_type	shop_content_type	The type of content associated with the TikTok Shop promotion, indicating whether it’s product-based (e.g., PRODUCT_GMV_MAX) or livestream-based (e.g., LIVE_GMV_MAX).	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
title	title	The name or title of the reported entity, such as a campaign, product, creative, or livestream, depending on the reporting level.	dimension
tt_account_authorization_type	tt_account_authorization_type		dimension
tt_account_name	tt_account_name	The name of the associated TikTok account.	dimension
tt_account_profile_image_url	tt_account_profile_image_url	The URL of the profile image for the TikTok account associated with the GMV Max campaign or creative.	dimension