Documentation Index

Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt

Use this file to discover all available pages before exploring further.

TikTok Ads Smart+ Ads and GMV Max campaign reporting - August 10, 2026

Prev Next

We've added support for two new TikTok Ads campaign types: Smart+ Ads and GMV Max campaigns. If you report on TikTok Ads with Supermetrics, you can now use new reporting capabilities for Smart+ campaigns and GMV Max campaigns, each with its own set of dimensions and metrics.

Read below for more on what’s available!

Smart+ Ads reporting

Smart+ is TikTok's automated advertising product. It handles targeting, bidding, and creative optimization for you. We now support reporting on Smart+ campaigns:

  • Smart+ Ad: Smart+ ad (asset group) level, including status and lifecycle metadata

  • Smart+ Creative: Breakdown by creative component

  • Smart+ Creative Overview: Combined asset-group and creative overview

New dimensions

The following dimensions have been added:

Smart+ Ad

Field name

API field name

Smart+ Ad ID

smart_plus_ad_id

Smart+ Ad secondary status

smart_plus_ad_secondary_status

Smart+ Ad operation status

smart_plus_ad_operation_status

Smart+ Ad create time

smart_plus_ad_create_time

Smart+ Ad modify time

smart_plus_ad_modify_time

Smart+ Creative

Field name

API field name

Creative ID

main_material_id

Creative main material type

main_material_type

Smart+ creative main material name

main_material_name

Smart+ creative asset name

multi_name

Ad text entity ID

ad_text_entity_id

Call-to-action entity ID

call_to_action_entity_id

Interactive add-on entity ID

interactive_add_on_entity_id

Interactive add-on name

interactive_add_on_name

Smart+ Creative Overview

Field name

API field name

Smart+ Ad ID

smart_plus_ad_id

Creative ID

main_material_id

Creative main material type

main_material_type

Creative material primary status

material_primary_status

Creative material operation status

material_operation_status

Ad material ID

ad_material_id

Smart+ creative main material name

main_material_name

New metrics

These metrics are available across the Smart+ reporting:

Field name

API field name

Notes

Gross impressions

gross_impressions

Conversion rate (Smart+)

conversion_rate_v2

Engagement rate

engagement_rate

Product clicks

product_clicks

Creative and Creative Overview only

Product impressions

product_impressions

Creative and Creative Overview only

Most standard TikTok Ads fields, such as Ad name, impressions, spend, clicks, and conversions, also work with the Smart+ fields.

Things to keep in mind

  • Smart+ Ad reporting only returns Smart+ campaigns. Ordinary auction ads won't show up under Smart+ Ad ID.

  • The Smart+ Creative Overview has no daily breakdown, so the Date dimension can't be used with it. Calendar fields such as Year, Month, and Week still work, since we split the date range on our side. This report is also limited to its two built-in dimensions, Smart+ Ad ID and Creative ID.

  • Smart+ fields are available for auction campaigns. Gross impressions and Engagement rate additionally support reservation campaigns.

GMV Max campaign reporting

We now support full GMV Max campaign reporting at every level: account, campaign, product, creative, and livestream. This includes rich store, product, creative, and livestream metadata:

  • Account: GMV Max totals for the account.

  • Campaign: Campaign-level GMV Max data.

  • Product: Product-group level.

  • Creative: Creative and post level.

  • Livestream: LIVE room level.

New dimensions

The following dimensions have been added:

Identifiers

Field name

API field name

Product group ID

item_group_id

Creative ID

item_id

Store

Field name

API field name

Store ID

gmv_max_store_id

Store name

gmv_max_store_name

Store code

gmv_max_store_code

Store status

gmv_max_store_status

Store region

gmv_max_store_region

Store thumbnail URL

gmv_max_store_thumbnail_url

Campaign

Field name

API field name

GMV Max campaign type

gmv_max_shopping_ads_type

Schedule type

gmv_max_schedule_type

