TikTok Shop: Setup guide

On this page

This guide explains how to collect data from TikTok Shop.

Introduction

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

Creating a datastream to collect data from TikTok Shop

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

Authorization: Allow Adverity to access TikTok Shop

TikTok Shop offers two authorization types:

TikTok Shop: Use this authorization type to collect data from TikTok Shop marketplaces outside of the United States.
TikTok Shop US: Use this authorization type to collect data from the US marketplace.

Select the authorization type that corresponds to your marketplace region.

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 Shop, 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 Shop

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

(Optional) Rename your datastream.
In Shops, select the shop from which you want to collect data. If you leave this option empty, Adverity will collect data from all available shops.
In Report type, select the type of data to collect from TikTok Shop.
For the Order detail report type, in Order status, select the order statuses to include in your reports. You can select multiple statuses, including “UNPAID”, “ON_HOLD”, “AWAITING_SHIPMENT”, “AWAITING_COLLECTION”, “IN_TRANSIT”, “DELIVERED”, “COMPLETED”, “CANCELLED”, and “PARTIALLY_SHIPPING”.
For the Order statement report type, in Level, select the level at which to collect data.
In Date filter, select the field that you want to use to define the fetch date range.
In Fields, change the list of fields that you want to see in your data extract.

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.