You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-tiktok-audiences/index.md
+39-43Lines changed: 39 additions & 43 deletions
Original file line number
Diff line number
Diff line change
@@ -6,16 +6,17 @@ hide-boilerplate: true
6
6
hide-dossier: false
7
7
---
8
8
9
-
The TikTok Audiences destination enables advertisers to send Engage audiences to TikTok as Custom Audiences using [TikTok's Segment API](https://ads.tiktok.com/marketing_api/docs?id=1739940504185857){:target="_blank"}.
9
+
The TikTok Audiences destination enables advertisers to send Twilio Engage audiences to TikTok as custom audiences using [TikTok's Audience API](https://business-api.tiktok.com/portal/docs?id=1739940504185857){:target="_blank"}.
10
10
11
11
By using Segment's TikTok Audiences destination, you can increase traffic and drive conversions with hyper-relevant ads that promote product discovery.
12
12
13
13
## Getting started
14
14
15
-
### Note
15
+
### Notes
16
16
17
-
- If you created a TikTok Audiences destination instance before September 25th, 2023, your instance(s) and all subsequent instances are considered _legacy_ instances. To create a new _legacy_ instance, see the [Create a TikTok audience (Legacy)](#create-a-tiktok-audience-legacy) documentation. Users who created their first instance after September 25, 2023 are considered to have _native_ instances. To create a new _native_ instance, see the [Configure the TikTok Audiences destination (Native)](#configure-the-tiktok-audiences-destination-native) documentation.
17
+
- If you created a TikTok Audiences destination instance before September 25th, 2023, your instance(s) and all subsequent instances are considered _legacy_ instances. To create a new _legacy_ instance, see the [Create a TikTok audience (Legacy)](#create-a-tiktok-audience-legacy) documentation. Users who created their first instance after September 25, 2023 are considered to have _native_ instances. To create a new _native_ instance, see [Configure the TikTok Audiences destination](#configure-the-tiktok-audiences-destination) documentation.
18
18
- Both _legacy_ and _native_ instances have the same set of features, but are configured differently. Legacy instances require you to create an audience or action manually, but native instances automatically create audiences and actions.
19
+
- If you update the events names from the default Audience Entered/Audience Exited, please make sure to also update it in the "Add to Audience" and "Remove from Audience" mappings.
@@ -24,28 +25,34 @@ Before connecting to the TikTok Audiences destination, you must have a [TikTok A
24
25
25
26
### TikTok Audience Segments
26
27
27
-
You must create an audience segment in your TikTok Advertising account. You can send Engage audiences to an existing audience segment, or create a new audience. Please note the `audience_id` as this is required to send Engage audiences to TikTok.
28
+
Send Engage audiences to an existing TikTok audience segment or create a new audience. Note the `audience_id` as this is required to send Engage audiences to TikTok.
28
29
29
-
> warning ""
30
-
> You can only send audience data from Segment to a "Partner audience" custom audience in TikTok Ads Manager. While TikTok's UI doesn't allow you to select this custom audience type, you can use this destination's **Create Audience** mapping to create "Partner audience" custom audiences in TikTok.
30
+
### Configure the TikTok Audiences destination
31
31
32
-
#### Create a TikTok Audience (_Legacy_)
32
+
1. From the Segment web app, navigate to **Engage > Audiences**. Choose an existing Engage audience or create a new one. Ensure you are in the Engage space you plan to use with the TikTok Audiences destination.
33
33
34
-
To create an audience in Segment:
34
+
2. Navigate to **Engage > Engage Settings** and click **Destinations**.
35
35
36
-
1. Navigate to New Mapping and select **Create Audience**.
37
-
2. On the Add test event panel, click **Load Sample Event**.
38
-
3. Fill in the mappings on the Select mappings panel accordingly.
39
-
4. On the Send test event panel, click **Test Mapping**.
40
-
5. You've created your audience. Copy the `audience_id` from the response as you will need it to create additional mappings.
36
+
3. Search for “TikTok Audiences” and select the destination. Click **Configure TikTok Audiences**.
41
37
42
-
You can use the same mapping to create as many audiences as you'd like. To create another audience, change the audience name and click **Test Mapping**.
38
+
4. On the Select Source screen, your Engage space should already be selected as the source. Click **Confirm Source**.
43
39
44
-
You can create a duplicate audience since TikTok doesn't restrict users from having multiple audiences with the same name. If you click **Test Mapping**multiple times, you will create audiences with the same name. However, each audience will have its own unique `audience_id`.
40
+
5. On the **Settings**tab for the TikTok Audiences destination, name your destination and authenticate with TikTok Audiences using OAuth.
45
41
46
-
You do not need to update the status of the mapping to `enabled`.
42
+
6. Once authenticated, toggle “Enable Destination” on and click **Save Changes**.
47
43
48
-
For instructions on how to create a TikTok audience segment, see TikTok's [Create/Delete an audience segment](https://ads.tiktok.com/marketing_api/docs?id=1739940583739393){:target="_blank"} docs.
44
+
7. Navigate to the **Mappings** tab, click **New Mapping**, and select **Add to Audience**.
45
+
46
+
8. Navigate to the **Mappings** tab, click **New Mapping**, and select **Remove from Audience**.
47
+
48
+
9. Navigate back to **Engage > Audiences** and click on the audience from step 1.
49
+
50
+
10. Click **Add Destinations** and select the TikTok Audiences destination you just created.
51
+
In the settings that appear in the side panel, toggle the **Send Track** option on and **Send Identify** option off. Provide the [Advertiser ID](https://ads.tiktok.com/help/article/ad-account-information-faq?lang=en){:target="_blank"} linked to the TikTok account that will receive the audience data, as well as the **ID Type** of data you'll be sending. Click **Save Settings**.
52
+
53
+
The setup is complete and the audience will start syncing to TikTok. The audience will appear in your [TikTok Ads Manager](https://www.tiktok.com/business/en-US/solutions/ads-manager){:target="_blank"} account under **Assets > Audiences**. Please note that it can take 24-48 hours for users to appear in TikTok.
54
+
55
+
To sync additional audiences from your Engage space, create a separate mapping in the TikTok Audiences destination. Navigate to **Connections > Destinations**, search and select the TikTok Audiences destination, and follow steps 7-11 above.
49
56
50
57
### Connect the TikTok Audiences (_Legacy_) destination
51
58
@@ -67,47 +74,36 @@ For instructions on how to create a TikTok audience segment, see TikTok's [Creat
67
74
7. Navigate to the **Mappings** tab, click **New Mapping**, and select **Add Users**.
68
75
69
76
8. Under Select mappings, select the TikTok "Advertiser ID" of the audience segment you want to add users to. Input the `audience_id` of that audience segment under "Audience ID." **Note: A separate mapping must be created for each audience segment you plan to send Engage audiences to.**
70
-
> info ""
71
-
> Once you've created the audience using the name of Segment's audience key, you can get the Audience ID from TikTok's Assets>Audiences page. You'll also find the Advertised ID, noted by `aadvid`, over the TikTok URL.
72
77
73
-
9. Repeat Steps 7 and 8 to also set up a **Remove Users** mapping.
78
+
**Note:** Once you've created the audience using the name of Segment's audience key, you can get the Audience ID from TikTok's Assets>Audiences page. You'll also find the Advertised ID, noted by `aadvid`, over the TikTok URL.
79
+
80
+
9. Repeat steps 7 and 8 to also set up a **Remove Users** mapping.
74
81
75
82
10. Navigate back to **Engage > Audiences** and click on the audience from Step 1.
76
83
77
84
11. Click **Add Destinations** and select the TikTok Audiences destination you just created. In the settings that appear in the side panel, toggle the **Send Track** option on and do **not** change the Audience Entered/Audience Exited event names. Click **Save Settings**.
78
85
79
86
The setup is complete and the audience will start syncing to TikTok. The audience will appear in your [TikTok Ads Manager](https://www.tiktok.com/business/en-US/solutions/ads-manager){:target="_blank"} account under **Assets > Audiences**. Please note that it can take 24-48 hours for users to appear in TikTok.
80
87
81
-
To sync additional audiences from your Engage space, create a separate mapping in the TikTok Audiences destination. Navigate to **Connections > Destinations**, search and select the TikTok Audiences destination, and follow Steps 7-11 above.
82
-
83
-
### Configure the TikTok Audiences (_Native_) destination
84
-
85
-
1. From the Segment web app, navigate to **Engage > Audiences**. Choose an existing Engage audience or create a new one. Ensure you are in the Engage space you plan to use with the TikTok Audiences destination.
88
+
To sync additional audiences from your Engage space, create a separate mapping in the TikTok Audiences destination. Navigate to **Connections > Destinations**, search and select the TikTok Audiences destination, and follow steps 7-11 above.
86
89
87
-
2. Navigate to **Engage > Engage Settings** and click **Destinations**.
88
-
89
-
3. Search for “TikTok Audiences” and select the destination. Click **Configure TikTok Audiences**.
90
+
### Create a TikTok Audience
90
91
91
-
4. On the Select Source screen, your Engage space should already be selected as the source. Click **Confirm Source**.
92
-
93
-
5. On the **Settings** tab for the TikTok Audiences destination, name your destination and authenticate with TikTok Audiences using OAuth.
94
-
95
-
6. Once authenticated, toggle “Enable Destination” on and click **Save Changes**.
92
+
To create an audience in Segment:
96
93
97
-
7. Navigate to the **Mappings** tab, click **New Mapping**, and select **Add to Audience**.
94
+
1. Navigate to New Mapping and select **Create Audience**.
95
+
2. On the Add test event panel, click **Load Sample Event**.
96
+
3. Fill in the mappings on the Select mappings panel accordingly.
97
+
4. On the Send test event panel, click **Test Mapping**.
98
+
5. You've created your audience. Copy the `audience_id` from the response as you will need it to create additional mappings.
98
99
99
-
8. Navigate to the **Mappings** tab, click **New Mapping**, and select**Remove from Audience**.
100
+
You can use the same mapping to create as many audiences as you'd like. To create another audience, change the audience name and click**Test Mapping**.
100
101
101
-
9. Navigate back to**Engage > Audiences**and click on the audience from Step 1.
102
+
You can create a duplicate audience since TikTok doesn't restrict users from having multiple audiences with the same name. If you click**Test Mapping**multiple times, you will create audiences with the same name. However, each audience will have its own unique `audience_id`.
102
103
103
-
10. Click **Add Destinations** and select the TikTok Audiences destination you just created.
104
-
In the settings that appear in the side panel, toggle the **Send Track** option on and **Send Identify** option off. Provide the [**Advertiser ID**](https://ads.tiktok.com/help/article/ad-account-information-faq?lang=en){:target="_blank”} linked to the TikTok account that will receive the audience data, as well as the **ID Type** of data you'll be sending. Click **Save Settings**.
105
-
106
-
> info " "
107
-
> If you update the events names from the default Audience Entered/Audience Exited, please make sure to also update it in the "Add to Audience" and "Remove from Audience" mappings under step 1 (Select events to map and Send)
104
+
You do not need to update the status of the mapping to `enabled`.
108
105
109
-
The setup is complete and the audience will start syncing to TikTok. The audience will appear in your [TikTok Ads Manager](https://www.tiktok.com/business/en-US/solutions/ads-manager){:target="_blank"} account under **Assets > Audiences**. Please note that it can take 24-48 hours for users to appear in TikTok.
106
+
For instructions on how to create a TikTokaudience segment, see TikTok's [Create/Delete an audience segment](https://ads.tiktok.com/marketing_api/docs?id=1739940583739393){:target="_blank"} docs.
110
107
111
-
To sync additional audiences from your Engage space, create a separate mapping in the TikTok Audiences destination. Navigate to **Connections > Destinations**, search and select the TikTok Audiences destination, and follow Steps 7-11 above.
0 commit comments