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+ Creative
Field name | API field name |
|---|---|
| |
| |
| |
| |
| |
| |
| |
|
Smart+ Creative Overview
Field name | API field name |
|---|---|
| |
| |
| |
| |
| |
| |
|
New metrics
These metrics are available across the Smart+ reporting:
Field name | API field name | Notes |
|---|---|---|
| ||
| ||
| ||
| Creative and Creative Overview only | |
| 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 |
|---|---|
| |
|
Store
Field name | API field name |
|---|---|
| |
| |
| |
| |
| |
|
Campaign
Field name | API field name |
|---|---|
| |
| |
| |
| |
|
Product
Field name | API field name |
|---|---|
| |
| |
|
Creative
Field name | API field name |
|---|---|
| |
| |
| |
|
Livestream
Field name | API field name |
|---|---|
| |
| |
| |
|
New metrics
The following metrics have been added:
Cost and revenue
Field name | API field name |
|---|---|
| |
| |
| |
| |
| |
| |
| |
|
Engagement and delivery
Field name | API field name |
|---|---|
| |
| |
| |
| |
|
Video view rates
Field name | API field name |
|---|---|
| |
| |
| |
| |
| |
|
Livestream
Field name | API field name |
|---|---|
| |
| |
| |
| |
|
All shops
Field name | API field name |
|---|---|
| |
| |
| |
|
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 |
|---|---|
| |
|
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