TikTok Events API: How to Set Up Server-Side Tracking for TikTok Ads

The TikTok Events API is a server-side conversion tracking tool that sends customer events directly from your backend to TikTok. Instead of relying on a pixel that fires in the browser, you push conversion data directly from your server.

When a customer purchases on your store, the purchase event is immediately sent to TikTok via the Events API. TikTok records it and uses it for conversion optimization, retargeting, and audience building.

The Events API is TikTok’s answer to Apple’s privacy changes and browser limitations. It gives you accurate conversion data without depending on cookies or pixels.

Why You Need It

TikTok’s pixel-based tracking is broken. Here’s why:

Ad Blocker Data Loss

TikTok audiences skew young. Young audiences use ad blockers at high rates (45% of Gen Z). When a Gen Z user with an ad blocker clicks your TikTok Ad and purchases, your pixel never fires. You’re missing 40-45% of your best customer segment.

Mobile Browser Tracking Limitations

TikTok users are mostly mobile. Mobile browsers have stricter privacy defaults. Safari blocks third-party cookies by default. On iOS, the pixel may not fire because the browser session ends before the tracking request completes.

Multiple Device Journeys

A customer clicks your TikTok ad on their phone, later purchases on their laptop. The TikTok pixel on the phone never fires. This is common: mobile users often complete purchases on desktop.

The Impact

Without Events API, TikTok attribution is 50-65% complete. With Events API, attribution jumps to 95%+. TikTok sees real conversions, optimizes better, and your ROAS improves 25-40%.

How TikTok Events API Works

Step 1: Customer clicks your TikTok ad. TikTok attaches a ttclid parameter to the URL.

Step 2: Your website captures ttclid from the URL and stores it (cookie, form field, or database).

Step 3: Customer makes a purchase. Your backend has the order ID, value, customer email, ttclid, and timestamp.

Step 4: Your backend sends the event to TikTok’s Events API with all the conversion data.

Step 5: TikTok receives and records the event, matching it to the original ad click.

Step 6: TikTok’s algorithm optimizes bids and spend based on actual conversion data.

Setup Methods

Method 1: TikTok Pixel + Events API (Hybrid)

Use the pixel for browser-based events (PageView, AddToCart) and the Events API for backend conversion events (CompletePayment). Includes deduplication to prevent double-counting.

Best for: Most e-commerce stores.

Method 2: Events API Only

Skip the pixel entirely. Send all events from your server.

Best for: Developer-friendly stores, APIs-first merchants.

Method 3: Partner Integration

Use a third-party app that handles TikTok Events API for you. Turn-key setup with support.

Best for: Non-technical teams, Shopify stores.

Method 4: Convultra

Purpose-built for server-side conversion tracking including TikTok. Simple setup, handles deduplication, works with any backend.

Best for: Stores wanting robust implementation without heavy lifting.

Step-by-Step Setup Guide

Step 1: Set Up Your TikTok Business Account

Go to TikTok Business Suite, create or connect your business account, and note your Business ID.

Step 2: Get Your TikTok Events API Access Token

In TikTok Business Suite > Settings > Connected Applications, create a new app with Web Events API access. Copy your Access Token and Pixel ID.

Step 3: Create Conversion Events in TikTok Ads Manager

Go to Assets > Events, create events for each type you’ll track (Purchase, AddToCart, etc.), and copy the Event IDs.

Step 4: Connect Convultra to TikTok

In Convultra, go to Integrations > TikTok, paste your Access Token, and confirm connection.

Step 5: Connect Convultra to Your Shopify Store

Authorize Convultra to access your store’s order and customer data.

Step 6: Configure Your Conversion Events

Map Shopify events to TikTok events. For Purchase: set trigger to Shopify order created, event name to CompletePayment, and enable product data capture.

Step 7: Validate Event Flow

Place a test order. Check Convultra for the event within 60 seconds. Check TikTok Events Manager within 2-3 minutes.

Step 8: Enable Live Tracking

Toggle Production Mode on and monitor for 24 hours.

Event Types and Parameters

Standard TikTok Events

• PageView: When user visits a page. Requires ttclid and timestamp.
• AddToCart: When user adds product. Requires ttclid, product_id, value, currency.
• InitiateCheckout: When user starts checkout. Requires ttclid, value, quantity.
• CompletePayment: When user completes purchase. Requires ttclid, value, currency, content_id, content_category.
• ViewContent: When user views product details. Requires ttclid, content_id, content_name.
• Subscribe: When user subscribes. Requires ttclid, email.

User Parameters (Critical)

Always include at least one of: ttclid (most important), email (hashed by TikTok), phone (hashed by TikTok), or external_id (your customer ID).

Including multiple identifiers increases match rate. If ttclid is missing, TikTok can still match using email or phone.

Deduplication With the TikTok Pixel

If you’re using both pixel and Events API, deduplication prevents double-counting.

Option 1: Use Event ID

Include a unique event_id in every Events API call. TikTok deduplicates if the same event_id comes from both pixel and API. Use your order ID or a deterministic hash.

Option 2: Disable Pixel for Certain Events

Remove the TikTok pixel from your purchase confirmation page. Send CompletePayment via Events API only. Keep the pixel on other pages.

Option 3: Server-Side Deduplication

Check whether you’ve already sent an event before sending it again. Store sent event IDs in your database.

Optimizing TikTok Campaigns With Better Data

Bid on Purchase Instead of Clicks

Change your campaign optimization goal from Traffic or Impressions to Conversions, and select your purchase conversion action. Cost per purchase goes down 20-40%.

Set Conversion Value Tracking

Enable ROAS optimization. TikTok will target high-value customers instead of just any customer.

Create Lookalike Audiences

Create a custom audience from completed purchase events, then build a lookalike from it. High-intent audience without needing a customer list upload.

Build Retargeting Audiences

Retarget users who added to cart but didn’t purchase. These users are 5-10x more likely to convert than cold audiences.

Monitor ROAS by Event Type

Track which event sequences correlate with high-value purchases. Users who view product details and add to cart may convert at 15%, while those who skip details convert at 3%.

FAQ

What’s the difference between TikTok Pixel and Events API?

Pixel is browser-based. Events API is server-based. Events API is more reliable because it works with ad blockers and browser privacy restrictions.

How long does TikTok keep ttclid?

30 days. Send conversions within 30 days of the click.

Can I use Events API without the pixel?

Yes. But many stores use both for broader coverage with deduplication.

Do we need customer consent for Events API?

Best practice is to mention conversion APIs in your privacy policy. GDPR requires consent for targeted advertising.

What’s the expected match rate for ttclid?

70-85% with ttclid alone. 90-95% if you also send email and phone.

Get Started With Convultra

Convultra makes TikTok Events API implementation simple. Connect your store and TikTok Ads account. Define your conversion events. No coding required.

Within an hour, you’re tracking purchases directly. Within a week, TikTok’s algorithm has enough data to optimize. Within a month, your ROAS improves by 25-40%.