On this page

TikTok Ads (Event streaming)

TikTok is a destination for short-form mobile videos. The TikTok Ads event streaming integration streams event data from Amplitude to TikTok Ads using the TikTok Events API. Sync user actions such as sign-ups, purchases, and engagement events directly into TikTok Ads in real time.

Use cases

  • Improve ad targeting with richer audience insights.
  • Enhance conversion tracking accuracy.
  • Optimize campaign performance through segmentation and retargeting.

Considerations

  • TikTok Ads requires SHA256 encryption for identifiers (External ID, Email, Phone Number). If your Amplitude property isn't pre-encrypted, Amplitude applies SHA256 when it sends the property to TikTok Ads.
  • This connector uses the TikTok Ads event tracking API: https://business-api.tiktok.com/open_api/v1.3/event/track/. Refer to the TikTok Events API documentation.
  • Type requirements:
    • Phone Number must use the E.164 format (for example, +14155552671).
    • Currency values must use ISO 4217 currency codes (for example, USD, EUR, JPY).
    • Price and value must use number format (for example, 19.99).
    • Quantity must be an integer (for example, 2).

Set up the integration

Amplitude setup

  1. In Amplitude Data, click Catalog and select the Destinations tab.

  2. In the Events section, click TikTok Ads to configure a new event streaming sync.

  3. Fill in the required fields in the setup form:

    • Pixel ID: Find this in TikTok Ads Manager under Management > Events.
    • Access Token: Get this from your TikTok developer account. The token must have permissions for the TikTok Events API.
    • Test Event Code (optional): Used to test and validate events before sending live traffic. Find your Test Event Code in TikTok Events Manager under the "Test Event" tab.
    • Content Type: Use "Product" when the event relates to a specific item or SKU. Use "Product Group" when the event involves a broader category or collection of products (for example, a product listing page or variant group).

  4. Under Mappings, define how Amplitude user properties should map to TikTok Ads identifiers. Supported TikTok Ads properties include: External ID, Email, Phone Number, TikTok Click ID, Cookie ID, IP Address, User Agent

  5. Under Select & filter events, choose the Amplitude events you want to stream and map them to TikTok Ads event names. You can select from TikTok Ads' predefined event names:

    • AddPaymentInfo
    • AddToCart
    • AddToWishlist
    • ClickButton
    • CompletePayment
    • CompleteRegistration
    • Contact
    • Download
    • InitiateCheckout
    • PlaceAnOrder
    • Search
    • SubmitForm
    • Subscribe
    • ViewContent
    • CustomizeProduct
    • FindLocation
    • Schedule
    • Alternatively, use a custom event name from the dropdown if you already use custom event name on TikTok Ads.

  6. Map event-level properties from Amplitude to TikTok Ads fields to enrich your event payloads. Supported TikTok Ads properties include:

    • Price
    • Quantity
    • Content ID
    • Content Category
    • Content Name
    • Brand
    • Currency
    • Value
    • Query
    • Description
    • URL
    • Referrer

Was this helpful?