How to integrate TikTok App Events SDK

Last updated: February 2025

Before you begin

You will need a TikTok ad account and a TikTok App ID to use TikTok App Events SDK for Android and iOS. You can use your existing app if you have one or you can create a new app.


Note: TikTok App Events SDK does not support dual setup with MMPs in the same ad account. Please create a new TikTok Ad account to integrate App events SDK into the new ad account without MMP.

How to integrate TikTok App Events SDK

Step 1: Create an App and generate a TikTok App ID in TikTok Events Manager.

App Event SDK - How to GIF

  1. In TikTok Ads Manager, navigate to Events Manager by clicking the Tools tab and then Event.

  2. Select Connect data source on the top right navigation.

  3. Select App and proceed.

  4. Provide your App details.

  5. Select Use TikTok Events SDK and proceed. The app is now created.

  6. Generate your TikTok App ID.

Step 2: Follow the instructions in TikTok Developer Center guide to integrate TikTok App Events SDK.

  1. For a complete list of the standard app events you can log and auto-logged events, refer to: Standard Events.

  2. Auto-logged events are listed below. Note: You can turn off auto-logged events. To learn more, refer to App events SDK developer documents.

    1. LaunchApp: When the app is being launched.

    2. InstallApp: When the app is launched for the very first time.

    3. 2DRetention: The app is opened again on the day following the day of first open.

    4. Purchase (iOS only): Successfully completed payments for consumable/non-consumable/subscriptions.

  3. [For iOS only] Configure SKAN conversion value schema on TikTok Events Manager (TTEM).

    1. Setting up conversion value schema on TTEM is mandatory in order to receive SKAN conversions. TikTok supports 64 bits conversion value mapping in SKAN 3.0 and SKAN 4.0 schema mapping.

    2. [Best practice] In SKAdNetwork (SKAN) environment, the recommendation is to only have one SDK reporting conversion values. If you are using MMP or another SDK to update conversion values to SKAdNetwork, you will need to:

      1. Configure TTEM CV schema with the same values set up on MMP.

      2. Implement disableSKAdNetworkSupport() feature to avoid TikTok App Events SDK updating conversion values.

Step 3: Verify postbacks in real-time with Debug mode.

  1. You can verify and debug the event postbacks and the relevant parameters in real-time by enabling Debug mode in the app. To see events, go to the Test Event tab under the app in TikTok Events Manager. tab under the app in TikTok Events Manager.

Notes:

  • Test events support testing multiple TikTok App IDs at the same time. However, if multiple TikTok App IDs are being tested together, all the test events from various TikTok App IDs will show up under the Test Event tab in the ad account that has the first linked TikTok App ID.

  • Once you have verified your signals setup, turn off Debug mode before releasing the app to the App Store/Play Store. Test events may be visible for up to 72 hours once turned off. If the events are still visible after 72 hours in the Test Event tab, Debug mode is still not turned off yet. See below for an example:

Debug mode: ON

App Event SDK - Debug Mode ON

Debug mode: OFF

App Event SDK - Debug Mode OFF

Step 4: Release the new app version with TikTok SDK to App Store (iOS) / Play Store (Android).

Step 5: Run your campaign using TikTok SDK.


For any issues or trouble integrating App Events SDK, you can file a ticket with customer support. Make sure to select Measurement and then App Events SDK as the issue category.