Before you connect
The following are required:- A TikTok account with access to the TikTok ad account that runs GMV Max campaigns.
- At least one TikTok Shop store that is available for GMV Max on that ad account. Only GMV-Max-available stores can be connected.
Connect TikTok GMV Max
1
Authorize with TikTok
On the Data Sources page, search for TikTok GMV Max and select it. Sign in to TikTok in the pop-up using an account with access to the target ad account, then approve the requested read permissions to complete authorization.
2
Select the account
On the data source settings, choose one Account from the dropdown list.
3
Choose which stores to include
Decide whether to use all GMV stores or a specific set. To include every available store, keep the all-stores option. To limit the connection to specific stores, choose Select Stores, then pick the stores from the dropdown that appears.
4
Submit
Click Submit to complete the connection. The initial sync runs in the background, and GMV Max data appears once the first sync finishes.
What gets imported
The connector imports GMV Max campaign performance across four collection levels — Campaign, Product, Creative, and Livestream — including spend, GMV, orders, ROAS, live-viewership metrics, and creative delivery metrics, grouped by ad account, store, and campaign. For the complete list of metrics, breakdowns, collection-level rules, and limits, see the TikTok GMV Max data reference.Troubleshooting
A newly linked TikTok Shop store is not appearing
A newly linked TikTok Shop store is not appearing
When the all-stores option is used, the store list is refreshed on every sync, so a newly linked store appears after the next sync. When Select Stores was chosen at setup, the store set is fixed — reconnect the data source and add the new store to include it.
No stores are available to select
No stores are available to select
Only stores that are available for GMV Max on the connected ad account can be included. If the ad account has no GMV-Max-available stores, none will be listed. Confirm the store is enabled for GMV Max on TikTok, then reconnect.
Data stopped updating after a token expired
Data stopped updating after a token expired
This connection does not reconnect automatically when its TikTok token expires. Reconnect the data source and sign in again with the same TikTok account to resume syncing.
Numbers do not match a TikTok Ads data source
Numbers do not match a TikTok Ads data source
TikTok GMV Max and TikTok Ads use different TikTok reporting products, so their figures may not reconcile. Compare GMV Max data against GMV Max, and general ad performance against TikTok Ads.
Related
TikTok GMV Max data reference
Metrics, breakdowns, collection levels, and limits for TikTok GMV Max.
TikTok GMV Max FAQs
Common questions and expected behaviors for the TikTok GMV Max data source.
How to connect TikTok Ads
Connect general TikTok ad-account and campaign performance.
How to connect TikTok Organic
Connect owned TikTok account analytics.
