Skip to main content
Skip table of contents

TikTok for Business

You need to do the following to setup the TikTok for Business connector:

  1. Create a TikTok for Business Account.

  2. Register as a developer.

  3. Create a developer app.

  4. Get an app ID and secret from your developer app.

Create a TikTok for Business Account

TikTok for Business's guide on how to create an account can be found here.

Register as a developer

TikTok for Business's guide on how to register as a developer can be found here.

Create a developer app

TikTok for Business's guide on how to create a developer app can be found here. When creating the app set the fields as follows:

Field

Value

Advertiser redirect URL

The OAuth redirect URL of your Cyclr account. This has the format https://{Your Cyclr service domain e.g. app-h.cyclr.com}/connector/callback.

Scope of permission

The following scopes need to be enabled for the connector to function correctly:
Ad Account Management > Ad Account Information > Read Ad Account Information
Audience Management > All

Get an app ID and secret

Find your created app under the My Apps section of the TikTok for business website here. Select the app you want to install the connector using and make note of the App ID and Secret. These are both required to install the TikTok for business connector.

Cyclr setup

The TikTok for Business connector can be used with two different authentication types: Production Installation or Sandbox Installation. The production installation should be used for live production accounts and the sandbox installation should be used for sandbox accounts. The Advertisers > List Advertisers method will not function when using the sandbox installation. Please see the additional information section for details on TikTok for Business sandbox account setup.

Console setup (production)

To setup the TikTok for Business production connector within your Cyclr console:

  1. Go to your Cyclr Console.

  2. Select Connectors > Application Connector Library at the top of the page.

  3. Use the search box to find the TikTok for Business connector.

  4. Select the Setup Required icon.

  5. Enter the below values, omitting this step will allow you to use different settings for each account on installation:

Value

Description

Client ID

The app ID of your TikTok for Business app.

Client Secret

The secret of your TikTok for Business app.

  1. Select Save Changes.

Account setup (production)

You will be asked for the following values when installing the TikTok for Business production connector within an account:

Value

Description

Environment

The environment to install the TikTok for Business connector in. Select Production.

Client ID

The app ID of your TikTok for Business account, if you did not enter this in step 5 above.

Client Secret

The secret of your TikTok for Business account, if you did not enter this in step 5 above.

Account setup (sandbox)

You will be asked for the following values when installing the TikTok for Business sandbox connector within an account:

Value

Description

Environment

The environment to install the TikTok for Business connector in. Select Sandbox.

API Key

The access token of your TikTok for Business app sandbox ad account.

TikTok for Business sandbox account setup

TikTok for business has sandbox account functionality for testing. For more information on how to set up the sandbox account, see the TikTok for Business guide.

Make note of the Access Token you generate when you set it up as you need it to install the sandbox installation version of the connector.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.