Available Metrics

Dataddo can extract all the metrics provided via an official API. The full list is available here.

NOTE: The connector does not include every metric available in the API. We are releasing new fields weekly. If you are missing an important metric, contact us or create a ticket.

Different Data range

Depending on the Dimension and Report Type, the Data Range may vary significantly, therefore when configuring the connector, take into consideration:

  • If Time Dimension contain stat_time_day, the query time range can not exceed 30 days, and when dimensions contain stat_time_hour, the query time range cannot exceed 1 day.
  • If no time dimension is chosen for or Report Types basic, audience, and playable, it should be possible to have access to older data.

How to create a TikTok Data Source

Number 1

Sign in to your Dataddo account and click on Sources at the top of the page. Home Page - Data Source

Number 2

Click on Create Source in the top right corner.Data Sources - Create Source

Number 3 From the list of sources, choose TikTok. You can type the name into the search bar to find the connector faster.
TikTok - step 3
Number 4 Choose the TikTok Account and Adviser you want to connect and click on Next. TikTok - step 4

Add new account
If you want to connect a TikTok account, which is not on the list, click on Add Account. You will be redirected to the TikTok signup page to confirm the right account. Once you confirm, you will be redirected back to the Dataddo app.
TikTok - step 4 add new account

TikTok - step 4 sign up

b) Authorize TikTok Account
If you have not authorized your TikTok Account with Dataddo, click on Authorize and you will be redirected to your account to log in.
TikTok - step 4 authorization
After you log in and give Dataddo the necessary permissions to access your data, you will get redirected back to the connector.
Number 5

Choose a name for your Data Source, select the Report Type, Data Level, ID Dimension, Time Dimension, and Audience Dimension from the drop-down lists. Then select Metrics, and the Data Labels. To continue to the next page, click Next.

NOTE: You can only choose one of each dimension.

TikTok - step 5a
TikTok - step 5b

Number 6

On the snapshotting page, you can set up the destination configuration. To help you with the snapshot mapping, we make it easier for you to create a connection to the destination based on your preference.

  • a) Click on the option Dashboarding App if you want your data to connect to applications such as Google Data Studio, Power BI, or Tableau.
  • b) Click on the option Data Warehouse, if you want your data to be sent to warehouse storage, e.g., MySQL, Big Query, or PostgreSQL.
TikTok - step 6
Number 7

Configure your snapshotting preferences by choosing your Data range*, Sync type, Sync frequency, Time, and Timezone. Confirm your setup by clicking on Next.

NOTE: *If the Data range is available to select, you can load historical data. Read more about it in our guide. Some Report Types allow only up to 30 days of past data.

TikTok - step 7

Number 8 In the last step, you can preview your data. Click on Save and your new Data Source is ready.
TikTok - step 8 preview


Broken view / Error message
If you cannot see a preview of your data, go back a few steps and check your setup. The most common causes are: 
  • Date range - we recommend a smaller date range. If you need to load historical data, check our guide.
  • Invalid metrics, attributes or breakdowns, or their combination - you may not have any values for them.
TikTok - step 8 error

Congratulations, your new Data Source is ready!

Need assistance?

Feel free to contact us or create a ticket and we will help you set up the Data Source.