Skip to main content

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.

​
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

Server-Side Tracking

Send events directly from your server, bypassing ad blockers and browser restrictions

Auto Event Mapping

Automatically maps common e-commerce events to TikTok standard events

Native Format Support

Works seamlessly with Masivo’s native PURCHASE format with order objects

Custom Events

Track business-specific events beyond TikTok’s standard catalog

​
Integration Type

​
TikTok as 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
  • Audiences: Customer membership for custom audience targeting

​
Data Flow

1

Event Generation

Customer events and purchases are generated in Masivo
2

Validation

Events are validated against your TikTok integration settings
3

Transformation

Events are transformed to TikTok Events API format with automatic field mapping
4

Real-time Sync

Events are sent to TikTok Events API in real-time for immediate tracking

​
Supported Event Types

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
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
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

​
Event Transformation

Native PURCHASE Format

Masivo’s native PURCHASE format is automatically transformed for TikTok:
  • order.products → contents array - order.value → value - order.purchase_id → transaction_id - order.currency → currency
  • sku → content_id - name → content_name - amount → quantity - value → price

​
Benefits

Better Attribution

Capture 100% of conversions with server-side tracking, not affected by ad blockers

Ad Optimization

TikTok uses conversion data to optimize ad delivery and bidding

Privacy Compliant

More control over data sharing with server-to-server integration

Accurate Tracking

Bypass browser restrictions and cookie limitations for complete data

​
TikTok Pixel vs Events API

Why Use Events API?

No reliance on browser cookies or client-side tracking scripts
Capture 100% of conversions, not just those visible to browser pixels
Server-to-server communication bypasses all ad blockers
Use both Pixel (client-side) and Events API (server-side) for best results
  • TikTok automatically deduplicates

​
Use Cases

E-commerce Tracking

Track complete purchase funnel from product view to payment completion

Lead Generation

Optimize campaigns for form submissions and registration completions

App Conversions

Track in-app purchases and subscription events for mobile apps

Custom Goals

Track business-specific conversions unique to your industry

​
Next Step

Setup Guide

Learn how to configure your TikTok integration

API Reference

Complete API documentation and event examples