TikTok

This guide explains how to set up the TikTok UA data grabber in the Magify analytics system.

The grabber enables automated import of user acquisition data such as campaign spend, impressions, clicks, installs, and other key performance metrics directly from your TikTok Ads account (via the TikTok Marketing API) into your analytics pipeline.

Getting Started

1. Navigate to Configurations > Integrations > UA Grabbers in the Magify interface.
2. Find TikTok in the list and click Add Grabber to create a new data source.
3. A configuration form will open.

This form is used to connect Magify to your TikTok account by providing the required credentials (App ID, App Secret), selecting the grabbers, and specifying a custom integration name.

General Settings

Form Overview

• Top Section – General connection parameters: integration name, organization, and API credentials.
• Grabbers Section – Enable the required TikTok UA data grabbers.

Each field in the form is described below.

Name

A descriptive name for the grabber configuration. Helps identify the data source among other integrations.

Recommended format: TikTok Grabber [CompanyName]

Optional field – recommended to fill in for easier navigation.

Organization

Select your organization from the dropdown list.

Create a TikTok Developer App (If You Don’t Have One)

Before connecting Magify to TikTok, make sure you have:

1. Created a TikTok For Business account.
2. Registered as a developer. Guide: Register as a developer.

3. Click Submit. After submission, your app will display the status Your app is currently pending approval. You will not be able to access the App ID and App Secret until the app is approved by TikTok.

App ID and App Secret

Once your TikTok developer app is approved, you can access the credentials needed to complete the integration:

1. Go to TikTok for Business Developers > My Apps > [Your App].
2. Copy both values and paste them into the Magify integration form.

Grabbers Section

Use this section to configure TikTok UA data grabbers for synchronization.

Each field serves the following purpose:

TikTok UA Grabber Audience

Required field for configuring the Audience-level grabber. This grabber imports user acquisition data, including aggregated metrics by audience attributes (e.g., country, platform) and detailed metrics at the ad ID level for performance analysis.

• Name – Specify a unique name for this grabber configuration. For example:Marketing API Audience [Your Company Name]
• Is Enabled – Enable this option to start collecting data immediately. If left unchecked, the configuration is saved but inactive.

TikTok UA Grabber Basic (iOS)

Required field for configuring the Basic iOS data grabber. This grabber imports detailed performance data at the ad ID level for iOS campaigns.

• Name – Specify a unique name for this grabber configuration. For example: Marketing API iOS Basic [Your Company Name]
• Is Enabled – Enable this option to start collecting data immediately. If left unchecked, the configuration is saved but inactive.

Authorize in TikTok and Get Access Token

After completing all fields in the form, click Save to store your settings.

Then, in the Top Section, click the blue Authorize in TikTok button. You will be redirected to TikTok's authorization page. Grant the requested permissions and click Confirm.

Once authorization is complete, you will be redirected back to the integration form in Magify. The Access Token field will be populated automatically.

Saving the Configuration

Once all required fields are filled in, click Save to complete the setup. The enabled grabber will then begin collecting data from TikTok according to the configured schedule.

By default, each grabber is set to load data for one day upon creation.

If you need to collect data for a longer period (e.g., for initial setup or data recovery), please contact us. We can manually adjust this value for you.