TikTok
Use GrowthLoop audiences for TikTok Ads Manager customer file targeting.
Connect this destination to export audience membership into TikTok Ads Manager as a customer file audience, for use in TikTok campaigns.
This destination writes to your TikTok account and is a good fit when you want to:
- Target or suppress audiences in TikTok campaigns
- Match contacts on email, phone, or a mobile device ID
This maps to GrowthLoop Audiences and Journeys:
| Use it for | Audiences | Journeys |
|---|---|---|
| Sending GrowthLoop audiences with TikTok (batch API) | ✓ | ✓ |
| Sending GrowthLoop audiences with TikTok Streaming | ✓ | ✓ |
To send web conversion events, use TikTok Conversions. Do not use an audience export to send conversion events.
Prerequisites
Make sure you have:
- A TikTok for Business account. If you do not have one, create one with this form.
- An Operator or Admin role for the person who grants GrowthLoop access.
- A Pixel Code only if you will also send TikTok Conversions. You do not need a pixel to export audiences.
Set up TikTok as a destination
GrowthLoop offers two TikTok destinations:
- TikTok uses the batch API. Audiences can take hours to become ready. You can map mixed device IDs in one Mobile Device ID field.
- TikTok Streaming uses the streaming API. Audiences update more quickly. You must map AAID and IDFA as separate fields.
If your organization has TikTok Streaming enabled, choose it when you need faster audience updates and can split Android and iOS device IDs.
Then connect the destination you chose:
- In GrowthLoop, click the Destinations tab on the left sidebar.
- Click New Destination in the upper right corner.
- Search for TikTok or TikTok Streaming and click Add TikTok or Add TikTok Streaming.
NoteDon't see TikTok Streaming when you try to add a destination? Reach out to [email protected] and we'll enable it.
- Confirm access on TikTok's Request for Permission page.
- After TikTok redirects you back to GrowthLoop, enter the required information, then click Create.
| Field | Description |
|---|---|
| Destination Name | Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "TikTok Ads". |
| Sync Frequency | Set the default export frequency (for example, daily or weekly). You can override this setting for individual exports. |
| OAUTH Token | Your TikTok authentication token. GrowthLoop populates this after you grant access. |
| Select Ad Account | The TikTok ads account that should receive exported audiences. |
| Pixel Code (optional) | Required later for TikTok Conversions. You can add it now or edit the destination later. |
GrowthLoop validates the connection. The destination then appears in your list of connected destinations.
Export to TikTok
From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.
After building or selecting an audience, click Export, then search for TikTok or TikTok Streaming. In a journey, add a Destination Node under Ads and select TikTok or TikTok Streaming.
Map contact identifiers
On an audience or in a journey Destination Node, map at least one identifier. Mapping additional identifiers can improve match rates. GrowthLoop only shows the match fields for the destination you selected.
| Match field | TikTok (batch) | TikTok Streaming |
|---|---|---|
| ✓ | ✓ | |
| Phone | ✓ | ✓ |
| Mobile Device ID | One field for IDFA, AAID, or MAID | n/a |
| IDFA | n/a | iOS device ID |
| AAID | n/a | Android device ID |
Configure the export
This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.
| Setting | Audience export | Journey Destination Node |
|---|---|---|
| Export Name | Defaults to the audience name. | Required. Enter a name so you can find the export in GrowthLoop and TikTok Ads Manager. |
| Campaign type | Choose a one-time or ongoing export. | The journey schedule controls when the journey runs and contacts are sent to TikTok. |
| Schedule | Set frequency, start date, end date, and days of the week for ongoing exports. | Users reach this node when the journey runs. Add a Delay Node or set Criteria Evaluation to control timing. |
Export behavior
This is what GrowthLoop writes when you export an audience.
| Behavior | What happens |
|---|---|
| What GrowthLoop writes | A customer file audience in TikTok Ads Manager. Direction is GrowthLoop → TikTok. |
| When it runs | GrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. Journeys send exports on demand when users reach the Destination Node. TikTok can take hours to become ready. TikTok Streaming updates more quickly. |
| Audience | GrowthLoop creates a customer file audience when you start the export and uses that audience on later runs. |
| Batch vs streaming | TikTok processes audiences in bulk. TikTok Streaming updates audiences more quickly. |
| Device IDs | Batch accepts mixed device IDs in Mobile Device ID. Streaming requires separate AAID and IDFA mappings. |
| Audience expiry | TikTok customer file audiences expire after 12 months of inactivity. Apply the audience to a campaign, update the file, or use it in a Lookalike to keep it active. |
| One-time exports | GrowthLoop sends current membership once. |
| Ongoing adds and removals | Ongoing exports send contacts who enter the audience and remove contacts who leave. |
| Deletes | GrowthLoop does not delete the TikTok audience. |
Confirm the export was successful
When the run finishes, confirm you can use the data in TikTok.
- Audience export: Open Audience Manager and look up the customer file audience.
- Journey Destination Node: Open Audience Manager and look up the customer file audience named after the export. Confirm a contact who reached the node is in it.
In GrowthLoop, review counts on the audience Exports tab, or open the Activity tab on the journey Destination Node. See Export an audience or Monitor a journey for more information.
Congrats on successfully exporting to TikTok!
Troubleshooting
These are the issues we see most often. You can always email us at [email protected] for help.
| Problem | Cause | Resolution |
|---|---|---|
| Connection fails to validate | The connected user is not an Operator or Admin | Confirm the person who connected TikTok has an Operator or Admin role. |
| Rows fail to match | No identifier is mapped | Map at least one of Email, Phone, or a device ID. |
| AAID and IDFA cannot be mapped separately | You selected the batch destination | Export to TikTok Streaming. The batch destination only shows Mobile Device ID. |
| TikTok Streaming export fails to create an audience | Streaming API is not enabled on the TikTok ads account | Confirm streaming is enabled in TikTok, or use the batch TikTok destination. |
| The audience is missing | The batch API is still processing | Wait for the batch API to finish, then refresh Audience Manager. |
| A customer file audience disappears | The audience was inactive for 12 months | Re-export within 12 months or use the audience in a campaign. |
Updated 8 days ago