> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masivo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok

> Learn how to integrate TikTok Events API with Masivo CDP for conversion tracking and ad optimization

## What is TikTok Integration?

The TikTok integration allows you to send customer events and conversions from Masivo to TikTok Events API in real-time. This server-side integration enables better ad optimization, audience targeting, and conversion tracking across your TikTok advertising campaigns, bypassing browser limitations and ad blockers.

## Key Features

<CardGroup cols={2}>
  <Card title="Server-Side Tracking" icon="server">
    Send events directly from your server, bypassing ad blockers and browser
    restrictions
  </Card>

  <Card title="Auto Event Mapping" icon="wand-magic-sparkles">
    Automatically maps common e-commerce events to TikTok standard events
  </Card>

  <Card title="Native Format Support" icon="code">
    Works seamlessly with Masivo's native PURCHASE format with order objects
  </Card>

  <Card title="Custom Events" icon="sparkles">
    Track business-specific events beyond TikTok's standard catalog
  </Card>
</CardGroup>

## Integration Type

Masivo exposes **two separate TikTok destinations**:

| Destination          | Catalog ID                     | What it sends                                     |
| -------------------- | ------------------------------ | ------------------------------------------------- |
| **TikTok Events**    | `tiktok-events-destination`    | Events API (`/event/track/`) — EVENT and PURCHASE |
| **TikTok Audiences** | `tiktok-audiences-destination` | Custom audiences via TikTok DMP / CSV upload      |

### TikTok Events destination

When configured as a destination, Masivo sends conversion events to TikTok:

* **Standard Events**: ViewContent, AddToCart, InitiateCheckout, CompletePayment
* **Custom Events**: Business-specific events like ClickButton, Subscribe, Contact
* **Purchase Events**: Native Masivo PURCHASE format with order objects

### TikTok Audiences destination

* **Audiences**: Customer membership for custom audience targeting

<Note>
  Older combined `tiktok-destination` connections are legacy. Prefer separate
  Events and Audiences destinations.
</Note>

## Data Flow

<Steps>
  <Step title="Event Generation">
    Customer events and purchases are generated in Masivo
  </Step>

  <Step title="Validation">
    Events are validated against your TikTok integration settings
  </Step>

  <Step title="Transformation">
    Events are transformed to TikTok Events API format with automatic field
    mapping
  </Step>

  <Step title="Real-time Sync">
    Events are sent to TikTok Events API in real-time for immediate tracking
  </Step>
</Steps>

## Supported Event Types

<AccordionGroup>
  <Accordion title="Auto-Mapped Events">
    Events that Masivo automatically converts to TikTok standard names: -
    `purchase` / `PURCHASE` → `CompletePayment` - `add_to_cart` → `AddToCart` -
    `begin_checkout` → `InitiateCheckout` - `add_payment_info` →
    `AddPaymentInfo` - `view_item` → `ViewContent` - `search` → `Search` -
    `sign_up` → `CompleteRegistration` - `add_to_wishlist` → `AddToWishlist`
  </Accordion>

  <Accordion title="TikTok Standard Events">
    Use these exact event names for TikTok-specific tracking: - `ClickButton` -
    User clicks a button - `Contact` - User initiates contact - `Download` -
    User downloads content - `SubmitForm` - User submits a form - `Subscribe` -
    User subscribes to service - `PlaceAnOrder` - User places an order
  </Accordion>

  <Accordion title="Custom Events">
    Any event name not in TikTok's catalog becomes a custom event: -
    `free_trial_started` - `newsletter_signup` - `video_watched_50` - Custom
    events have parameters flattened with `custom_` prefix
  </Accordion>
</AccordionGroup>

## Event Transformation

<Card title="Native PURCHASE Format" icon="shopping-cart">
  Masivo's native PURCHASE format is automatically transformed for TikTok:

  <AccordionGroup>
    <Accordion title="Order Object Mapping">
      * `order.products` → `contents` array - `order.value` → `value` -
        `order.purchase_id` → `transaction_id` - `order.currency` → `currency`
    </Accordion>

    <Accordion title="Product Field Mapping">
      * `sku` → `content_id` - `name` → `content_name` - `amount` → `quantity` -
        `value` → `price`
    </Accordion>
  </AccordionGroup>
</Card>

## Benefits

<CardGroup cols={2}>
  <Card title="Better Attribution" icon="chart-line">
    Capture 100% of conversions with server-side tracking, not affected by ad
    blockers
  </Card>

  <Card title="Ad Optimization" icon="bullseye">
    TikTok uses conversion data to optimize ad delivery and bidding
  </Card>

  <Card title="Privacy Compliant" icon="shield">
    More control over data sharing with server-to-server integration
  </Card>

  <Card title="Accurate Tracking" icon="target">
    Bypass browser restrictions and cookie limitations for complete data
  </Card>
</CardGroup>

## TikTok Pixel vs Events API

<Card title="Why Use Events API?" icon="server">
  <AccordionGroup>
    <Accordion title="Server-Side Tracking">
      No reliance on browser cookies or client-side tracking scripts
    </Accordion>

    <Accordion title="Complete Data">
      Capture 100% of conversions, not just those visible to browser pixels
    </Accordion>

    <Accordion title="Ad Blocker Proof">
      Server-to-server communication bypasses all ad blockers
    </Accordion>

    <Accordion title="Works Together">
      Use both Pixel (client-side) and Events API (server-side) for best results

      * TikTok automatically deduplicates
    </Accordion>
  </AccordionGroup>
</Card>

## Use Cases

<CardGroup cols={2}>
  <Card title="E-commerce Tracking" icon="shopping-bag">
    Track complete purchase funnel from product view to payment completion
  </Card>

  <Card title="Lead Generation" icon="user-plus">
    Optimize campaigns for form submissions and registration completions
  </Card>

  <Card title="App Conversions" icon="mobile">
    Track in-app purchases and subscription events for mobile apps
  </Card>

  <Card title="Custom Goals" icon="flag">
    Track business-specific conversions unique to your industry
  </Card>
</CardGroup>

## Next Step

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="wrench" href="/guides/CDP/integrations/tiktok/setup">
    Learn how to configure your TikTok integration
  </Card>

  <Card title="API Reference" icon="book" href="/integrations/tiktok">
    Complete API documentation and event examples
  </Card>
</CardGroup>