Skip to content

Commit c3cfba1

Browse files
Apply suggestions from code review
Co-authored-by: forstisabella <[email protected]>
1 parent 57620aa commit c3cfba1

File tree

1 file changed

+24
-20
lines changed
  • src/connections/destinations/catalog/actions-tiktok-audiences

1 file changed

+24
-20
lines changed

src/connections/destinations/catalog/actions-tiktok-audiences/index.md

Lines changed: 24 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,13 @@ By using Segment's TikTok Audiences destination, you can increase traffic and dr
1414

1515
### Note
1616

17-
- If you created a TikTok Audiences destination instance before September 18th your instance and all subsequent new instances are considered _legacy_. Therefore, follow the documentation labeled as such. Newer instances are considered _native_.
18-
- Both versions offer the same set of features, the difference sits in the way to configure them. For legacy, you are required to create an audience manually whereas native will do that automatically. Additionally, manual configuration is required per action when using legacy, native will perform this configuration as well.
19-
- For more information about how to update from _legacy_ to _native_ reach out to [[email protected]](mailto:[email protected]).
17+
- If you created a TikTok Audiences destination instance before September 18th, 2023, your instance(s) and all subsequent instances are considered _legacy_ instances. To create new _legacy_ instances, see the [Create a TikTok audience (Legacy)](#create-a-tiktok-audience-legacy) documentation. Users who created their first instance after September 18, 2023 are considered to have _native_ instances. To create new _native_ instances, see the [Configure the TikTok Audiences destination (Native)](#configure-the-tiktok-audiences-destination-native) documentation.
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+
- For more information about how to update from _legacy_ to _native_, reach out to [[email protected]](mailto:[email protected]).
2020

2121
### Prerequisites
2222

23-
1. Before connecting to the TikTok Audiences destination, you must have a [TikTok Ads Manager](https://www.tiktok.com/business/en-US/solutions/ads-manager){:target="_blank"} account.
23+
Before connecting to the TikTok Audiences destination, you must have a [TikTok Ads Manager](https://www.tiktok.com/business/en-US/solutions/ads-manager){:target="_blank"} account.
2424

2525
### TikTok Audience Segments
2626

@@ -29,27 +29,28 @@ You must create an audience segment in your TikTok Advertising account. You can
2929
> warning ""
3030
> 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.
3131
32-
#### create a tiktok audience (_legacy_)
32+
#### Create a TikTok Audience (_legacy_)
3333

34-
to create an audience in segment:
34+
To create an audience in Segment:
3535

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. take note of the `audience_id` from the response as you will need it when you create additional mappings.
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.
4141

42-
you can use the same mapping to create as many audiences as you would like. you just need to change the audience name and click **test mapping** again.
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**.
4343

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`.
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`.
4545

46-
you do not need to update the status of the mapping to `enabled`.
46+
You do not need to update the status of the mapping to `enabled`.
4747

4848
see tiktok's [create/delete an audience segment](https://ads.tiktok.com/marketing_api/docs?id=1739940583739393){:target="_blank"} for instructions on how to create a tiktok audience segment.
4949

5050
### Connect the TikTok Audiences destination (_legacy_)
5151

52-
**add user and remove user are considered legacy actions**
52+
> info ""
53+
> Add User and Remove User are considered legacy actions.
5354
5455
1. From the Segment web app, navigate to **Engage > Audiences**. Ensure you are in the Engage space you plan to use with the TikTok Audiences destination. Either choose an existing Engage audience or create a new one. This is the audience you plan to send to TikTok.
5556

@@ -81,17 +82,17 @@ To sync additional audiences from your Engage space, create a separate mapping i
8182

8283
### Configure the TikTok Audiences destination (_native_)
8384

84-
1. From the Segment web app, navigate to **Engage > Audiences**. Ensure you are in the Engage space you plan to use with the TikTok Audiences destination. Either choose an existing Engage audience or create a new one. This is the audience you plan to send to TikTok.
85+
1. From the Segment web app, navigate to **Engage > Audiences**. Ensure you are in the Engage space you plan to use with the TikTok Audiences destination. Either choose an existing Engage audience or create a new one.
8586

86-
2. Navigate to **Engage > Engage Settings** and click **Destinations**. Please ensure you are still in the correct Engage space.
87+
2. Navigate to **Engage > Engage Settings** and click **Destinations**.
8788

8889
3. Search for “TikTok Audiences” and select the destination. Click **Configure TikTok Audiences**.
8990

9091
4. On the Select Source screen, your Engage space should already be selected as the source. Click **Confirm Source**.
9192

92-
5. On the Destination **Settings** tab, name your destination and authenticate with TikTok Audiences using OAuth.
93+
5. On the **Settings** tab for the TikTok Audiences destination, name your destination and authenticate with TikTok Audiences using OAuth.
9394

94-
6. Once authenticated, toggle “Enable Destination” on and click **Save Changes**.
95+
6. Once authenticated, toggle “Enable Destination” on and click **Save Changes**.
9596

9697
7. Navigate to the **Mappings** tab, click **New Mapping**, and select **Add to Audience**.
9798

@@ -100,7 +101,10 @@ To sync additional audiences from your Engage space, create a separate mapping i
100101
9. Navigate back to **Engage > Audiences** and click on the audience from Step 1.
101102

102103
10. Click **Add Destinations** and select the TikTok Audiences destination you just created.
103-
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.
104+
In the settings that appear in the side panel, toggle the **Send Track** option on and **Send Identify** option off.
105+
106+
*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).*
107+
104108
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**.
105109

106110
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.

0 commit comments

Comments
 (0)