Skip to main content

​
Prerequisites

Before setting up the TikTok integration, ensure you have:

​
TikTok Setup Requirements

​
1. Get Your Pixel Code

1

Access TikTok Ads Manager

Log in to TikTok Ads Manager
2

Navigate to Events

Go to Assets → Events → Web Events
3

Select Your Pixel

Select your existing Pixel or create a new one
4

Copy Pixel Code

Copy your Pixel Code (format: C9XXXXXXXXXXXXXXXXXX)

​
2. Generate Access Token

1

Open Settings

In your Pixel settings, navigate to the Events API section
2

Generate Token

Click Generate Access Token
3

Copy Token Immediately

Copy the token immediately - it won’t be shown again
4

Store Securely

Store the token securely - treat it like a password
Access Tokens are sensitive credentials. Never share them publicly or commit them to version control. If compromised, regenerate immediately.

​
Configuration Steps

​
Step 1: Access Integration Settings

1

Navigate to CDP

Go to your Masivo dashboard and select the CDP section
2

Open Integrations

Click on “Integrations” in the CDP menu
3

Add New Integration

Click “Add Integration” and select “TikTok” from the catalog

​
Step 2: Configure Credentials

Required Fields

Enter your TikTok Pixel Code (starts with C9 and is 20+ characters)
Enter the Access Token you generated from TikTok Events Manager

​
Step 3: Configure Event Settings

Event Sync Options

Enable to sync all standard conversion events (ViewContent, AddToCart, CompletePayment, etc.)
Enable conversion tracking for ad optimization and campaign measurement
Enable to sync purchase events - only fulfilled purchases will be sent
Enable to sync audience membership for custom audience targeting
Enable to sync customer tags for advanced targeting and segmentation

​
Event Format Support

​
Native Masivo PURCHASE Format

TikTok integration automatically transforms Masivo’s native purchase format: 
{
  "customer_id": "cust_123",
  "type": "PURCHASE",
  "order": {
    "purchase_id": "order_789",
    "value": 300,
    "currency": "USD",
    "products": [
      {
        "sku": "SKU-001",
        "name": "Running Shoes",
        "amount": 1,
        "value": 129.99,
        "brand": "Nike"
      }
    ],
    "payment_method": "CREDIT"
  },
  "fulfilled": true
}

​
Event Type Examples

Event Categories

Send common event names - automatically converted to TikTok format:
{
  "type": "purchase",  // or "PURCHASE"
  "customer_id": "cust_123",
  "value": 100
}
Becomes CompletePayment event in TikTok
Use exact TikTok event names for specific tracking:
{
  "type": "ClickButton",
  "customer_id": "cust_123",
  "description": "CTA clicked"
}
Sent as-is to TikTok
Any other event name becomes a custom event:
{
  "type": "free_trial_started",
  "customer_id": "cust_123",
  "plan": "Premium"
}
Parameters prefixed with custom_

​
Testing Your Integration

​
Step 1: Send Test Events

1

Access Test Events

In TikTok Events Manager, go to Overview → Test Events
2

Send Test Event

Send a test event from Masivo
3

Verify Receipt

Check that the event appears in Test Events tool within 1-2 minutes
4

Verify Parameters

Confirm all event parameters are correctly formatted

​
Step 2: Monitor Real Events

1

Enable Integration

Activate your TikTok integration in Masivo
2

Monitor Events

Watch TikTok Events Manager for incoming events
3

Check Attribution

Verify events are attributed to the correct Pixel
4

Validate Data

Ensure conversion values and product data are accurate

​
Monitoring and Troubleshooting

​
Health Monitoring

1

Event Delivery

Monitor event delivery success rate in TikTok Events Manager
2

Data Quality

Check for validation errors and missing required fields
3

Integration Status

Verify integration status remains “Active” in Masivo
4

Conversion Tracking

Confirm conversions are being tracked in your TikTok campaigns

​
Common Issues

1

Check Pixel Code

Verify Pixel Code is correct (starts with C9)
2

Verify Token

Ensure Access Token hasn’t expired
3

Check Settings

Confirm event type is enabled in Masivo integration settings
4

Review Logs

Check integration logs for error messages
1

Check Fulfilled Status

Verify purchases are marked as fulfilled
2

Verify Value

Ensure order.value is present and numeric
3

Check Products

Confirm order.products array contains valid items
4

Review Format

Ensure purchase_id is included for transaction tracking
1

401 Unauthorized

Regenerate Access Token in TikTok
2

400 Bad Request

Check Pixel Code format and validity
3

403 Forbidden

Verify Access Token has correct permissions
4

429 Rate Limit

Contact support - you may need higher limits
1

Customer ID

Ensure customer_id is included in all events
2

Event Timing

Send events within 7 days of occurrence
3

Pixel Installation

Verify Pixel is installed on your website
4

Deduplication

Check that transaction_id is unique for each purchase

​
Best Practices

Optimization Tips

Send customer_id with every event for proper user attribution
Include value and currency for value-based campaign optimization
Ensure transaction_id is unique for each purchase to prevent duplicates
Events older than 7 days will be rejected - sync regularly
Send complete product information in contents array for better targeting
Check TikTok Events Manager weekly to ensure data quality

​
Alternative: TikTok for Business API

For advanced users who need long-term access tokens:
1

Create Developer Account

Go to TikTok for Business
2

Register App

Create an app in the Developer Portal
3

Request Events API Access

Request access to Events API product
4

Generate Long-term Token

Generate long-term access token for your app
5

Use in Masivo

Use this token in Masivo integration settings
Long-term tokens from TikTok for Business don’t expire but require additional setup and approval from TikTok.

​
Support and Resources

TikTok Events API Docs

Official TikTok Events API documentation

TikTok Ads Manager

Access your TikTok Ads account

Events Manager

Monitor your event tracking

API Reference

Complete Masivo TikTok integration reference
Need help? Contact Masivo support with your Pixel Code (but never your Access Token) for troubleshooting assistance.