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.
10_second_live_views Metric
The total number of views that lasted at least 10 seconds during a live stream commerce campaign.
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_brand Dimension
The brand associated with the advertiser's account.
advertiser_country Dimension
The country where the advertiser's account is registered or primarily operates.
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.
advertiser_timezone Dimension
The timezone configured for the advertiser's account.
bid_type Dimension
The bidding strategy or type configured for the campaign, such as 'lowest_cost' or 'target_cost'.
campaign_create_time Dimension
The date and time when the campaign was created.
campaign_id Dimension
Unique identifier for the TikTok GMV Max campaign.
campaign_name Dimension
Name of the TikTok GMV Max campaign.
campaign_objective_type Dimension
The primary objective of the campaign, such as 'PRODUCT_SALES' or 'LIVE_SALES'.
cost Metric
Total cost incurred for the campaign.
cost_per_10_second_live_view Metric
The average cost incurred for each live view that lasted at least 10 seconds.
cost_per_live_view Metric
The average cost incurred for each live view.
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_follows Metric
The number of new followers gained during a live stream commerce campaign.
live_launched_time Dimension
The date and time when the livestream was launched.
live_name Dimension
The name or title of the livestream.
live_status Dimension
The current operational status of the livestream, such as 'Delivering', 'Not delivering', 'Not LIVE yet', or 'Excluded'.
live_views Metric
The total number of views for a live stream commerce campaign.
max_delivery_budget Metric
The maximum budget allocated for the campaign's delivery.
net_cost Metric
The total amount spent on the GMV Max campaigns.
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'.
roas_bid Metric
The target Return On Ad Spend (ROAS) set as a bidding strategy for the campaign.
roi Dimension
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 Metric
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.
schedule_type Dimension
The type of schedule applied to the campaign, such as 'daily_budget' or 'total_budget'.
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.
stat_time_hour Dimension
The hour of the day for which the statistics are reported, used for hourly data aggregation.
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.
target_roi_budget Metric
The target Return On Investment (ROI) budget configured for the GMV Max campaign.
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.