• 3 Minutes to read
  • Dark


  • Dark

Available Metrics

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


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.

Different Date 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 contains stat_time_day, the query time range cannot 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.

For Audience Report, the latency time is between 6-12 hours. We recommend to keep the date range until YESTERDAY.


Metric and ad recall data may not match

The problem with reach and ad recall metrics is that these metrics cannot be simply summed to get the totals for longer periods. The reason for this is that these metrics are measuring the daily unique users, who either see your ad (reach) or will remember the ad (ad recall). It is not possible to get data for a specific period and keep aggregating them.

  1. One option is to get the daily breakdown and then the daily values will match, but not when summing over more days.

  2. The second solution is to get the data weekly or monthly and again, these weekly/monthly values will match TikTok exactly.

    1. The way to achieve this is to create a new source and then a new flow with the particular breakdown (for example, source and flow with daily breakdowns/synchronizations)

Read more about the metrics, why the data may not be matching here.

How to Create a TikTok Data Source

  1. Sign in to your Dataddo account and click on Sources at the top of the page.

  2. Click on Create Source in the top right corner.

  3. From the list of sources, choose TikTok. You can type the name of the connector into the search bar to find it faster.
    Data sources - choose connectors

  4. From the drop-down menu, choose the TikTok Account and Adviser you want to connect and click on Next.
    TikTok - step 4

    1. Didn't find your account?
      If you want to connect a new account that is not on the list, click on Add new Account at the bottom of the drop-down. You will be redirected to the authorization/sign-in page to confirm the right account. Once you confirm, you will be redirected back to the Dataddo app.

    2. Authorize Your Account
      If you have not authorized your Account with Dataddo, click on Add new Account and you will be redirected to the authorization/sign-in page.

    3. After you log in and give Dataddo the necessary permissions to access your data, you will be redirected back to the connector.

  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
  6. Configure your snapshotting preferences by choosing your Sync frequency. Under Advanced setting,s you can select the exact Time, of synchronization. Confirm your setup by clicking on Next.
    If the Data range is available to select, you can load historical data. Read more in our guide.

  7. Before saving the source, you can see a preview of your data by clicking on the Preview button. you can adjust the date range to a more specific view.

    • Also, you can see the full list of the metrics you selected by clicking on Show all Metrics and attributes, in the left navigation.
      Data source - create - preview
  8. Click on Save and your new Data Source is ready.

Congratulations, your new Data Source is ready!


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.
    Data source -create- error

Need assistance?

Was this article helpful?

What's Next