--- "@context": https://schema.org "@type": TechArticle "@id": https://www.twilio.com/docs/segment/connections/destinations/catalog/tiktok-app-events#article headline: TikTok App Events description: Build TikTok App Events with Segment to improve attribution, support test events, and share app data through the Events API. url: https://www.twilio.com/docs/segment/connections/destinations/catalog/tiktok-app-events inLanguage: en dateModified: 2026-06-04T17:06:43.000Z author: "@type": Organization name: Twilio Developer Education Team publisher: "@type": Organization name: Twilio --- # TikTok App Events The TikTok App Events destination is a server-to-server integration between TikTok Events API and Segment. Advertisers can use this integration to share mobile app events from Segment directly to TikTok. Advertisers can use app events data to power solutions like dynamic product ads, custom targeting, campaign optimization, and attribution. Advertisers can view their event data in TikTok Events Manager. TikTok maintains this integration. Please reach out to the [TikTok support team](mailto:segmenteng@bytedance.com) for any issues. ## Benefits of 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. ## Getting started Follow the instructions below to enable your TikTok ads account and add the TikTok App Events destination to your Segment workspace. ### Prerequisites 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](https://business-api.tiktok.com/portal/docs?id=1738855099573250). 2. Register your mobile app with TikTok to obtain an App ID. To learn more about App IDs, see the [TikTok Events API documentation](https://ads.tiktok.com/marketing_api/docs?id=1701890979375106). 3. [Generate a long-term Access Token](https://business-api.tiktok.com/portal/docs?id=1739584855420929). You'll use this Access Token to connect TikTok to Segment. ### Connect TikTok App Events to your workspace 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](/docs/segment/connections/destinations/actions/#customize-mappings). ## FAQ & Troubleshooting ### Supported events 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](https://business-api.tiktok.com/portal/docs?id=1771101186666498). ### Other standard events If you want to send a TikTok standard event that Segment doesn't have a prebuilt mapping for, use the [Report App Event action](/docs/segment/connections/destinations/catalog/tiktok-app-events/#report-app-event) 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. ### Match keys 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 ### PII hashing 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) ### App Tracking Transparency (ATT) 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. ### Test events 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. ### Limited Data Use 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](https://ads.tiktok.com/marketing_api/docs?id=1771101204435970) documentation. ## Support 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](https://segment.com/help/). * 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](mailto:segmenteng@bytedance.com).