TikTok GMV Max: Most-used fields

The total number of views that lasted at least 10 seconds during a live stream commerce campaign.

The percentage of impressions that resulted in a destination click on your ads.

The percentage of results you received out of all destination clicks on your ads.

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.

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.

The percentage of an ad video that was viewed to 100% completion.

The percentage of an ad video that was viewed to 25% completion.

The percentage of an ad video that was viewed to 50% completion.

The percentage of an ad video that was viewed to 75% completion.

The current balance and budget information for the advertiser's ad account, retrievable via the `/open_api/v1.3/advertiser/balance/get/` endpoint.

The brand associated with the advertiser's account.

The registered business name of the advertiser, often referred to as 'advertiser.business_name' in the API documentation.

The country where the advertiser's account is registered or primarily operates.

The currency used in the advertiser's account for reporting financial metrics within GMV Max campaigns.

The time zone configured for the advertiser's account, which influences how reports and other time-based data are displayed. 'report_timezone' is mentioned in the API as a setting for reports.

The unique identifier for the advertiser account within the TikTok for Business platform.

The display name of the advertiser account associated with the GMV Max campaign.

The current operational status of the advertiser's account, indicating whether it is active, inactive, or in another state. This is analogous to 'ad.status' or 'Ad operation status' for creative assets.

The timezone configured for the advertiser's account.

The bidding strategy or type configured for the campaign, such as 'lowest_cost' or 'target_cost'.

The date and time when the campaign was created.

Unique identifier for the TikTok GMV Max campaign.

The timestamp when the campaign was last modified. This is a common attribute for campaign management objects in APIs.

Name of the TikTok GMV Max campaign.

The primary objective of the campaign, such as 'PRODUCT_SALES' or 'LIVE_SALES'.

The current operational status of the campaign, indicating its state such as 'ENABLE', 'DISABLE', or 'FROZEN'. This is similar to the 'Ad operation status' for individual ads.

A more granular or specific status of the campaign, complementing the primary operational status (e.g., active, paused, disabled).

Total cost incurred for the campaign.

The average cost incurred for each live view that lasted at least 10 seconds.

The average cost incurred for each live view.

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.

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'.

The standardized form of money, representing the currency used for the ad account in which costs and spending are reported.

This field represents the reporting date for the collected GMV Max campaign data, indicating when the performance metrics were recorded or are relevant.

Total gross revenue generated by the campaign.

Unique identifier for the TikTok identity used to create or promote an ad.

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.

The ID of a TikTok post used as a Spark Ad.

The total duration of the live stream session in seconds, derived from the start and end times.

The number of new followers gained during a live stream commerce campaign.

The date and time when the livestream was launched.

The name or title of the livestream.

The current operational status of the livestream, such as 'Delivering', 'Not delivering', 'Not LIVE yet', or 'Excluded'.

The total number of views for a live stream commerce campaign.

The maximum budget allocated for the campaign's delivery.

The total amount spent on the GMV Max campaigns.

This field indicates the current operational status of the GMV Max campaign, such as whether it is active, paused, or ended.

Number of orders attributed to the campaign.

The rate at which users click on products after viewing product-related ads, excluding live 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.

The URL for the primary image associated with a product.

The number of times product-related ads or content were displayed to users.

The name or title of the product featured in the GMV Max campaign. This field helps identify the specific product being advertised or sold.

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'.

The target Return On Ad Spend (ROAS) set as a bidding strategy for the campaign.

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.

Unique identifier for the live stream room or session.

The scheduled or actual end time of the live stream or promotional period.

The scheduled or actual start time of the live stream or promotional period.

The type of schedule applied to the campaign, such as 'daily_budget' or 'total_budget'.

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).

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.

The hour of the day for which the statistics are reported, used for hourly data aggregation.

The unique identifier for the TikTok Shop store. This field is used for filtering reports to specific stores.

The display name of the TikTok Shop store, used to enrich reports with descriptive information.

The current operational status of a TikTok Store (e.g., active, inactive, under review). The API supports managing TikTok Stores and storefronts, implying a status field would exist.

The title or name of a live stream session, campaign, or product.

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.

The name of the associated TikTok account.

The URL of the profile image for the TikTok account associated with the GMV Max campaign or creative.