Links

TikTok

Setting up TikTok Ads Manager as as a destination and exporting your audiences to TikTok Ads Manager.
TikTok Ads Manager is an advertising platform to which you can export your audiences for real time ad targeting based on your own first party data.

Adding TikTok as a Destination

From the UI
From the CLI
You can create a new TikTok destination from your DCN by going to the Integrations -> Destinations section in your navigation menu or by using the CLI. (see above tab).
TikTok Ads Manager destination form
To add your TikTok account, you will need to enter the name of this destination (this is how your destination will appear in the listing), and click on Connect. You will be redirected to TikTok Ads Manager in order to authenticate and grant your DCN access to your advertiser account. This is done via OAuth 2.0, which will prompt you to login into your ads manager account or ask for approval if you are already logged in.
Allow your DCN to push audiences to your TikTok account
Once confirmed, you will be redirected to your DCN and will see that the advertiser ID field is automatically populated if you have access to one account. You will be able to select from a list of advertiser accounts if you have access to many. Note: One destination can only support one advertiser account, if you would like to link your other advertiser accounts, you will have to create a new destination in your DCN.
From the CLI, enter the following:
optable-cli destination create tiktok <name>
You will then be redirected to your browser to link your TikTok Ad Manager account to your DCN.
Here is an example of the expected CLI output:
{
"id": 6,
"kind": "DESTINATION_KIND_TIKTOK",
"created_at": "2022-09-28T14:12:01.196007420Z",
"updated_at": "2022-09-28T14:12:01.196007420Z",
"name": "TikTokfromCLI",
"state": "DESTINATION_STATE_ACTIVE",
"tiktok": {
"advertiser_id": "suwujsl"
}
}
Finally, if you created the destination using your DCN UI you will be redirected to the destinations listing. If you used the CLI, you will be able to export directly from the command line.

Exporting Audiences to TikTok

From the UI
From the CLI
To export to your TikTok account, navigate to the audience you want to export and click export in the top right. From there you will be asked to select your preferred TikTok export destination from a list of all available destinations.
TikTok export form
When exporting to TikTok, an audience will be created with the name of the audience and a unique audience ID will be populated in your DCN. For updates to an audience, you can append or replace to an audience, so when re-exporting an audience, all new IDs will be can either be appended or replaced in your advertiser account.
From the CLI, enter the following:
optable-cli export create tiktok <audience-id> <destination-id>
Where:
<audience-id> Audience to export
<destination-id> Destination of the export
You can choose which ID or update method to send with:
--identifiers-filter=IDENTIFIERS-FILTER,...
Filter identifiers by type. Options are: email,
idfa, gaid, phone. The options are mutually
exclusive except for idfa and gaid which can
be combined. Defaults to idfa and gaid.
--export-action=EXPORT-ACTION,...
Specify export action: [append, replace]
Defaults to replace.
Here is an example of what your command should look like:
$ optable-cli audience export tiktok 8 1
Here is an example of the expected CLI output:
{
"id": 94,
"created_at": "2022-09-28T14:16:13.956080408Z",
"updated_at": "2022-09-28T14:16:13.956080408Z",
"destination": {
"id": 6,
"kind": "DESTINATION_KIND_TIKTOK",
"created_at": "2022-09-28T14:12:01.196007Z",
"updated_at": "2022-09-28T14:12:01.196007Z",
"name": "TikTokfromCLI",
"state": "DESTINATION_STATE_ACTIVE"
},
"audience": {
"id": 119,
"name": "My TikTok Audience",
"kind": "AUDIENCE_KIND_QUERY",
"created_at": "2022-08-18T16:39:37.823716Z",
"updated_at": "2022-09-08T12:40:32.432216Z",
"insights_computed_at": "2022-09-08T12:40:32.429581Z",
"state": "AUDIENCE_STATE_ACTIVE",
"activation": {
"keyword": "5dcfkl9dc"
}
},
"state": "EXPORT_STATE_PENDING",
"identifiers_filter": [
"ID_KIND_APPLE_IDFA",
"ID_KIND_GOOGLE_GAID",
],
}
}

What Can I Export to TikTok?

You can export emails, phone numbers, IDFAs and GAIDs to your TikTok destination. TikTok does not allow pushing empty audiences, please ensure that the audience you selected contains the ID(s) you wish to export.
TikTok only supports one type of ID per export with the exception of IDFAs and GAIDs which be combined together.
For example, if you have an audience that contains emails, phones and GAIDs. TikTok will require you to create three separate exports for it. You can use the duplicate action in your exports to facilitate creation of exports.

How Will My Export Appear in TikTok?

Your export will appear under Assets > Audiences, in your advertiser account typed as Customer File. The audience name will follow the following pattern when created in your advertiser account: Optable Audience ID - Optable Audience Name - Encryption Type.
Encryption type is based off TikTok's definitions, which can be found here under Encryption Type.
The audience size is not deterministic on TikTok's side, meaning that the audience size will fluctuate for the same audience if a re-export is triggered.