TikTok

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 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. 

Limitations

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 Date range*, Sync type, Sync frequency, Time, and Timezone.

    NOTE: *If the Data range is available to select, you can load historical data. Read more in our guide.

    Data Sources - Snapshotting

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

    Also, you can see the full list of the metrics you selected by clicking on Show all Metrics and attributes, in the left navigation.

    * 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

  8. Click on Save and your new Data Source is ready.

Congratulations, your new Data Source is ready!


Need assistance?

Feel free to contact us or create a ticket and we will help you with the setup. To speed the process of resolving your ticket, make sure you provide us with sufficient information.