TikTok Conversions
The TikTok Conversions Destination enables advertisers to send Segment events to report events directly to TikTok. Data shared can power TikTok solutions like dynamic product ads, custom targeting, campaign optimization and attribution.
Reporting web events allows advertisers to send user data directly to TikTok for downstream targeting and optimization. Advertisers will be able to see their event data in TikTok Events Manager.
This document is about a feature which is in beta. This means that the Destination Actions are in active development, and some functionality may change before it becomes generally available
Good to know: This page is about the Actions-framework TikTok Conversions Segment Destination.
Benefits
- Streamlined stability and security: Integrate and iterate without client-side limitations, like network connectivity or ad blocker issues.
- Configurable privacy controls: Stay compliant with rapidly evolving requirements with flexible privacy controls that let you adapt what data you share and when you share it.
- Maximum event measurement: Capture more events with improved accuracy across different browsers, apps and devices to get a unified view of your customer’s journey from page view to purchase.
Getting started
Follow the instructions below to enable your TikTok ads account, and add the TikTok Conversions Destination to your Segment workspace.
TikTok Requirements
- Create a TikTok For Business account.
- Follow instructions for Authorization and generate a long term access token.
Configuring TikTok Conversions in Segment
- From the Segment web app, click Catalog, then click Destinations.
- Find the Destinations Actions item in the left navigation, and click it.
- Click Configure TikTok Conversions.
- Select an existing Source to connect to TikTok Conversions.
- On the next page enter your TikTok Access Token, and Pixel Code. Click Verify credentials.
Destination Settings
| Setting | Description |
|---|---|
| Access Token | Required. TikTok Long Term Access Token. You can generate this from the TikTok Marketing API portal. Please follow TikTok’s Authorization guide for more info. |
| Pixel Code | Required. An ID for your pixel. Required to send events to the TikTok pixel. |
Available Presets
TikTok Conversions has the following presets:
| Preset Name | Trigger | Default Action |
|---|---|---|
| Products Searched | Event event = "Products Searched" |
Report Web Event |
| Order Completed | Event event = "Order Completed" |
Report Web Event |
| Initiate Checkout | Event event = "Checkout Started" |
Report Web Event |
| Add Payment Info | Event event = "Payment Info Entered" |
Report Web Event |
| View Content | Event type="page" |
Report Web Event |
Available Actions
Build your own subscriptions! Combine supported triggers with the following TikTok Conversions-supported actions:
Report Web Event
Report events directly to TikTok. Data shared can power TikTok solutions like dynamic product ads, custom targeting, campaign optimization and attribution.
Report Web Event is a Cloud action.
| Field | Description |
|---|---|
| Event Name | Type: STRINGConversion event name. Please refer to the “Supported Web Events” section on this page for accepted event names. |
| Event ID | Type: STRINGAny hashed ID that can identify a unique user/session. |
| Event Timestamp | Type: STRINGTimestamp that the event took place, in ISO 8601 format. |
| Segment Event Type | Type: STRINGThe Segment event type, e.g. “page”. |
| Properties associated with the event | Type: OBJECTAdditional properties such as content info, description, and currency. |
| Phone Number | Type: STRINGPhone number of the user who triggered the conversion event, in E.164 standard format, e.g. +14150000000. |
Type: STRINGEmail address of the user who triggered the conversion event. |
|
| External ID | Type: STRINGUniquely identifies the user who triggered the conversion event. |
| TikTok Click ID | Type: STRINGThe value of the ttclid used to match website visitor events with TikTok ads. The ttclid is valid for 7 days. See Set up ttclid for details. |
Segment event names to TikTok events
The table below shows the mapping of the Segment semantic ecommerce or custom event names to the TikTok semantic conversion event names in the pre-built mappings.
| Segment Event Name | TikTok Semantic Conversion Event Name |
|---|---|
| Checkout Started | InitiateCheckout |
| Products Searched | Search |
| Payment Info Entered | AddPaymentInfo |
| Order Completed | PlaceAnOrder |
| Segment Event Type | TikTok Semantic Conversion Event Name |
|---|---|
| All Segment Page Calls | ViewContent |
This page was last modified: 11 Jan 2022
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!