B2B Gold

Connect TikTok Pixel and Events API to cPixel

By B2B Gold Updated cPixel page cPixel on the Shopify App Store

How do I connect TikTok to cPixel?

Open TikTok Events Manager from the Ads Manager account for your store, copy the Pixel ID from Datasets overview, then open the dataset’s Settings, Data connection, and scroll past both TikTok Pixel options to Events API to generate an access token. Paste both into cPixel; without the token, cPixel sends TikTok nothing.

Paste them into cPixel

  1. In cPixel, open Destinations and click the TikTok icon under Connect a platform. Set up TikTok opens on Paste your IDs.
  2. Paste the Pixel ID into Pixel code and the token into Events API access token, which is required: TikTok’s pixel can’t run in Shopify’s web-pixel sandbox. Name the account under Name this account (optional) if you like, then click Continue.
  3. On Choose options, keep Send events from our servers ticked; Send events from the browser adds TikTok’s storefront tag, which needs the cPixel app embed. Keep No — cPixel handles TikTok (recommended) unless Shopify’s TikTok app sends to this pixel: despite its label, Yes — keep it, and cPixel stops sending TikTok server-side stops cPixel’s browser and server sends to it.
  4. Click Save and continue. Test it confirms TikTok is connected.

Set up TikTok dialog on Paste your IDs, with fields for Pixel code, a required Events API access token, an optional account name and an optional test event code

Note: Test event code (optional) serves only Test connection, which sends one real test event to your pixel’s Test Events tab (copy the code, starting TEST, from there), and cPixel’s nightly check of an account idle for 7 days. Whatever the field’s help says, real events never carry it.

Where do I find my TikTok Pixel ID?

In TikTok Events Manager, printed under each dataset’s name: 20 letters and digits. Use TikTok’s menus: a typed Events Manager address often ends on “Page not found”.

  1. Sign in to TikTok Ads Manager. On Select an account, pick the Ads Manager account for this store, not the Business Center that owns it.

    TikTok for Business account picker, Select an account, with two columns of accounts, Ads Manager on the right, and every account name blanked

  2. Open the grid icon at the top left and choose Events Manager.

    TikTok product switcher opened from the grid icon at the top left, listing TikTok’s tools with Events Manager highlighted at the bottom

  3. On the Events Manager home page, Datasets overview shows the Pixel ID under each dataset name.

    TikTok Events Manager Datasets overview card showing a dataset with its name and Pixel ID blanked, its total events and a chart of the last 7 days

  4. Data sources in the left menu lists every dataset with its Pixel ID and creation time.

    TikTok Events Manager Data sources page with one dataset card showing its Pixel ID blanked, its creation time and its total events

How do I get an Events API access token?

Generate it in your dataset’s settings, in the Events API block below the TikTok Pixel options. TikTok’s own guide: Get started with Events API.

  1. Click your dataset, then open Settings → Data connection.
  2. Scroll past Partner integration and both TikTok Pixel options, Option 1: With Event Builder and Option 2: With custom code, to Events API.
  3. Click Generate access token and copy the long token into cPixel.

TikTok dataset Data connection settings scrolled past Option 2, With custom code, to the Events API block and its Generate access token button

Why can’t I find the Events API section?

Usually it’s further down than it looks: keep scrolling. If it’s really missing, you lack the rights to manage the pixel.

TikTok Pixel’s two options fill the screen, so the page seems to end early. With no block at the very bottom, you lack TikTok’s required Admin or Operator access to the ad account; if a Business Center owns the pixel, ask its admin to share it with you with permission to manage it.

What does cPixel send to TikTok?

cPixel’s servers send everything through the Events API: Pageview, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, and CompletePayment, the purchase built from the Shopify order. With the app embed on, TikTok’s storefront tag also sends each Pageview from the browser, under the server copy’s event ID.

CompletePayment is TikTok’s former name for Purchase; TikTok still accepts it and reports Purchase (TikTok).

Server events carry hashed email and phone when known, hashed Shopify customer and device IDs, TikTok’s _ttp cookie and ttclid click ID, and IP address and user agent. Both legs need marketing consent. An ad blocker that stops cPixel’s own request from the browser stops the browsing events; purchases come from Shopify’s order.

TikTok keeps the first event with the same pixel, event and event ID, drops repeats for 48 hours, and tries to merge one arriving within 5 minutes (TikTok).

Important: Shopify’s TikTok app also sends to its pixel, adding the Events API at its Enhanced and Maximum data-sharing levels (TikTok). Its event IDs differ from cPixel’s, so keep one sender per pixel.

How do I check it worked?

Watch each send and TikTok’s answer in cPixel’s Live, then check TikTok Events Manager.

  1. In cPixel, open Live, click Start session and browse your store in another tab. Open a Server row: Accepted means TikTok returned code 0, its success code (TikTok).
  2. Place a real order to see the purchase; test orders are skipped by default.
  3. In Events Manager, open your pixel’s Overview: cPixel’s events show the connection method Server, and page views Server & Browser with the storefront tag on (TikTok). Counts can take up to 10 minutes to update, and processing up to 2 hours (TikTok).

Live event details for a purchase sent from the server, with TikTok marked Accepted at HTTP 200 beside Meta and GA4, six of six identifiers included and the shared event ID

Destinations marks the account Verified after its first successful server send. Test Events shows only Test connection’s event, never real traffic.

What if it doesn’t work?

If TikTok isn’t receiving cPixel’s events, check Home, then the TikTok row in Live, which shows TikTok’s code and message.

What you see What it means What to do
Rejected with a token or permission error; Home says the account needs attention TikTok refused the token: revoked, or from another ad account (code 40001 means no permission). cPixel pauses server sends to it and emails your store’s contact address Generate a new token in this pixel’s Settings. Click Fix TikTok on Home, or Manage beside the account on Destinations, paste it, then Continue and Save and continue
Rejected with code 40002, invalid payload TikTok refused one event; later ones still go If it repeats, Home → Get help → Contact support
Skipped, with a reason cPixel chose not to send, for example no consent or a test order Pay for real, or untick Settings → Test orders
No browser page views The app embed is off, and Home shows Enhanced tracking is off on your storefront Turn it on; server sends carry on
Accepted in Live, nothing in TikTok after 2 hours The events went to another dataset Compare Pixel code with the Pixel ID in Datasets overview

Remove, in Manage TikTok, stops sends to that account and deletes its token.

cPixel Facebook Pixel CAPI GA4

cPixel is a Shopify app that sends your store’s events to Meta, TikTok, Google Analytics 4 and OpenAI’s ChatGPT Ads from shoppers’ browsers and from its own servers, with one shared event ID so each platform can keep a single copy. A live view shows each send, with the platform’s reply to server sends, and alerts flag a rejected token or stalled tracking.

Install free on the Shopify App StorePlans and pricing

Need help with cPixel? Email support@b2bgold.app.