TikTok

• Introduction
  • An example of operation
  • Data schema
• Configuration
  • Before you start
  • Start creating the module
  • Initial settings
  • Authorization with TikTok
  • Setting the module in the schedule

Introduction

The TikTok module allows you to automatically collect your ads system data.

An example of operation

1. We configure the module in the platform by granting access to the TikTok
2. We set the module on the schedule - the data will be collected and stored in witcloud dataset
3. After the table is processed, you can use other reporting modules or combine it with analytics

Data schema

One new table will appear in your WitCloud dataset:

Expand for the data schema

Field name	Type	Mode
date	STRING	NULLABLE
campaign_id	STRING	NULLABLE
campaign_name	STRING	NULLABLE
cost_per_conversion	FLOAT	NULLABLE
real_time_conversion	INTEGER	NULLABLE
cpc	FLOAT	NULLABLE
conversion_rate	FLOAT	NULLABLE
frequency	FLOAT	NULLABLE
real_time_conversion_rate	FLOAT	NULLABLE
impressions	INTEGER	NULLABLE
real_time_cost_per_result	FLOAT	NULLABLE
conversion	INTEGER	NULLABLE
real_time_result	INTEGER	NULLABLE
cost_per_secondary_goal_result	STRING	NULLABLE
secondary_goal_result_rate	STRING	NULLABLE
clicks	INTEGER	NULLABLE
cost_per_1000_reached	FLOAT	NULLABLE
reach	INTEGER	NULLABLE
real_time_cost_per_conversion	FLOAT	NULLABLE
cpm	FLOAT	NULLABLE
ctr	FLOAT	NULLABLE
result_rate	FLOAT	NULLABLE
secondary_goal_result	STRING	NULLABLE
cost_per_result	FLOAT	NULLABLE
real_time_result_rate	FLOAT	NULLABLE
spend	FLOAT	NULLABLE
result	INTEGER	NULLABLE

Configuration

Before you start

Make sure you have adequate accesses to the TikTok ad account

Start creating the module

From the menu on the left, select the Collect tab, then click the Add new data Collect button**

Select "TikTok" from the list of available modules

Initial settings

In the first step, we only have one field to fill.

Collect name - the name of our module. It will be visible under this name elsewhere on the platform.

Authorization with TikTok

In the next step, we need to grant WitCloud access to TikTok. It is necessary for WitCloud to be able to download data. This can be done using the TikTok OAuth method

To do this, press the Click here to authorize button

Authorize via the login form

After proper authorization, select your advertiser from the list and click Finish button

Setting the module in the schedule

Your module is now created in WitCloud 📊. The final step is to determine the time range for which you need to retrieve historical data. The schedule for retrieving current data will be created automatically.

Enter the appropriate range and click the Finish button.