You need to do the following to setup the TikTok For Business Connector:
- Create a TikTok for Business Account.
- Register as a developer.
- Create a developer app.
- Get an app ID and secret from your developer app.
Create a TikTok for Business Account
TikTok for Business’ guide on how to create an account can be found here.
Register as a developer
TikTok for Business’ guide on how to register as a developer can be found here.
Create a developer app
TikTok for Business’ 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 | Enter your Cyclr Console’s Callback URL. |
| Scope of permission | The following scopes need to be enabled for the connector to function correctly: * Ad Account Management > All* Ads Management > All* Audience Management > All* Creative Management > Image Management > Read Image Library, Create and Update Images* Creative Management > Instant Page Management > Instant Page Management* Creative Management > TikTok Posts Management > Query TikTok Posts, Authorize TikTok Posts, Create Identity, Query Identity, Delete Identity* Lead Management > All |
Note: It can take up to 10 minutes for changes to your app’s Advertiser redirect URL to be active.
During this time you may see errors relating to the URL when trying to authenticate a Connector.
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
- 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 Connector 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 Connector for Production use within your Cyclr console:
- Go to your Cyclr Console.
- Select Connectors > Application Connector Library at the top of the page.
- Use the search box to find the TikTok For Business Connector.
- Select the Setup Required icon.
- 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. |
- Select Save Changes.
Account setup (production)
You will be asked for the following values when installing the TikTok For Business Connector for Production use within an Account:
| Property | 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 Connector for Sandbox use within an Account:
| Property | 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. |