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
The TikTok Conversions destination is configured to use the TikTok Events API. To generate the Pixel ID and Access token:
- 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. Your TikTok Access Token. Please see TikTok’s Events API documentation for information on how to generate an access token via the TikTok Ads Manager or API. |
| Pixel Code | Required. Your TikTok Pixel ID. Please see TikTok’s Events API documentation for information on how to find this value. |
Available Presets
TikTok Conversions has the following presets:
| Preset Name | Trigger | Default Action |
|---|---|---|
| Add Payment Info | Event event = "Payment Info Entered" |
Report Web Event |
| Initiate Checkout | Event event = "Checkout Started" |
Report Web Event |
| Place an Order | Event event = "Order Completed" |
Report Web Event |
| Search | Event event = "Products Searched" |
Report Web Event |
| View Content | Event type="page" |
Report Web Event |
| Add to Cart | Event event = "Product Added" |
Report Web Event |
| Add to Wishlist | Event event = "Product Added to Wishlist" |
Report Web Event |
Available Actions
Build your own Mappings! 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 in TikTok’s Events API documentation 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. |
| Phone Number | Type: STRINGPhone number of the user who triggered the conversion event, in E.164 standard format, e.g. +14150000000. Segment will hash this value before sending to TikTok. |
Type: STRINGEmail address of the user who triggered the conversion event. Segment will hash this value before sending to TikTok. |
|
| External ID | Type: STRINGUniquely identifies the user who triggered the conversion event. Segment will hash this value before sending to TikTok. |
| 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. |
| Page URL | Type: STRINGThe page URL where the conversion event took place. |
| Page Referrer | Type: STRINGThe page referrer. |
| IP Address | Type: STRINGIP address of the browser. |
| User Agent | Type: STRINGUser agent from the user’s device. |
| Contents | Type: OBJECTRelated items in a web event. |
| Currency | Type: STRINGCurrency for the value specified as ISO 4217 code. |
| Value | Type: NUMBERValue of the order or items sold. |
| Description | Type: STRINGA string description of the web event. |
| Query | Type: STRINGThe text string that was searched for. |
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: 17 Feb 2022
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!