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		metric
ad_video_view_rate_p25	ad_video_view_rate_p25		metric
ad_video_view_rate_p50	ad_video_view_rate_p50		metric
ad_video_view_rate_p75	ad_video_view_rate_p75		metric
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
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_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		metric
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.	metric
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