TikTok Events API on Shopify

Pixel and Events API: what each sends

The pixel is code on your website that shares what visitors do with TikTok, from the shopper's browser. On Shopify it reports a purchase after checkout. An ad blocker, a declined cookie banner or a shopper who closes the tab first can each stop it.

The Events API sends the same kind of event from a server. TikTok describes it as a reliable connection between TikTok and an advertiser's marketing data, and for website connections it recommends adding the Events API to an existing pixel. TikTok's help lists what can travel with it to match a purchase to a person:

• the click ID that TikTok adds to the URL when someone clicks an ad;
• e-mail and phone, which must be hashed;
• an external ID, such as your customer ID, also hashed;
• the IP address and user agent: the pixel shares them by default, and TikTok says the Events API needs them set up by hand;
• the ttp first-party cookie, when the Events API is used with the pixel.

TikTok's list of standard events names Purchase for a visitor who buys, with value, currency and content IDs among its recommended parameters.

What Shopify's TikTok app sends at Standard, Enhanced and Maximum

The TikTok app on Shopify asks you to turn on data sharing and pick one of three levels. TikTok's own help on data sharing in the TikTok app on Shopify describes them:

The TikTok app is pixel-only at Standard, and it sends through the Events API at Enhanced and Maximum. TikTok's announcement of the integration tells existing users to open the TikTok app in the Shopify admin and confirm the level is set to Enhanced or Maximum. Advanced Matching, in TikTok's words, hashes customer e-mails and phone numbers with SHA256 before they reach TikTok's servers.

Your options

TikTok's guide to the Events API names the same three routes: a commerce partner such as Shopify, a data partner, or a direct API connection "if you require more control of data management".

Get the pixel ID and access token

A separate sender, whether an app or your own server, needs two things from TikTok:

1. 1The pixel ID. In TikTok Ads Manager, open Tools > Events and your web pixel. Copy its ID.
2. 2An Events API access token. In the pixel's Settings, generate an access token.

The token works only for pixels in the same ad account.

Count each purchase once

TikTok merges a pixel event and an Events API event into one only when both carry the identical event and the same event_id, and only within 48 hours of the first copy. Its help says you must share the event ID through both the pixel and the Events API for that to happen. It also merges Events API copies that carry the identical event and event_id within 48 hours.

Two separate senders, for example the TikTok app at Enhanced and an app of your choice, each make their own event IDs. TikTok has nothing to pair them by, so each purchase can be counted twice. What to do:

• keep one sender for purchases;
• if the pixel stays on next to a server sender, the server must send the same event ID the pixel sends for that order;
• after switching, check that TikTok's purchase count is close to your paid orders, not above them.

On Shopify there is a catch. The TikTok app has no switch for purchases alone. When you disconnect its pixel to stop its purchases, its page views, product views, add to cart and checkout events stop with them. Turn off the store's own tracking shows the steps and what stops.

Test it

1. 1Send a test event. In TikTok Events Manager, open Test events. TikTok's help says this section covers both browser-side (pixel) and server-side (Events API) tests, and lets you filter between them. Copy the test code there and give it to your sender. A server event carrying the code shows in Test events.
2. 2Wait for one real paid order. A test event is not a sale. See a paid order from a customer arrive in Events Manager, then compare TikTok's purchase count for a full day with your paid online orders in Shopify for the same day, in your store's time zone.
3. 3Read the diagnostics. Events Manager shows diagnostic cards with the issue, its severity and the affected events.

If TikTok shows more purchases than you had orders, look for a second sender first: the TikTok app, a tag in your theme or Google Tag Manager, a custom pixel under Settings > Customer events, or another app. If it shows far fewer, see TikTok purchases missing on Shopify.

Or let Tikra send them for you: install from the Shopify App Store

How Tikra sends it

Tikra is a Shopify app that sends your paid online orders to TikTok as purchases, through TikTok's Events API, as the buyer's consent allows. How it works, from Connect TikTok:

