How to Import Data from the TikTok Ads Source

Before proceeding, please make sure that:

You have already created an access token, as described in GETTING_STARTED.md.
You have run OWOX Data Marts and created at least one storage in the Storages section.

TikTok Storage

Create the Data Mart

Click New Data Mart.
Enter a title and select the Storage.
Click Create Data Mart.

TikTok New Data Mart

Set Up the Connector

Select Connector as the input source type.
Click Set up connector and choose TikTok Ads.
Fill in the required fields:
- Access Token – paste the token you generated earlier.
- App ID and App Secret – available in the Basic Information section of your TikTok app.
- Advertiser ID – paste the ID you received together with the access token, or retrieve it directly from TikTok Ads Manager.
Leave all other fields as default and proceed to the next step.

TikTok Input Source

TikTok Fill Data

TikTok ID Secret

TikTok Adv ID

Configure Data Import

Choose one of the available endpoints.
Select the required fields.
Specify the dataset where the data will be stored (or leave the default).
Click Finish, then Save and Publish Data Mart.

TikTok Ads Publish Data Mart

Run the Data Mart

You now have two options for importing data from TikTok Ads:

Option 1: Import Current Day’s Data

Choose Manual run → Incremental load to load data for the current day.

TikTok Ads Import New Data

TikTok Ads Incremental Load

ℹ️ If you click Incremental load again after a successful initial load,
the connector will import: Current day’s data, plus Additional days, based on the value in the Reimport Lookback Window field.

TikTok Ads Reimport