TikTok

Version 0.0.3

📘

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

Set up


Due to the auth configuration, you will need to work with someone from Kleene to set up the TikTok connector so please contact your Kleene CSM if you would like to set it up. They will instruct you to go to this URL:

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

Once you are there please login and grant the requested permissions. This will direct you to a new URL please copy this and send this to us (the correct URL will have an auth_code in it).

Features


FeatureSupportNotes
Backfill2 years for the reports, 5 years for Adverts and all data for Ad Groups and Campaigns
IncrementalSupported on Audience and Basic reports. Not supported on others.
API reliability🟢Reliable

Reports detail


⬇️ Report🔑 Incremental key🔑 Primary key📄 Link to API endpoint
Basicdate - 1IDBasic Reports
Audiencedate - 1IDAudience Reports
Interest CategoriesN/AIDInterest Categories
AdvertsN/AAD_IDAds
Ad GroupsN/AADGROUP_IDAd Groups
CampaignsN/ACAMPAIGN_IDCampaigns
PixelsN/APIXEL_IDPixels

📘

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.