# TikTok

# 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:

image alt text

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

image alt text

Select "TikTok" from the list of available modules

image alt text

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

image alt text

# 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

image alt text

Authorize via the login form

image alt text

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

image alt text

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

Last updated: 2023-07-05T14:12:16.000Z