--- title: "TikTok Ads Smart+ Ads and GMV Max campaign reporting - August 10, 2026" slug: "tiktok-ads-smart-ads-and-gmv-max-campaign-reporting-august-10-2026" description: "Learn about TikTok Ads reporting support for Smart+ Ads and GMV Max campaigns, including new dimensions and metrics." updated: 2026-09-04T06:45:00Z published: 2026-09-04T06:45:00Z canonical: "docs.supermetrics.com/tiktok-ads-smart-ads-and-gmv-max-campaign-reporting-august-10-2026" --- > ## 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 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](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-smartplusadid) | `smart_plus_ad_id` | | [Smart+ Ad secondary status](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-smartplusadsecondarystatus) | `smart_plus_ad_secondary_status` | | [Smart+ Ad operation status](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-smartplusadoperationstatus) | `smart_plus_ad_operation_status` | | [Smart+ Ad create time](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-smartplusadcreatetime) | `smart_plus_ad_create_time` | | [Smart+ Ad modify time](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-smartplusadmodifytime) | `smart_plus_ad_modify_time` | #### Smart+ Creative | **Field name** | **API field name** | | --- | --- | | [Creative ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-mainmaterialid) | `main_material_id` | | [Creative main material type](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-mainmaterialtype) | `main_material_type` | | [Smart+ creative main material name](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-mainmaterialname) | `main_material_name` | | [Smart+ creative asset name](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-multiname) | `multi_name` | | [Ad text entity ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-adtextentityid) | `ad_text_entity_id` | | [Call-to-action entity ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-calltoactionentityid) | `call_to_action_entity_id` | | [Interactive add-on entity ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-interactiveaddonentityid) | `interactive_add_on_entity_id` | | [Interactive add-on name](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-interactiveaddonname) | `interactive_add_on_name` | #### Smart+ Creative Overview | **Field name** | **API field name** | | --- | --- | | [Smart+ Ad ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-smartplusadid) | `smart_plus_ad_id` | | [Creative ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-mainmaterialid) | `main_material_id` | | [Creative main material type](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-mainmaterialtype) | `main_material_type` | | [Creative material primary status](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-materialprimarystatus) | `material_primary_status` | | [Creative material operation status](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-materialoperationstatus) | `material_operation_status` | | [Ad material ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-admaterialid) | `ad_material_id` | | [Smart+ creative main material name](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-mainmaterialname) | `main_material_name` | ### New metrics These metrics are available across the Smart+ reporting: | **Field name** | **API field name** | **Notes** | | --- | --- | --- | | [Gross impressions](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-grossimpressions) | `gross_impressions` | | | [Conversion rate (Smart+)](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-conversionratev2) | `conversion_rate_v2` | | | [Engagement rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-engagementrate) | `engagement_rate` | | | [Product clicks](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-productclicks) | `product_clicks` | Creative and Creative Overview only | | [Product impressions](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-smart-ad-productimpressions) | `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](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-itemgroupid) | `item_group_id` | | [Creative ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-itemid) | `item_id` | #### Store | **Field name** | **API field name** | | --- | --- | | [Store ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-store-gmvmaxstoreid) | `gmv_max_store_id` | | [Store name](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-store-gmvmaxstorename) | `gmv_max_store_name` | | [Store code](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-store-gmvmaxstorecode) | `gmv_max_store_code` | | [Store status](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-store-gmvmaxstorestatus) | `gmv_max_store_status` | | [Store region](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-store-gmvmaxstoreregion) | `gmv_max_store_region` | | [Store thumbnail URL](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-store-gmvmaxstorethumbnailurl) | `gmv_max_store_thumbnail_url` | #### Campaign | **Field name** | **API field name** | | --- | --- | | [GMV Max campaign type](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-campaign-gmvmaxshoppingadstype) | `gmv_max_shopping_ads_type` | | [Schedule type](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-campaign-gmvmaxscheduletype) | `gmv_max_schedule_type` | | [Schedule start time](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-campaign-gmvmaxschedulestarttime) | `gmv_max_schedule_start_time` | | [Schedule end time](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-campaign-gmvmaxscheduleendtime) | `gmv_max_schedule_end_time` | | [Optimization mode](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-campaign-gmvmaxbidtype) | `gmv_max_bid_type` | #### Product | **Field name** | **API field name** | | --- | --- | | [Product status](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-product-gmvmaxproductstatus) | `gmv_max_product_status` | | [Product name](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-product-gmvmaxproductname) | `gmv_max_product_name` | | [Product image URL](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-product-gmvmaxproductimageurl) | `gmv_max_product_image_url` | #### Creative | **Field name** | **API field name** | | --- | --- | | [Creative delivery status](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxcreativedeliverystatus) | `gmv_max_creative_delivery_status` | | [TikTok account name](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxttaccountname) | `gmv_max_tt_account_name` | | [TikTok account profile image URL](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxttaccountprofileimageurl) | `gmv_max_tt_account_profile_image_url` | | [TikTok account ID](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxidentityid) | `gmv_max_identity_id` | #### Livestream | **Field name** | **API field name** | | --- | --- | | [LIVE name](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxlivename) | `gmv_max_live_name` | | [Livestream status](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxlivestatus) | `gmv_max_live_status` | | [Livestream launched time](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxlivelaunchedtime) | `gmv_max_live_launched_time` | | [Livestream duration](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxliveduration) | `gmv_max_live_duration` | ### New metrics The following metrics have been added: #### Cost and revenue | **Field name** | **API field name** | | --- | --- | | [GMV Max Ads cost](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-gmvmaxcost) | `gmv_max_cost` | | [GMV Max Ads net cost](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-gmvmaxnetcost) | `gmv_max_net_cost` | | [GMV Max Ads orders](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-gmvmaxorders) | `gmv_max_orders` | | [GMV Max Ads cost per order](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-gmvmaxcostperorder) | `gmv_max_cost_per_order` | | [GMV Max Ads gross revenue](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-gmvmaxgrossrevenue) | `gmv_max_gross_revenue` | | [GMV Max Ads ROI](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-gmvmaxroi) | `gmv_max_roi` | | [Target ROI budget](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-campaign-gmvmaxtargetroibudget) | `gmv_max_target_roi_budget` | | [Max delivery budget](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-campaign-gmvmaxmaxdeliverybudget) | `gmv_max_max_delivery_budget` | #### Engagement and delivery | **Field name** | **API field name** | | --- | --- | | [Product ad impressions](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxproductimpressions) | `gmv_max_product_impressions` | | [Product ad clicks](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxproductclicks) | `gmv_max_product_clicks` | | [Product ad click rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxproductclickrate) | `gmv_max_product_click_rate` | | [Ad click rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxadclickrate) | `gmv_max_ad_click_rate` | | [Ad conversion rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxadconversionrate) | `gmv_max_ad_conversion_rate` | #### Video view rates | **Field name** | **API field name** | | --- | --- | | [2-second video view rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxvideoviewrate2s) | `gmv_max_video_view_rate_2s` | | [6-second video view rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxvideoviewrate6s) | `gmv_max_video_view_rate_6s` | | [25% video view rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxvideoviewratep25) | `gmv_max_video_view_rate_p25` | | [50% video view rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxvideoviewratep50) | `gmv_max_video_view_rate_p50` | | [75% video view rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxvideoviewratep75) | `gmv_max_video_view_rate_p75` | | [100% video view rate](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-creative-gmvmaxvideoviewratep100) | `gmv_max_video_view_rate_p100` | #### Livestream | **Field name** | **API field name** | | --- | --- | | [LIVE views](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxliveviews) | `gmv_max_live_views` | | [Cost per LIVE view](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxcostperliveview) | `gmv_max_cost_per_live_view` | | [10-second LIVE views](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmax10secondliveviews) | `gmv_max_10_second_live_views` | | [Cost per 10-second LIVE view](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxcostper10secondliveview) | `gmv_max_cost_per_10_second_live_view` | | [LIVE follows](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxlivefollows) | `gmv_max_live_follows` | #### All shops | **Field name** | **API field name** | | --- | --- | | [Orders (all shops)](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxallshopsorders) | `gmv_max_all_shops_orders` | | [Cost per order (all shops)](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxallshopscostperorder) | `gmv_max_all_shops_cost_per_order` | | [Gross revenue (!ll shops)](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxallshopsgrossrevenue) | `gmv_max_all_shops_gross_revenue` | | [ROI (all shops)](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-live-gmvmaxallshopsroi) | `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)](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-gmvmaxadsspend) | `gmv_max_ads_spend` | | [GMV Max Ads billed cost (Legacy)](https://docs.supermetrics.com/docs/tiktok-ads-fields#field-gmv-max-ads-gmvmaxadsbilledcost) | `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](https://hub.supermetrics.com/support) ## More resources - [TikTok Ads metrics and dimensions](/v1/docs/tiktok-ads-fields)