Schedule start time

gmv_max_schedule_start_time

Schedule end time

gmv_max_schedule_end_time

Optimization mode

gmv_max_bid_type

Product

Field name

API field name

Product status

gmv_max_product_status

Product name

gmv_max_product_name

Product image URL

gmv_max_product_image_url

Creative

Field name

API field name

Creative delivery status

gmv_max_creative_delivery_status

TikTok account name

gmv_max_tt_account_name

TikTok account profile image URL

gmv_max_tt_account_profile_image_url

TikTok account ID

gmv_max_identity_id

Livestream

Field name

API field name

LIVE name

gmv_max_live_name

Livestream status

gmv_max_live_status

Livestream launched time

gmv_max_live_launched_time

Livestream duration

gmv_max_live_duration

New metrics

The following metrics have been added:

Cost and revenue

Field name

API field name

GMV Max Ads cost

gmv_max_cost

GMV Max Ads net cost

gmv_max_net_cost

GMV Max Ads orders

gmv_max_orders

GMV Max Ads cost per order

gmv_max_cost_per_order

GMV Max Ads gross revenue

gmv_max_gross_revenue

GMV Max Ads ROI

gmv_max_roi

Target ROI budget

gmv_max_target_roi_budget

Max delivery budget

gmv_max_max_delivery_budget

Engagement and delivery

Field name

API field name

Product ad impressions

gmv_max_product_impressions

Product ad clicks

gmv_max_product_clicks

Product ad click rate

gmv_max_product_click_rate

Ad click rate

gmv_max_ad_click_rate

Ad conversion rate

gmv_max_ad_conversion_rate

Video view rates

Field name

API field name

2-second video view rate

gmv_max_video_view_rate_2s

6-second video view rate

gmv_max_video_view_rate_6s

25% video view rate

gmv_max_video_view_rate_p25

50% video view rate

gmv_max_video_view_rate_p50

75% video view rate

gmv_max_video_view_rate_p75

100% video view rate

gmv_max_video_view_rate_p100

Livestream

Field name

API field name

LIVE views

gmv_max_live_views

Cost per LIVE view

gmv_max_cost_per_live_view

10-second LIVE views

gmv_max_10_second_live_views

Cost per 10-second LIVE view

gmv_max_cost_per_10_second_live_view

LIVE follows

gmv_max_live_follows

All shops

Field name

API field name

Orders (all shops)

gmv_max_all_shops_orders

Cost per order (all shops)

gmv_max_all_shops_cost_per_order

Gross revenue (!ll shops)

gmv_max_all_shops_gross_revenue

ROI (all shops)

gmv_max_all_shops_roi

Legacy fields

The 2 metrics from the original GMV Max Ads release have been renamed with a (Legacy) suffix and continue to work as before, served from TikTok's older reporting endpoint:

Field name

API field name

GMV Max Ads spend (Legacy)

gmv_max_ads_spend

GMV Max Ads billed cost (Legacy)

gmv_max_ads_billed_cost

For new work, use the GMV Max Ads cost (gmv_max_cost) and GMV Max Ads net cost (gmv_max_net_cost) fields instead. The roi_protection_compensation_status dimension from the original release is still available.

Things to keep in mind

  • Day-level GMV Max queries are capped at a 30-day date range, since this is a limit set by TikTok's API. Longer date ranges work fine if you don't split by day.

  • A GMV Max campaign is either a product campaign or a livestream (LIVE) campaign. The GMV Max campaign type dimension tells you which. Livestream metrics only populate for LIVE campaigns.

  • Store metadata, such as store name, code, status, region, and thumbnail, is available at the account, campaign, product, and creative levels, and is enriched automatically.

  • Don't combine the legacy spend and billed cost metrics with the new GMV Max Ads cost metrics in the same query. They come from different endpoints and can't be combined.

We're here for you

If you have any questions or concerns about this change, contact our support team

More resources