TikTok Ads: Setup guide

TikTok Ads: Setup guide#

This guide explains how to collect data from TikTok Ads.

Introduction#

For a list of the fields that you can collect from TikTok Ads, see TikTok Ads.

Note

If you want to collect TikTok Shopping campaign data, use the TikTok Ads (GMV Max) connector instead.

Limitations#

Collecting data from TikTok Ads comes with the following limitations:

  • You cannot fetch data with a weekly or monthly breakdown from TikTok Ads. You can only fetch data with daily or lifetime granularity.

  • You cannot use ad_id_v2 dimension together with the ad_id dimension.

  • The date range of a single fetch cannot exceed 365 days.

Creating a datastream to collect data from TikTok Ads#

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from TikTok Ads.

Authorization: Allow Adverity to access TikTok Ads#

  1. If you choose Access using your credentials or Access using someone else’s credentials, in Set up or edit Advertisers, you or the person granting access must choose one of the following options:

    • Choose Grant access to all items, including those created in the future to give Adverity Advertisers to access all existing items and all items created in the future.

    • Choose Select specific items to which you want to grant access to only give Adverity Advertisers to access the selected items. Adverity will not automatically have access to items created in the future. You will need to grant Adverity access to any items created in the future.

    Warning

    If you use your credentials to grant Adverity access to TikTok Ads, all the items available to you using your credentials will be visible in the Authorizations page to all Adverity users with permission to edit this authorization.

    If someone else uses their credentials to grant Adverity access to TikTok Ads, the same applies to the items available using their credentials.

    This is important to consider if you do not want all Adverity users with permission to edit the authorization to be able to see the details of the authorization items. For more information about user permissions, see Managing user permissions.

Configuration: Choose the data you want to collect from TikTok Ads#

Note

This connector reports data in Coordinated Universal Time (UTC).

To choose what data to collect and customize the TikTok Ads datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  2. In Report type, select the type of data to collect from TikTok Ads. The fields you need to configure in the following steps differ according to the report type you select.

  3. In Service type, select the ads type you want to collect.

    Note

    Adverity supports the Auction Ads service type by default. The Reservation Ads service type is a beta feature of TikTok Ads. You need to apply for beta to have access and be able to use it in Adverity.

  4. In Buying type, select the buying type for which to collect data. You can select from the following options:

    • AUCTION

    • RESERVATION_TOP_VIEW

    • RESERVATION_RF

    This field is only visible when Report type is set to Basic.

  5. In Data level, select the data level for which to collect data.

  6. In Period, select the time period that you want to use to group your data.

  7. In Advertisers and Campaigns, select the advertisers and campaigns for which to collect data. For Advertisers, you can select from the following options:

    • Include all: Collects data for all available advertisers.

    • Include some: Collects data only for the advertisers you select.

    • Exclude some: Collects data for all advertisers except those you select.

  8. (Optional) To include deleted ads in your data, select the Include deleted ads checkbox. This field is visible when Report type is set to Metadata and Data level is set to Ad.

  9. (Optional) To include deleted ad groups in your data, select the Include deleted ad groups checkbox. This field is visible when Report type is set to Metadata and Data level is set to Ad Group.

  10. In Material type, select the type of creative materials to collect.

  11. In Date filter, select for which dates you want to collect data. If you select Lifetime, all available data will be collected.

  12. In Dimensions, Metadata fields, Metrics, and Fields, change the list of fields that you want to see in your data extract.

  13. Select the Report metrics in UTC checkbox to report all returned metrics in UTC+0 for all advertisers.

What’s next?#

Advanced TikTok Ads tips#

Supported dimensions for different report types#

Each TikTok Ads report type supports different dimensions and combinations of dimensions. The links below will take you to the TikTok Ads documentation, where you can see the supported dimensions and dimension grouping for each report type.

Click the name of a report type to find out more:

Contents