Before you connect
The following are required:- A TikTok Ad account.
- A TikTok Ads Manager account with admin or operator-level access to the ad account being connected.
- If TikTok Business Center is used, the ad account must be added to it before connecting.
- A live TikTok Pixel, if conversion events should flow into dashboards — only events TikTok is already receiving will appear.
Connect TikTok
1
Authorize a TikTok Ads Manager account
On the Data Sources page, search for TikTok and select it. Sign in to the TikTok business account in the pop-up window, then click Confirm to grant access to the TikTok Ad account.
2
Select the ad accounts
On the data source settings, choose the Ad accounts to connect from the dropdown list.
3
Submit
Click Submit to complete the connection. The initial sync runs in the background and data can take up to one business day to appear.
What gets imported
The connector imports the full campaign hierarchy (ad account → campaign → ad set → ad), standard performance and engagement metrics, video metrics, hundreds of TikTok Pixel conversion events grouped by category (e-commerce, app, engagement, lead, game), ROAS variants across Day0, Day2, and Day6 attribution windows, and VTA / EVTA attribution metrics. For the complete list of metrics, ROAS window definitions, and breakdown coverage, see the TikTok Ads data reference.Troubleshooting
Pixel conversion events are not appearing
Pixel conversion events are not appearing
Only events that TikTok Ads Manager is receiving can be displayed. Verification should start in the Events tab of TikTok Ads Manager to confirm the pixel is firing. If TikTok shows events but dashboards do not, allow up to 24 hours after connecting for the initial sync to complete.
ROAS numbers do not match TikTok Ads Manager
ROAS numbers do not match TikTok Ads Manager
Attribution window differences are the most common cause. TikTok defaults to specific windows in its UI, while the connector exposes Day0, Day2, and Day6 ROAS variants. The selected metric must match the window being compared against in TikTok.
Custom Pixel events show as internal IDs
Custom Pixel events show as internal IDs
Custom events configured in TikTok Ads Manager may surface under their TikTok-internal IDs unless a friendly label has been set in TikTok.
Token expired error
Token expired error
Auth tokens occasionally expire. Reconnect via Connections → TikTok Ads → Reconnect and sign in again with the same TikTok account.
Related
TikTok Ads data reference
Metrics, breakdowns, ROAS windows, and limits for TikTok Ads.
TikTok Ads FAQs
Common questions and expected behaviors for the TikTok Ads data source.
How to connect TikTok Organic
Connect owned TikTok account analytics.
How to connect TikTok GMV Max
Connect TikTok GMV Max campaign data.
