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.
ad_click_rate Metric
The percentage of impressions that resulted in a destination click on your ads.
ad_conversion_rate Metric
The percentage of results you received out of all destination clicks on your ads.
ad_video_view_rate_2s Metric
The rate at which an ad video is viewed for at least 2 seconds, calculated by dividing two-second video views by total video views, excluding replays.
ad_video_view_rate_6s Metric
The rate at which an ad video is viewed for at least 6 seconds, calculated by dividing six-second video views by total video views, excluding replays.
ad_video_view_rate_p100 Metric
The percentage of an ad video that was viewed to 100% completion.
ad_video_view_rate_p25 Metric
The percentage of an ad video that was viewed to 25% completion.
ad_video_view_rate_p50 Metric
The percentage of an ad video that was viewed to 50% completion.
ad_video_view_rate_p75 Metric
The percentage of an ad video that was viewed to 75% completion.
advertiser_currency Dimension
The currency used in the advertiser's account for reporting financial metrics within GMV Max campaigns.
advertiser_id Dimension
The unique identifier for the advertiser account within the TikTok for Business platform.
advertiser_name Dimension
The display name of the advertiser account associated with the GMV Max campaign.
campaign_id Dimension
Unique identifier for the TikTok GMV Max campaign.
campaign_name Dimension
Name of the TikTok GMV Max campaign.
cost Metric
Total cost incurred for the campaign.
cost_per_order Metric
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.
creative_delivery_status Dimension
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'.
currency Dimension
The standardized form of money, representing the currency used for the ad account in which costs and spending are reported.
date Dimension
This field represents the reporting date for the collected GMV Max campaign data, indicating when the performance metrics were recorded or are relevant.
gross_revenue Metric
Total gross revenue generated by the campaign.
identity_id Dimension
Unique identifier for the TikTok identity used to create or promote an ad.
item_group_id Metric
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.
item_id Dimension
The ID of a TikTok post used as a Spark Ad.
live_duration Dimension
The total duration of the live stream session in seconds, derived from the start and end times.
live_launched_time Dimension
The timestamp when the live stream session officially began.
live_name Dimension
The user-defined title or name given to the live stream session.
live_views Metric
The total number of unique viewers who joined the live stream session.
operation_status Dimension
This field indicates the current operational status of the GMV Max campaign, such as whether it is active, paused, or ended.
orders Metric
Number of orders attributed to the campaign.
product_click_rate Metric
The rate at which users click on products after viewing product-related ads, excluding live clicks.
product_clicks Metric
The number of times viewers clicked on a product, either from an instant page leading to detail page views or during a LIVE session.
product_image_url Dimension
The URL for the primary image associated with a product.
product_impressions Metric
The number of times product-related ads or content were displayed to users.
product_name Dimension
The name or title of the product featured in the GMV Max campaign. This field helps identify the specific product being advertised or sold.
product_status Dimension
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'.
roi Metric
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.
room_id Dimension
Unique identifier for the live stream room or session.
schedule_end_time Metric
The scheduled or actual end time of the live stream or promotional period.
schedule_start_time Metric
The scheduled or actual start time of the live stream or promotional period.
shop_content_type Dimension
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).
stat_time_day Dimension
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.
store_id Dimension
The unique identifier for the TikTok Shop store. This field is used for filtering reports to specific stores.
store_name Dimension
The display name of the TikTok Shop store, used to enrich reports with descriptive information.
title Dimension
The title or name of a live stream session, campaign, or product.
tt_account_authorization_type Dimension
This field indicates the type of TikTok account that has authorized the data collection platform, such as a Seller, Creator, Partner, or Advertiser account. This determines the scope of data accessible to the platform.
tt_account_name Dimension
The name of the associated TikTok account.
tt_account_profile_image_url Dimension
The URL of the profile image for the TikTok account associated with the GMV Max campaign or creative.