diff --git a/src/connections/destinations/catalog/actions-tiktok-audiences/index.md b/src/connections/destinations/catalog/actions-tiktok-audiences/index.md index a57051867f..696a1bd4b9 100644 --- a/src/connections/destinations/catalog/actions-tiktok-audiences/index.md +++ b/src/connections/destinations/catalog/actions-tiktok-audiences/index.md @@ -12,14 +12,14 @@ By using Segment's TikTok Audiences destination, you can increase traffic and dr ## Getting started -### Notes +### Legacy and native destination instances +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. -- 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. -- 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. -- 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. -- The Email ID or Advertising ID of the user must be provided. -- 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. -- For more information about how to update from _legacy_ to _native_, reach out to [friends@segment.com](mailto:friends@segment.com). +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. + +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. + +For more information about how to update from legacy to native instances, reach out to [friends@segment.com](mailto:friends@segment.com). ### Prerequisites @@ -27,9 +27,15 @@ Before connecting to the TikTok Audiences destination, you must have a [TikTok A 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"}. +#### Additional requirements + +- 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. +- 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. + ### TikTok Audience Segments -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. +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. ### Configure the TikTok Audiences destination @@ -52,9 +58,9 @@ Send Engage audiences to an existing TikTok audience segment or create a new aud 9. Navigate back to **Engage > Audiences** and click on the audience from step 1. 10. 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 **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**. + 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**. -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. +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. ### Connect the TikTok Audiences (_Legacy_) destination @@ -63,7 +69,7 @@ The setup is complete and the audience will start syncing to TikTok. The audienc 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. -2. Navigate to **Engage > Engage Settings** and click **Destinations**. Please ensure you are still in the correct Engage space. +2. Navigate to **Engage > Engage Settings** and click **Destinations**. Ensure you are still in the correct Engage space. 3. Search for “TikTok Audiences” and select the destination. Click **Configure TikTok Audiences**. @@ -77,9 +83,8 @@ The setup is complete and the audience will start syncing to TikTok. The audienc 8. Navigate to the **Mappings** tab, click **New Mapping**, and select **Add Users**. -9. 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.** - - **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. +9. 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." + **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. 10. Repeat steps 7 and 8 to also set up a **Remove Users** mapping. @@ -87,7 +92,7 @@ The setup is complete and the audience will start syncing to TikTok. The audienc 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**. -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. +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. 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. @@ -107,11 +112,11 @@ You can create a duplicate audience since TikTok doesn't restrict users from hav You do not need to update the status of the mapping to `enabled`. -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. +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"}. {% include components/actions-fields.html %} ## FAQS -### Why is my audience considered too small in TikTok? +#### Why is my audience considered too small in TikTok? [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.