Skip to content

Commit 87ece9f

Browse files
authored
ID type field deprecated and not required for TikTok Audiences
1 parent d3fdfbc commit 87ece9f

File tree

1 file changed

+22
-18
lines changed
  • src/connections/destinations/catalog/actions-tiktok-audiences

1 file changed

+22
-18
lines changed

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

Lines changed: 22 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -12,24 +12,29 @@ By using Segment's TikTok Audiences destination, you can increase traffic and dr
1212

1313
## Getting started
1414

15-
### Notes
15+
### Legacy and native destination instances
16+
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)](#connect-the-tiktok-audiences-legacy-destination) documentation.
1617

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)](#connect-the-tiktok-audiences-legacy-destination) 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-
- 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.
20-
- The Email ID or Advertising ID of the user must be provided.
21-
- TikTok [requires](https://business-api.tiktok.com/portal/docs?id=1739940585975809){:target="_blank"} `phone` number to be formatted in E.164 form, e.g. `+1231234567`. If your phone number is missing country code, you can prepend `+1` in the Action Mapping.
22-
- For more information about how to update from _legacy_ to _native_, reach out to [[email protected]](mailto:[email protected]).
18+
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](#configure-the-tiktok-audiences-destination) documentation.
19+
20+
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.
21+
22+
For more information about how to update from legacy to native instances, reach out to [[email protected]](mailto:[email protected]).
2323

2424
### Prerequisites
2525

2626
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, with either Admin or Operator permissions to create and manage campaigns in TikTok.
2727

2828
For more details on account and access level permissions, refer to [TikTok's documentation](https://ads.tiktok.com/help/article/how-to-assign-asset-level-permissions?lang=en){:target="_blank"}.
2929

30+
#### Additional requirements
31+
32+
- If you update the events names from the default Audience Entered or Audience Exited, ensure that you also update them in the "Add to Audience" and "Remove from Audience" mappings. - The Email ID or Advertising ID of the user must be provided.
33+
- TikTok [requires](https://business-api.tiktok.com/portal/docs?id=1739940585975809){:target="_blank"} `phone` number to be formatted in E.164 form, for example `+1231234567`. If your phone number is missing country code, you can prepend `+1` in the Action Mapping.
34+
3035
### TikTok Audience Segments
3136

32-
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.
37+
Send Engage audiences to an existing TikTok audience segment or create a new audience. Make note of the `audience_id` as this is required to send Engage audiences to TikTok.
3338

3439
### Configure the TikTok Audiences destination
3540

@@ -52,9 +57,9 @@ Send Engage audiences to an existing TikTok audience segment or create a new aud
5257
9. Navigate back to **Engage > Audiences** and click on the audience from step 1.
5358

5459
10. Click **Add Destinations** and select the TikTok Audiences destination you just created.
55-
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**.
60+
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. Click **Save Settings**.
5661

57-
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.
62+
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**. It can take 24-48 hours for users to appear in TikTok.
5863

5964
### Connect the TikTok Audiences (_Legacy_) destination
6065

@@ -75,15 +80,14 @@ The setup is complete and the audience will start syncing to TikTok. The audienc
7580

7681
7. Navigate to the **Mappings** tab, click **New Mapping**, and select **Add Users**.
7782

78-
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.**
79-
80-
**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.
83+
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."
84+
**A separate mapping must be created for each audience segment you plan to send Engage audiences to.** 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.
8185

82-
9. Repeat steps 7 and 8 to also set up a **Remove Users** mapping.
86+
10. Repeat steps 7 and 8 to also set up a **Remove Users** mapping.
8387

84-
10. Navigate back to **Engage > Audiences** and click on the audience from Step 1.
88+
11. Navigate back to **Engage > Audiences** and click on the audience from Step 1.
8589

86-
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**.
90+
12. 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**.
8791

8892
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.
8993

@@ -105,11 +109,11 @@ You can create a duplicate audience since TikTok doesn't restrict users from hav
105109

106110
You do not need to update the status of the mapping to `enabled`.
107111

108-
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.
112+
For instructions on how to create a TikTok audience segment, see TikTok's documentation on how to [Create/Delete an audience segment](https://ads.tiktok.com/marketing_api/docs?id=1739940583739393){:target="_blank"}.
109113

110114
{% include components/actions-fields.html %}
111115

112116
## FAQS
113117

114-
### Why is my audience considered too small in TikTok?
118+
#### Why is my audience considered too small in TikTok?
115119
[TikTok](https://ads.tiktok.com/help/article/custom-audiences?lang=en) requires a minimum audience size of 1,000 to target Custom Audiences in an ad group.

0 commit comments

Comments
 (0)