TikTok

📘
For more information on the TikTok API check out the docs [here]

Set up

You will need your advertiser ID and TikTok login credentials (username/email & password)

Features

Feature	Support	Notes
Backfill	✅	2 years for the reports, 5 years for Adverts and all data for Ad Groups and Campaigns
Incremental	✅	Supported on Audience and Basic reports. Not supported on others.
API reliability	🟢	Reliable

Reports detail

⬇️ Report	🔑 Incremental key	🔑 Primary key	📄 Link to API endpoint
Basic	`date - 1`	`ID`	Basic Reports
Audience	`date - 1`	`ID`	Audience Reports
Interest Categories	`N/A`	`ID`	Interest Categories
Adverts	`N/A`	`AD_ID`	Ads
Ad Groups	`N/A`	`ADGROUP_ID`	Ad Groups
Campaigns	`N/A`	`CAMPAIGN_ID`	Campaigns
Pixels	`N/A`	`PIXEL_ID`	Pixels

📘
Usage

For Basic and Audience Reports, the TikTok Connector calls the reporting endpoint to run daily aggregated synchronous reports on Auction Ads data.

Basic reports are a type of report from which you can get the most comprehensive data about your ads, including spend and performance data, video play data, engagement data, as well as data for in-app and website events.

Audience reports are a type of report from which you can get audience data, including age, gender, region, or interest. The data level and grouping is all customisable in the extract setup.

🚧
API Limitation
Due to data latency from the API, data from the previous day will potentially not be correct for up to 10-12 hours. Therefore the incremental runs will append duplicate the most recently appended day of data to ensure that it is up to date.

🚧
Authentication changes for the TikTok Connector (v0.0.5 and newer)
Connector version 0.0.5 and above
Starting with version 0.0.5, authentication has been simplified. To set up the TikTok connector, you only need:
Your Advertiser ID
Your TikTok login credentials
No additional authorization steps are required.
Connector versions below 0.0.5
If you are using an older version of the connector, additional setup is required due to the legacy authentication configuration.
To proceed:

Contact your Kleene CSM to coordinate the setup.

You will be asked to visit the following authorization URL:

https://business-api.tiktok.com/portal/auth?app_id=6955582889631154177&state=your_custom[…]&redirect_uri=https%3A%2F%2Fapp.kleene.ai%2Fcallback.html

Log in to TikTok and grant the requested permissions.

After authorization, you will be redirected to a new URL.

Copy the full redirected URL and send it to your Kleene contact. The correct URL will contain an auth_code parameter.

Once received, the Kleene team will complete the connector configuration for you.

🚧
Connector up-versioning
If you upgrade your connector from a version earlier than 0.0.5 to version 0.0.5 or later, you must re-authenticate the Source for the connector to continue working.