Beta
This feature is currently in Beta. Contact your account manager for more detail.
# Overview
Simon is built on a data warehouse that stores historical and real-time data for you to activate in more personalized downstream orchestration. We layer this data into paid media audiences in [TikTok](πο»Ώ) for improved return on ad spend (ROAS), increased audience size, better conversion and more engagement.
Define and build audience segments in Simon and push them to TikTok for achieve more powerful:
**Audience Targeting & Retargeting**
Target, reach, and re-connect with the right audiences for your business while they are spending time on the farthest-reaching video ad channel, TikTok.
Measure these interactions and iterate on your campaign strategy to drive results and business growth on the backs of your brandβs most engaged consumers.
Define audiences by demographic and device and reach them based on interests and behaviors.
**Audience Suppression**
Effectively allocate ad spend by deprioritizing stale and disengaged segments and prioritizing strategic and/or high value cohorts.
**Lookalike Modeling**
Efficiently grow beyond your existing customers with automated targeting and expansion of similar cohorts.
Why add video to your conversations with customers? Use TikTok to:
Engage with the right customers that will help grow your business
Start conversations with new customers and customers like the ones you already have
Inform future iterations of your current campaigns or plan for entirely new campaigns
Other common uses:
Push real-time, actionable data to TikTok to increase conversion and engagement rates
Use Simon to combine data from all sources and gain a single view of the customer then send that data to TikTok without any custom development required
With Simon, you can understand your customer better. Activate that understanding and better reach that customer via TikTok
Better activate audience segments in paid media without leaving Simon
Ready to get started?
The process to integrate happens in four steps:
Register as a developer and create a developer account with TikTok.
Get authorization from advertisers.
Get a long term access code for authentication.
Configure a webhook call using the [Webhook Channel Action](πο»Ώ).
ο»Ώ
New To Webhooks?
New to webhooks entirely, at Simon, or just need a refresher on concepts and terms? Start in the [Outbound Webhooks Guide ](πο»Ώ)before returning to these instructions. You must be familiar with how to set up a webhook in Simon _before_ you use this guide.
# Before You Begin
## Relevant Guides
**Review our guides**: [Outbound Webhooks](πο»Ώ) and [Make a Webhook Call](πο»Ώ) for details on how to call webhooks from Simon. This guide will outline steps to integrate with TikTok via webhooks, but you first need to understand how to call a webhook from Simon.
**Review TikTok Documentation**:
ο»Ώ[TikTok Developer Integration Overview](πο»Ώ)ο»Ώ
ο»Ώ[Segment API : Map Audience Segments API Reference](πο»Ώ)ο»Ώ
## Pre-requisites
You need some knowledge of how to read an API reference, create a TikTok developer account and call a webhook from Simon. If you need help at any point, feel free to contact your account manager for support.
A [TikTok Business Account](πο»Ώ)ο»Ώ
You or your account manager allowed the TikTok domain, `
business-api.tiktok.com
` . See [Outbound Webhooks](πο»Ώ) for details.
ο»Ώ
# Complete the Integration
## 1. Register as a developer and create a developer account with TikTok.
Within your business account, you need to [register as a Developer](πο»Ώ). This process can take a few days to complete because there is a review. You need this so the data you send can be identified by TikTok once you send it via webhook.
Create a developer app, following the directions in the [TikTok documentation](πο»Ώ). Follow _application content required_. Use these parameters:
Parameter | Value |
Application name | [Your Company]-Simon App |
App Description | Leverage the Segment API to programmatically manage and optimize customer audiences from Simon Data CDP. |
Advertiser redirect url | Your website URL |
Scope of permission | <ul><li>Audience Management **(required)**</li> <li>Ad Account Management (suggested)</li> </ul> |
ο»Ώ
## 2. Get authorization
Get authorization from advertisers to manage their accounts on their behalf. You'll need to specify the permissions that you need for your application. TikTok process documentation is [here](πο»Ώ).
ο»Ώ
## 3. Get a long-term access code for Authentication
Follow the [TikTok guide here](πο»Ώ) to get a long-term access code for authentication.
Long-term access code required
Though it's not required by TikTok, getting a long-term authorization code _is_ required to call TikTok from Simon because without a long-term auth code, programmatic audience refreshes from Simon are not possible.
If you need support, contact your account manager and we will help.
Use the tool of your choice ([Postman](πο»Ώ), [Pipedream](πο»Ώ), etc) to call TikTokβs auth endpoint to get a long-term auth code. You may need to get an engineer to help you with this. (Need a more detailed overview of Webhooks: terms and tools? Read our [Outbound Webhook Guide](πο»Ώ).)
Refer to the [TikTok API reference](πο»Ώ) for the URL you need.
Make a POST call using the `
app_id
`, `auth_code
`, and `secret
` found in your [TikTok developer app](πο»Ώ) (created in [step 1](πο»Ώ)).
Your `
access_token
` will be located in the response. Save this token in a safe location to be used in the Simon Webhook action.
Sample Response Including the Access Token:
ο»Ώ
Audience name
When you're ready to create the audience to sync contacts to, contact your account manager with your desired audience name.
ο»Ώ
## 4. Create the Webhook Action
Follow the directions in the [Outbound Webhook guides](πο»Ώ) to learn how to create webhook calls from a flow or journey.

ο»Ώ
Use these parameters:
Parameter | Value |
URL | `<https://business-api.tiktok.com/open_api/v1.2/segment/mapping `>
Note, confirm this URL in the [TikTok API Reference](πο»Ώ). |
Request Method | POST |
Payload Encoding | JSON |
Headers | Key: `Access-Token `
Value: _long-term access token from step 3 above_ |
Request Type | Single |
Authentication | No Authentication |
**Payload**:
`
advertiser_ids
`: [Your advertiser ID]Find this in your TikTok Business account, top right corner.
From the drop-down, choose type _list_
`
data
`From the drop-down, chose type _dictionary_
Paste this value (hover over the code box below then click the notepad icon in the top right corner to quickly copy):
ο»Ώ
Find your audience ID in the custom audience dashboard in TikTok. Copy and paste the `data
` payload above into the webhook call using the [content editor option](πο»Ώ):

ο»Ώ
### Email Specifications for TikTok
Assuming an email address is generalized to this format: `[email protected]
`(example)
Remove `
+
` and any characters following the '+' symbol until '@'. After normalization, the above example will be: `[email protected]
`Remove all possible `
.
` within the username before `@
`. After normalization, the above example will be: `[email protected]
`.Email addresses need to be lowercased before hashing.