TikTok Ads (GMV Max): Setup guide

This guide explains how to collect data from TikTok Ads (GMV Max).

Creating a datastream to collect data from TikTok Ads (GMV Max)

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 (GMV Max).

Authorization: Allow Adverity to access TikTok Ads (GMV Max)

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 (GMV Max), 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 (GMV Max), 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 (GMV Max)

Note

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

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

1. (Optional) Rename your datastream.

2. In GMV promotion type, select the type of promotion data to collect:

   • Product GMV Max

   • Live GMV Max

   • Overall performance

3. In Advertisers, select the advertisers for which to collect data. 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.

4. (Optional) In Stores, select the stores for which to collect data. Stores are displayed as {store_name} ({store_id}). If you do not select any stores, data for all stores will be retrieved.

5. (Optional) In GMV Max Campaigns, select the campaigns for which to collect data. If you do not select any campaigns, data for all GMV Max campaigns will be retrieved.

   Note

   When GMV promotion type is set to Overall performance, the GMV Max Campaigns field is not available.

6. In Level, select the level of data granularity. The available levels depend on your selected GMV promotion type:

   • For Product GMV Max:

     • If you select Campaign:

       • The campaign_id dimension is required.

     • If you select Product:

       • At least one of item_group_id or campaign_id dimensions is required.

       • For attribute metrics like product_name and product_image_url, the item_group_id dimension is required, and campaign_id is not compatible.

       • For the bid_type metric, exactly one of campaign_id or item_group_id must be selected.

       • For campaign-related metadata fields, the campaign_id dimension is required.

     • If you select Creative:

       • At least one of item_id, item_group_id, or campaign_id dimensions is required.

       • For attribute metrics like title and item_id, the item_id dimension is required, and campaign_id and item_group_id are not compatible.

       • For campaign-related metadata fields, the campaign_id dimension is required.

   • For Live GMV Max: Campaign, Livestream, Duration

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

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

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

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

What’s next?

• Apply Data Mapping to your collected data to harmonize data collected from different sources in Adverity.

• Transform your data to meet your needs by creating and applying transformations to your datastream.

• Load your data into a warehouse to continue working with your data in Adverity.

• Load your data into an external destination of your choice.

Advanced TikTok Ads (GMV Max) tips

Supported dimensions and metrics

The available dimensions and metrics depend on your selected GMV promotion type and Level. Adverity will show you which dimensions and metrics are compatible with your selections.