• Pixel ID and token. In Tikra, open Platforms, click Connect on the TikTok row, paste the pixel ID and the Events API access token, and click Save and check.
• One purchase sender. Tikra does not use TikTok's purchase count to decide when to go live, so there is no check before sending for TikTok. Before you save, the window asks you to tick that the store's own TikTok purchase tracking is off and that TikTok then gets purchases only from Tikra. Tikra relies on that confirmation, and a connection on a plan goes live when you save it.
• A test you send. TikTok offers no check Tikra can run when you save. Click Settings on the TikTok row, then Send test, and paste the code from Test events into Test event code. The test event is not a purchase.
• A record for each order. The Orders page shows what was sent to TikTok, when, and TikTok's answer, or why an order was not sent. See Reading an order's proof.
• Consent your way. TikTok needs marketing consent. In Strict mode Tikra sends an order only when the buyer accepted; in Standard, unless the buyer declined. See Consent modes.
• Sending again. Orders up to 7 days old can be sent to TikTok again.
• More than TikTok: the same orders to Meta, Google Analytics 4, Google Ads, Pinterest, Snapchat, Klaviyo and ChatGPT Ads.
• A guarantee: a written guarantee for eligible orders: at least 97 % reach each platform, fixed within 12 hours or a month's fee credited (Terms, section 8). Terms apply.

Tikra sends only purchases to TikTok. Page views and add to cart events stay with the pixel you keep or stop.

Frequently asked questions

Does Shopify's TikTok app use the Events API?

At the Enhanced and Maximum data-sharing levels, yes, according to TikTok's own help. At Standard it uses the pixel only.

Do I still need the TikTok pixel?

TikTok recommends the Events API together with the pixel. The pixel also sends page views, product views and add to cart events, and the ttp cookie it sets can travel with a server event.

Will TikTok count my purchases twice?

Only when two senders send the same purchase without a shared event ID. TikTok merges copies with the same event and event_id within 48 hours. Two separate tools rarely share one, so keep one sender for purchases.

Where do I find the Events API access token?

In TikTok Ads Manager, open Tools > Events, then your web pixel and its Settings, and generate the token there. It works for pixels in the same ad account.

Does the Events API follow my cookie banner?

It has to. A server must apply the buyer's consent choice the same way the pixel must. In Tikra, TikTok follows your Strict or Standard rule.

What does it cost?

The TikTok app is free to install on the Shopify App Store. Apps charge a monthly fee. Tikra starts from $99 a month, 500 orders, with setup included and a 14-day free trial. Installing it starts a free diagnosis that sends no orders.

Check your store

Install Tikra and send TikTok purchases from a server

Check that your tracking works

Related: Shopify server-side tracking · Meta Conversions API on Shopify · TikTok purchases missing on Shopify · Pinterest Conversions API on Shopify · Sending purchases to ChatGPT Ads

Sources, checked 2026-11-08

• TikTok Business Help Center, About Data Sharing on TikTok App on Shopify (last updated February 2025): https://ads.tiktok.com/help/article/data-sharing-tiktok-app-shopify
• TikTok for Business blog, Expanded Shopify integration strengthens ad performance for merchants (17 August 2023): https://ads.tiktok.com/business/en/blog/shopify-ecommerce-integration-pixel-events-api
• TikTok Business Help Center, About Events API (April 2025): https://ads.tiktok.com/help/article/events-api
• TikTok Business Help Center, How to get started with Events API (April 2025): https://ads.tiktok.com/help/article/getting-started-events-api
• TikTok Business Help Center, How to set up matching events with Events API (February 2025): https://ads.tiktok.com/help/article/how-to-set-up-matching-events-with-events-api
• TikTok Business Help Center, About event deduplication (May 2025): https://ads.tiktok.com/help/article/event-deduplication
• TikTok Business Help Center, Advanced Matching for Web (September 2025): https://ads.tiktok.com/help/article/advanced-matching-web
• TikTok Business Help Center, Standard Events and Parameters (April 2026): https://ads.tiktok.com/help/article/standard-events-parameters
• TikTok Business Help Center, About TikTok Events Manager (November 2025): https://ads.tiktok.com/resources/help/article/about-tiktok-events-manager
• Shopify App Store, TikTok by TikTok Inc. (free to install): https://apps.shopify.com/tiktok
• Tikra help: Connect TikTok, Turn off the store's own tracking, Consent modes, Reading an order's proof, Sending orders again, Check that Tikra works.