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:
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
| 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.
Updated about 2 months ago