← Back
PixelYourSite Professional / Configuration: Pixels & APIs / TikTok Settings: Pixel and Events API Configuration

TikTok Settings: Pixel and Events API Configuration

Last updated: June 8, 2026

Where to find it: PixelYourSite Pro → TikTok.

This page covers the full TikTok setup: Pixel ID, Events API token, testing, Advanced Matching, event toggles, Super Pack pixel-targeting, CartFlows, product catalog upload, and consent.

Quick start

  1. Paste your TikTok Pixel ID.
  2. Generate an Access Token in TikTok Ads Manager and paste it.
  3. Turn on Enable TikTok Conversion API.
  4. Save. Purge any page cache.
  5. In TikTok Ads Manager → Tools → Events, verify events arrive within a few minutes.

Pixel ID

In TikTok Ads Manager → Tools → Events → select your Pixel → copy the Pixel ID from the pixel details. Paste it into TikTok Pixel ID in PYS.

Events API (server-side)

The Events API sends TikTok events from your server in parallel with the browser pixel. Browser events are blocked by ad blockers and privacy browsers; Events API arrives anyway.

Access Token

In TikTok Ads Manager → Events → open your Pixel → Settings (or Events API setup) → generate or copy the Access Token. Paste it into Access Token in PYS, tick Enable TikTok Conversion API, save. Purge cache.

Test Event Code

Use this to verify server-side events while you’re testing.

  1. In TikTok Ads Manager → your Pixel → Test events, copy the Test Event Code.
  2. In PYS, paste it into Test Event Code and save. Purge cache.
  3. Do a test action on your site — page view, add to cart, purchase.
  4. Watch the events appear in TikTok’s Test Events panel.
  5. Clear the field and save when you’re done. TikTok also auto-clears the code after ~24 hours.

Test with the TikTok Pixel Helper

The TikTok Pixel Helper Chrome extension shows browser-side events as they fire. To see server-side activity, use PYS’s own logs at PixelYourSite Pro → Logs — they show the exact payload sent to TikTok via the Events API.

Advanced Matching

Sends hashed customer data (email, phone) with events when available. Improves match quality. PYS handles the hashing. Toggle: Enable Advanced Matching.

For logged-in users and WooCommerce/EDD purchases, PYS pulls identity data from the WordPress profile or order. For anonymous visitors, identity data comes from PYS’s Automatic Form Data Detection when forms are submitted.

Event toggles

Three switches control which PYS event groups reach this TikTok Pixel:

  • Fire the active automated events for this pixel.
  • Fire the WooCommerce events for this pixel.
  • Fire the Easy Digital Downloads events for this pixel.

Turn off any group you don’t want this pixel to receive.

What PYS does and doesn’t send to TikTok

  • Standard events: PageView, ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase, CompleteRegistration, Lead, Search, Subscribe, Contact, SubmitForm. PYS maps WooCommerce and EDD actions to these.
  • No custom event names. TikTok’s API only accepts standard event names. Custom Events you build in PYS for other pixels won’t route to TikTok with their custom names; pick a standard mapping if you want TikTok to receive them.

CartFlows

PYS fires TikTok events for CartFlows checkout, upsell, downsell, and order bump actions automatically when CartFlows is active. No extra TikTok-specific configuration. See the WooCommerce settings for fine-grained control over individual events.

Pixel targeting (Display conditions)

Limit where this pixel fires:

  • Logic — Track or Don’t track.
  • Scope — entire site, a section, or specific products/categories.
  • Add Extra Conditions — advanced targeting.

Part of the Super Pack.

Hide rules

Block the pixel based on URLs:

  • Hide if page URL includes — specific pages.
  • Hide if landing URL includes — entire sessions based on entry URL.
  • Hide for X hours — temporary suppression.

Part of the Super Pack.

Upload your WooCommerce products to TikTok Catalogs

Use the Product Catalog Feed for WooCommerce plugin to generate a TikTok-formatted feed of your products and submit it to TikTok Catalog Manager. Required if you want to run TikTok dynamic ads.

Consent (GDPR, CCPA)

ConsentMagic integrates with PYS to block the TikTok Pixel and Events API until the visitor accepts ad/data consent. The browser pixel doesn’t load, server events don’t fire, no personal data leaves the site until consent is given.