TikTok event delivery
Máximo can send your storefront events to TikTok two ways: the browser Pixel, and the Events API for server-side delivery. This page covers what each one carries, how TikTok matches events to people, and how to verify delivery.
Which events go to TikTok
Section titled “Which events go to TikTok”Under Settings → TikTok → Pixel, the Storefront events table lists the Shopify events Máximo can map to TikTok, each with a toggle:
| Shopify event | TikTok event |
|---|---|
| Purchase | CompletePayment |
| Add to Cart | AddToCart |
| Begin Checkout | InitiateCheckout |
| View Item / View Cart / View Collection | ViewContent |
| Add Payment Info | AddPaymentInfo |
| Add Shipping Info | AddShippingInfo |
Purchase, Add to Cart, and Begin Checkout are on by default. Turn any event off if you don’t want it reaching TikTok, turning it off removes it from both the browser Pixel and, where the Events API applies, the server-side call, since both surfaces read the same mapping.
Browser pixel vs Events API
Section titled “Browser pixel vs Events API”The browser Pixel fires these events directly from your storefront once the Máximo Pixels theme app embed is active and the shopper has granted marketing consent. This is the primary path for browsing and checkout events today.
The Events API is TikTok’s server-side delivery path. Máximo uses it to send your completed offline order events to TikTok directly from Shopify’s order data, independent of what happened in the browser. Turn it on under Settings → TikTok → Pixel → Enable Events API; it requires the TikTok Pixel to be enabled first.
Deduplication
Section titled “Deduplication”Where a Purchase reaches TikTok through both the browser Pixel and the Events API, Máximo sends both with the same shared event ID so TikTok recognizes them as one purchase rather than counting it twice.
Advanced matching
Section titled “Advanced matching”Under Settings → TikTok → Pixel → Enhanced Matching, Máximo can send hashed customer identifiers (email, phone, first name, last name, address) alongside your Pixel and Events API events. Every identifier is hashed with SHA-256 in the browser before it leaves the page; Máximo never stores or logs the raw values.
Without advanced matching, iOS privacy settings and Intelligent Tracking Prevention cause meaningful signal loss, Máximo estimates around 30%. That gap starves TikTok’s value-based bidding, pushes cost per result up, and weakens Dynamic Product Ads lookalikes. Hashed identifiers let TikTok re-attribute a conversion even after the third-party cookie is gone.
Verifying delivery
Section titled “Verifying delivery”- Settings → TikTok → Events shows delivery counts and recent failures for events sent through the Events API, with a date-range picker and a link into the delivery monitor for more detail.
- To confirm the browser Pixel itself is firing, use Pixel presence.
- In TikTok, open Events Manager for your Pixel and check the event log directly.
You can also verify Events API delivery without affecting your real numbers: save a Test event code from TikTok Events Manager under Settings → TikTok → Pixel → Test events. While a code is saved, matching Events API calls are diverted to TikTok’s test tool instead of counting as live events; turn it off from the same card when you’re done.
Next steps
Section titled “Next steps”- Connect catalog & Pixel: set up the Pixel if you haven’t yet.
- Offline events overview: how completed and recurring orders reach your destinations.