Home
Connectors
WooCommerce - TikTok Events API

Send every WooCommerce event to the TikTok Events API, server-side

Q: Will I see duplicate conversions if I run both the TikTok Pixel and the Events API?

No, as long as the Pixel ID in Upstack matches the TikTok Pixel firing in your storefront. Upstack sends a shared event_id on every server-side event and TikTok keeps only one copy. If you see duplicates, the Pixel IDs almost always differ.

Q: Which events does the TikTok Events API receive?

PageView as Pageview, ViewContent as ViewContent, AddToCart as AddToCart, InitiateCheckout as InitiateCheckout and Purchase as Purchase.

Q: Which customer parameters are sent to the TikTok Events API?

Every event carries email, phone and external_id when available, hashed with SHA-256 as the Events API requires, plus the ttclid click ID captured by the Upstack Pixel for deterministic matching.

Q: How do I check that WooCommerce events are reaching the TikTok Events API?

Upstack marks the destination Healthy, and TikTok Events Manager shows events arriving via both Browser and Server (CAPI), with a test order’s Purchase event appearing within a few minutes. “Update Recommended” warnings in Events Manager are normal and need no action.

Q: How long does it take to connect WooCommerce to the TikTok Events API?

Most brands are live in under 20 minutes. Once WooCommerce is connected, every destination receives the same resolved events, the TikTok Events API included.

Each event is resolved to a person against a 750M+ device graph before it reaches the TikTok Events API, with restored click IDs, deduplicated conversions and delivery you can audit.

Request a demo Start free trial

US device IDs in the graph: 750M+
Match rate on events: 90%+
Identity window, per customer: Lifetime
Most brands are live: <20 min

How it flows

How a WooCommerce event reaches the TikTok Events API. Captured on the server, resolved to a person, then sent.

01 Capture

Captured from WooCommerce

Capture WooCommerce orders and customer events server-side and forward them to every platform you buy on.

See the WooCommerce integration

WooCommerceWhat it sends

order_idWooCommerce order number
billing_email / phonecheckout contact fields
customer_idWordPress user, when logged in
line_itemsproducts and quantities
order_totalorder value after discount

02 Understand

Resolved to one person before it leaves

Every WooCommerce event is matched against a 750M+ device graph, so a phone browse and a desktop checkout resolve to one customer rather than two strangers.

How resolution works

Resolved before it is sent

IdentityMatched against a 750M+ device graph, so a phone browse and a desktop checkout resolve to one customer.
customer_typeNew or returning, resolved before send.
DeduplicationBrowser and server copies of the same purchase collapse on event ID, so nothing is counted twice.
Bot and fraud filteringAutomated traffic never reaches the model, because what you keep out of the training set matters as much as what goes in.

Ad platforms accept almost anything and tell you very little. These controls exist so you can see what was sent and what was accepted, rather than inferring it from a reporting gap.

03 Activate

Delivered to the TikTok Events API

Forward resolved conversions to the TikTok Events API so the algorithm optimizes on customers, not sessions.

See the TikTok Events API integration

TikTok Events APIWhat it receives

email / phone (hashed)Events API matching
ttclid / ttpattribute the click
event_idbrowser and server dedupe
value / currencyoptimize on revenue

Which events reach the TikTok Events API

Each Upstack event is mapped to the TikTok Events API event below before it is sent.

Upstack event	Sent to TikTok Events API as	Key data on the event
Page view	Pageview	url, referrer
Product view	ViewContent	content_id, content_type, value, currency
Add to cart	AddToCart	content_id, content_type, value, currency
Checkout	InitiateCheckout	value, currency, quantity
Purchase	Purchase	content_id, value, currency, order_id

Every event carries email, phone and external_id when available, hashed with SHA-256 as the Events API requires, plus the ttclid click ID captured by the Upstack Pixel for deterministic matching.

The catch

WooCommerce sites vary enormously in how checkout is built, and browser-side conversion tags break on custom checkouts more often than on hosted platforms.

Capturing on the server sidesteps the theme entirely.

Where to check in the TikTok Events APIDelivery you can audit

TikTok Events Manager Test Events

then the event's match rate once live traffic is flowing.

What changes

What changes when WooCommerce feeds the TikTok Events API. Two gains on the TikTok Events API side, two on the WooCommerce side.

TikTok Events API

Server-side delivery

By default Upstack sends events to TikTok from its servers as well as through the TikTok tag, so an event an ad blocker or browser privacy setting stops in the browser still arrives from the server.

TikTok Events API

Identity-resolved events

Events sent to TikTok carry the resolved customer whenever Upstack can identify one, matched against a 750M+ device graph.

WooCommerce

Every event, server-side

Storefront and checkout events are captured from WooCommerce on the server, independent of the browser.

WooCommerce

One setup, every destination

Connect WooCommerce once and forward to every ad platform, email tool and warehouse you run.

Setup

Live in under 20 minutes.

You need admin access to your TikTok Business Center.

Upstack dashboardExample

WooCommerce Data source Connected

TikTok Events API Destination Healthy

Read the full TikTok Events API setup guide

01

Connect WooCommerce

Capture WooCommerce orders and customer events server-side and forward them to every platform you buy on.
02

Add the TikTok destination

Under Destinations, add TikTok with your Pixel ID (a 20 character alphanumeric string, also called the Dataset ID) and an Events API access token generated in TikTok Events Manager, which is shown only once.
03

Check Browser and Server events

Upstack marks the destination Healthy, and TikTok Events Manager shows events arriving via both Browser and Server (CAPI), with a test order’s Purchase event appearing within a few minutes. “Update Recommended” warnings in Events Manager are normal and need no action.

FAQ

Questions about WooCommerce and the TikTok Events API.

Will I see duplicate conversions if I run both the TikTok Pixel and the Events API?

No, as long as the Pixel ID in Upstack matches the TikTok Pixel firing in your storefront. Upstack sends a shared event_id on every server-side event and TikTok keeps only one copy. If you see duplicates, the Pixel IDs almost always differ.

Which events does the TikTok Events API receive?

PageView as Pageview, ViewContent as ViewContent, AddToCart as AddToCart, InitiateCheckout as InitiateCheckout and Purchase as Purchase.

Which customer parameters are sent to the TikTok Events API?

Every event carries email, phone and external_id when available, hashed with SHA-256 as the Events API requires, plus the ttclid click ID captured by the Upstack Pixel for deterministic matching.

How do I check that WooCommerce events are reaching the TikTok Events API?

Upstack marks the destination Healthy, and TikTok Events Manager shows events arriving via both Browser and Server (CAPI), with a test order’s Purchase event appearing within a few minutes. “Update Recommended” warnings in Events Manager are normal and need no action.

How long does it take to connect WooCommerce to the TikTok Events API?

Most brands are live in under 20 minutes. Once WooCommerce is connected, every destination receives the same resolved events, the TikTok Events API included.