With the AgencyAnalytics TikTok Ads integration, you can easily build a dashboard or automated report to understand your client's campaign performance, audience insights, and conversion effectiveness to maximize campaign ROI.
API and Data Access
365 days of historical data warehoused
Initial sync can take 8–48 hours to complete, with larger accounts potentially experiencing longer delays
🔌 Connect TikTok Ads
To avoid a failed connection or error when integrating TikTok Ads to a Client, the person connecting must have the following access:
Read Campaigns
Reporting
Ad Account Information
Read Custom Audiences
If the above requirements are met, simply follow these steps to connect:
Open the Client where you'd like to connect TikTok Ads, then click the Data Sources tab at the top.
Click the blue Connect Data Source button in the upper right corner of the page.
Search for TikTok Ads in the search bar at the top, then click the TikTok Ads card.
Click the gray + sign at the bottom to launch the authorization window, then follow the prompts in the OAuth window to verify and finalize the connection.
First, ensure this is the correct TikTok Ads account and profile. If it's not, use the Switch Account button to flip to the correct one.
Under "Access Your Ad Account For", all four options must be checked off for the integration to connect properly. Verify they are, then click Confirm in the bottom right to move to the next step.
Next, TikTok Ads will show a popover asking you to verify your email address. Click Send Code to launch another verification window (this one confirms you are human).
Solve the object puzzle, then click confirm. This will send you an email containing an authorization code and start a 60-second timer for using this code.
Retrieve the code from your inbox, enter it, and then click verify once more to complete the verification and authentication of TikTok Ads.
Your TikTok Ads account is now fully authenticated and verified. It will show in the list of available accounts. Click the circle to the left of the account name, then Connect in the bottom left of the window.
This will finalize your connection to TikTok Ads, and you can now get started adding widgets to your dashboards and reports!
Best Practices for Maintaining Accurate Data
Avoid reconnecting TikTok accounts unless explicitly required by an authorization error.
Monitor the TikTok integration dashboard to track sync progress and connection details.
Regularly refresh your dashboard after initial sync periods to ensure data updates.
Troubleshooting TikTok Ads errors or connection issues
TikTok Ads has a multistep authorization process. All four steps of the above steps must be completed, and the appropriate permissions authorized, in order for data to pull in.
If no data is flowing into AgencyAnalytics, or you're seeing errors on widgets, reauthorization should resolve this. Follow the same connection steps above, taking special care to review the potential issues below.
Click Connect New Account at the bottom of the connection page
When reauthorizing, avoid selecting an existing account from the connection list, instead make sure to click Connect New Account at the bottom. This ensures you are starting the reauthorization from scratch.
Ensure the correct account is selected
In the top part of the permissions window you'll find the account name and authorizing email address. Ensure the correct account name is listed here. If not, click Switch Account to flip to the correct one.
Ensure all permissions are selected
In the same permissions window referenced above, ensure all four permissions are selected under Access Your Ad Account For before confirming. If one of these is missed, we won't have full access to the TikTok Ads API that allows us to pull data.
If you've followed the steps in this article exactly, carefully considering the above mentions and are still having issues, please reach out to our Support team for assistance. When you do, include a screenshot of the AgencyAnalytics section of the authorizations page in TikTok Ads.
Match the screenshot to the one above to ensure all the connection information and scope of permissions is visible to us in Support.
❓ TikTok Ads FAQ
Why am I getting errors or issues when connecting TikTok Ads?
Integrating TikTok Ads can sometimes result in errors due to cached sessions or incorrect account selection. Use an incognito/private browsing window to avoid cached sessions and authenticate with the intended TikTok account. If the wrong account connects, clear your browser cache and retry the connection process. For more details, review our help article here.
Is TikTok Ads data being reported in real-time?
There is a one-day delay in general data syncing, but follower metrics may experience a 2–3 day delay due to API processing. We recommend excluding the most recent 2–3 days from your reporting period.
Why are there discrepancies in my data?
Data concerning the last four days may not be entirely precise, as TikTok is still collecting metrics for reporting. Have no fear; we re-fetch batches after four days to guarantee their accuracy.
Additionally, reconnecting a TikTok account triggers a full data re-fetch, which can temporarily display incorrect metrics until the sync completes. Sudden drops in follower data may occur as TikTok’s API recalculates recent data, but these numbers correct themselves automatically.
💬 Need additional help?
If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help 😄