TikTok App Events

The TikTok App Events destination provides the following benefits:

• Clear mapping of data: Actions-based destinations let you define the mapping between the data Segment receives from your source and the data Segment sends to TikTok.
• Prebuilt mappings: Mappings for TikTok App Standard Events, like Purchase, AddToCart, and InstallApp, are prebuilt with the prescribed parameters and available for you to customize.
• Streamlined stability and security: Integrate and iterate without client-side limitations like network connectivity issues or SDK version dependencies.
• Privacy-focused: Stay compliant with rapidly evolving requirements with automatic PII hashing and flexible controls that let you adapt what data you share.
• Maximum event measurement: Capture events with improved accuracy across multiple devices to get a unified view of your customer's journey.

Follow the instructions below to enable your TikTok ads account and add the TikTok App Events destination to your Segment workspace.

The TikTok App Events destination is configured to use the TikTok Events API. To generate a TikTok App ID and Access Token:

1. Create a TikTok For Business account.
2. Register your mobile app with TikTok to obtain an App ID. To learn more about App IDs, see the TikTok Events API documentation.
3. Generate a long-term Access Token. You'll use this Access Token to connect TikTok to Segment.

1. From the Segment web app, click Catalog, then click Destinations.
2. Search for "TikTok App Events" in the Destinations Catalog, and select the destination.
3. Click Configure TikTok App Events.
4. Select the source that will send data to TikTok App Events and follow the steps to name your destination.
5. On the Settings tab, enter your TikTok Access Token and App ID, then click Save.
6. Follow the steps in the Destinations Actions documentation on Customizing mappings.

The TikTok App Events destination supports the following standard TikTok events:

• AchieveLevel
• AddPaymentInfo
• AddToCart
• AddToWishlist
• Checkout
• CompleteTutorial
• CreateGroup
• CreateRole
• GenerateLead
• InAppADClick
• InAppADImpr
• InstallApp
• JoinGroup
• LaunchAPP
• LoanApplication
• LoanApproval
• LoanDisbursal
• Login
• Purchase
• Rate
• Registration
• Search
• SpendCredits
• StartTrial
• Subscribe
• UnlockAchievement
• ViewContent

To learn more about supported events, see the TikTok Supported events documentation.

If you want to send a TikTok standard event that Segment doesn't have a prebuilt mapping for, use the Report App Event action to send the standard event. For example, if you want to send a GenerateLead event:

1. Create a new mapping for Report App Event.
2. Set up your Event Trigger criteria.
3. Select GenerateLead from the Event Name dropdown.

To increase the probability of matching app events with TikTok ads, send one or more of the following identifiers when possible:

• Mobile Advertising ID (IDFA or AAID)
• External ID
• Phone Number
• Email
• IP Address
• User Agent

Segment creates a SHA-256 hash of the following fields before sending them to TikTok:

• External ID
• Email
• Phone Number
• Mobile Advertising ID (IDFA or AAID)

When sending events from iOS 14.5+ devices, the App Tracking Transparency status is required. The destination supports automatic detection when set to AUTO — Segment determines the appropriate value based on the device platform, OS version, and ad tracking settings.

Use the Test Event Code field to send test events during development. You can find your Test Event Code in TikTok Events Manager under the Test Event tab. Remove the Test Event Code before sending production traffic.

Use the Limited Data Use field to flag events for limited data processing. TikTok limits its processing activities accordingly if the event occurred in an eligible location. To learn more about limited data processing, refer to the TikTok Events API 2.0 - Limited Data Use documentation.

The TikTok App Events destination is owned and maintained by TikTok.

• For general Segment questions, including issues with event data not being sent to TikTok Events Manager, contact Segment support.
• For questions regarding campaign setup and performance, mobile tracking, or additional API functionality, contact your TikTok representative or reach out to the TikTok support team.