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.
How it flows
01 Capture
One Upstack app setup that captures Shopify storefront and checkout events with the Upstack Pixel, records every order directly from Shopify, and forwards both to every tool you spend on.
See the Shopify integration
Shopify order_idShopify order and checkout tokenemail / phonecustomer contact from checkoutcustomer_idShopify customer record, if they have oneline_itemsproducts, variants and quantitiestotal / subtotal / discountorder economics02 Understand
Every Shopify 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
customer_typeNew or returning, resolved before send.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
Forward resolved conversions to the TikTok Events API so the algorithm optimizes on customers, not sessions.
See the TikTok Events API integration
TikTok Events API email / phone (hashed)Events API matchingttclid / ttpattribute the clickevent_idbrowser and server dedupevalue / currencyoptimize on revenueEach 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.
Shopify to TikTok Events API, in detail
TikTok ads often open your store inside TikTok’s in-app browser, which keeps its own cookies, so a ttclid stored there is gone when the shopper later buys in Safari. Upstack captures the ttclid on landing, loads the TikTok Pixel, and sends every storefront event to the Events API as well, with hashed email, phone and external_id and the same event_id on both copies.
| Shopify data | Sent to TikTok as |
|---|---|
| TikTok ad click Captured by the Upstack Pixel from the landing URL, for deterministic matching. | ttclid |
| Checkout email and phone Hashed with SHA-256, as the Events API requires. | email, phone |
| Upstack customer ID Hashed with SHA-256. | external_id |
| Products on the event On ViewContent and AddToCart; content_id on Purchase. | content_id, content_type |
| Order total and currency On product, cart, checkout and purchase events. | value, currency |
| Order ID On Purchase. | order_id |
| Items at checkout On InitiateCheckout. | quantity |
Both copies of each event carry the same event_id and TikTok keeps one, as long as the Pixel ID in Upstack matches the TikTok Pixel on your store. If you see duplicates, the Pixel IDs almost always differ.
Shopify’s TikTok sales channel emits no matching event_id, so TikTok can’t deduplicate its events against Upstack’s. Disconnect its pixel before you switch Upstack on.
TikTok Shop orders flow into Shopify, so Upstack sends them to your active destinations, Meta included. To leave them out, block TikTok Shop under Settings, Order Source Exclusions.
An accepted upsell on an order tagged AfterSell Upsell goes to TikTok as a separate UpsellPurchase event worth only the add-on, so the order isn’t counted twice.
The catch
Sending server events alongside it without a shared event ID is how a single purchase becomes two conversions and your reported ROAS quietly doubles. Upstack records one Purchase per Shopify order ID, so the pixel's copy and Shopify's own copy of an order count once.
Turn off other TikTok pixelsTikTok Events Manager Test Events
then the event's match rate once live traffic is flowing.
What changes
TikTok Events API
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
Events sent to TikTok carry the resolved customer whenever Upstack can identify one, matched against a 750M+ device graph.
Shopify
Purchases also reach Upstack directly from Shopify, about 10 minutes after the order, so an order still counts when an ad blocker stopped the pixel or the shopper closed the page.
Shopify
Shopify customer IDs, emails and phones are matched against the graph, so repeat buyers are identified across devices.
Setup
App install, no theme edits and no developer. You need admin access to your TikTok Business Center and owner or staff access to Shopify.
01
In the Upstack dashboard, open System, then Data Sources, and click Connect Shopify. Approve the install in your Shopify Admin: Upstack reads products, orders and customers, and writes only its own pixel.
02
In the TikTok sales channel’s Data sharing settings in Shopify, disconnect the TikTok Pixel under Customer Data Sharing. Then remove any other TikTok pixel apps and any TikTok pixel snippets in your theme.
03
In TikTok Events Manager, copy the Pixel ID (a 20 character alphanumeric string, also called the Dataset ID) and generate an Events API access token. TikTok shows the token only once. There’s no OAuth step.
04
Under Destinations, add TikTok with the Pixel ID and the token, and keep the default Browser + Server tracking method.
05
A redirect or link shortener between the ad and your page can drop the ttclid, so point ads directly at your storefront.
06
Events arrive via both Browser and Server, and a test order’s Purchase appears within a few minutes. “Update Recommended” warnings are normal and need no action.
After setup
Upstack shows the TikTok destination as Healthy.
The Overview and Test Events tabs show events with a Server source as well as Browser.
A test order’s Purchase event appears within a few minutes.
Clicking one of your own ads lands on a URL that carries ttclid.
Troubleshooting
Check the Pixel ID and access token for extra spaces or truncation and that the destination is Healthy. If the token was revoked or expired, generate a new one and update the destination.
Another TikTok source is still active: the TikTok sales channel’s data sharing, a pixel app such as Omega or Mega TikTok Pixel, or a snippet in your theme’s head. Remove it and watch counts for 24 hours.
Ads that don’t link straight to the store lose the ttclid, anonymous visitors carry fewer keys, and a Pixel ID that isn’t tied to your ad account can’t be matched to campaigns.
FAQ
Connect Shopify, disconnect the TikTok Pixel in Shopify’s TikTok sales channel and remove other TikTok pixels, then add the TikTok destination with your Pixel ID and an Events API access token. Upstack sends every event from the browser and its servers with a shared event_id. Most brands are live in under 20 minutes.
Yes. In the TikTok sales channel’s Data sharing settings in Shopify, disconnect the TikTok Pixel under Customer Data Sharing. Then remove any other TikTok pixel apps and any TikTok pixel snippets in your theme.
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.
TikTok’s match rate depends on how much identity data each event carries. Link TikTok ads directly to your storefront so the ttclid lands in the URL, and make sure your Shopify checkout collects email and phone.
PageView as Pageview, ViewContent as ViewContent, AddToCart as AddToCart, InitiateCheckout as InitiateCheckout and Purchase as Purchase. Orders reach Upstack directly from Shopify, even when the browser pixel is blocked.
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.
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.
No. Shopify connects as an app install with no theme edits, and most brands are live in under 20 minutes. Headless storefronts add the Upstack Pixel script instead of the theme app extension.
Keep the default Browser + Server tracking method: Upstack loads the TikTok Pixel itself and sends the same events from its servers, so a blocked browser event still arrives. Switch to Server if you don’t want the tag loading in the browser.
Yes, by default. TikTok Shop orders arrive in Shopify like any other order and go to all your active destinations. You can block them under Settings, Order Source Exclusions.
Keep reading
Related connectors
A 15-minute walkthrough of this connector on your own account.
21-day free trial, no card. Month to month.
Meta Conversions API 
Google Ads Conversions 
Snapchat 
Reddit 
AppLovin 
Klaviyo 
WooCommerce 
BigCommerce 
Checkout Champ 
Recharge 
Custom stack 
Funnelish