The AgencyAnalytics TikTok Ads integration lets you build dashboards and automated reports that show your client's campaign performance, audience insights, and conversion effectiveness. Connecting TikTok Ads helps you and your clients understand what's driving campaign ROI without logging into TikTok Ads directly.

See all available TikTok Ads metrics to learn what's possible with this integration.

To avoid a failed connection or error when integrating TikTok Ads to a Client, the person connecting must have the following access in TikTok Ads:

Also, keep these data details in mind:

Once you have the required TikTok Ads access listed above, follow these steps to connect the integration to a Client.

Step 1: Open the Client where you'd like to connect TikTok Ads, then click the Data Sources tab at the top.

Step 2: Click the blue Connect Data Source button in the upper right corner of the page.

Step 3: Search for TikTok Ads in the search bar at the top, then click the TikTok Ads card.

Step 4: Click the gray Plus (+) sign at the bottom to launch the authorization window, then follow the prompts in the OAuth window to verify and finalize the connection.

Step 5: Confirm the correct TikTok Ads account and profile appears. If it's not the right one, click Switch Account to select the correct account.

Step 6: Under Access Your Ad Account For, verify that all four permission options are checked off. All four must be checked for the integration to connect properly. Click Confirm in the bottom right to continue.

Step 7: When TikTok Ads shows a popover asking you to verify your email address, click Send Code to launch a verification window.

Step 8: Solve the object puzzle, then click Confirm. This sends an email containing an authorization code and starts a 60-second timer for using it.
​

Step 9: Retrieve the authorization code from your inbox, enter it, then click Verify to complete verification and authentication of TikTok Ads.
​

Step 10: Your TikTok Ads account is now authenticated and appears in the list of available accounts. Click the circle to the left of the account name, then click Connect in the bottom left of the window to finalize the connection.
​

Once you click Connect, TikTok Ads is fully connected, and you can start adding widgets to your dashboards and reports.

Follow these tips to keep your TikTok Ads data accurate after connecting:

Errors when integrating TikTok Ads are often caused by cached browser sessions or selecting the wrong account. Use an incognito or private browsing window to avoid cached sessions, then authenticate with the intended TikTok Ads account. If the wrong account connects, clear your browser cache and retry the connection process.

See our detailed TikTok Ads errors and connection issues article for more.

TikTok Ads has a multistep authorization process, and all steps in the connection flow must be completed with the correct permissions authorized before data can pull in. If no data is flowing into AgencyAnalytics, or you're seeing errors on widgets, reauthorizing usually resolves it. Follow the same connection steps described above in Connect TikTok Ads, paying special attention to these checks:

Step 1: When reauthorizing, avoid selecting an existing account from the connection list. Instead, click Connect New Account at the bottom of the connection page to start the reauthorization from scratch.

Step 2: In the top part of the permissions window, check the account name and authorizing email address. Make sure the correct account name is listed. If it's not, click Switch Account to select the correct one.

Step 3: In the same permissions window, make sure all four permissions under Access Your Ad Account For are selected before confirming. Missing even one means AgencyAnalytics won't have full access to the TikTok Ads API needed to pull data.
​

If you've followed these steps exactly and are still having issues, contact our Support team for help. Include a screenshot of the AgencyAnalytics section of the TikTok Ads authorizations page so Support can see your full connection information and permission scope.

Match the screenshot to the one above to ensure all the connection information and scope of permissions are visible to us in Support.

No. There's a one-day delay in general data syncing, and follower metrics may see a 2 to 3-day delay due to API processing. We recommend excluding the most recent 2 to 3 days from your reporting period.

TikTok Ads often finalizes its metrics with a 3- to 4-day delay. During that window, metrics for recent days may change as TikTok completes processing.

AgencyAnalytics automatically refetches data after this window to align with TikTok's finalized values. Reconnecting a TikTok Ads account also triggers a full data re-fetch, which can temporarily show incorrect metrics until the sync completes. Sudden drops in follower data can occur as TikTok's API recalculates recent numbers, but these correct themselves automatically.

Discrepancies can arise from differences in data processing timelines, metric definitions, and aggregation methods. For example, TikTok's native dashboard reports Reach as unique users, while the TikTok API shares data at the ad level. This can result in higher Reach figures showing in AgencyAnalytics compared to the native platform.

If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help 😄