TikTok tracking for WooCommerce, without unnecessary complexity

TikTok Pixel connects your WordPress or WooCommerce website to TikTok’s measurement tools. It can record important actions such as product views, searches, additions to cart, checkout activity, registrations and completed purchases.

The plugin is modular. You can use a simple browser Pixel, server-side Events API tracking, or both together. Optional TikTok services remain switched off until you actually need them, so a small webshop does not have to configure developer or advertising features it will never use.

Choose the tracking method that suits your website

Browser Pixel only is the simplest setup. Events are sent from the visitor’s browser and only a valid TikTok Pixel ID is required.

Events API only sends selected events from the website server. This can provide more reliable delivery when browser scripts are blocked, while keeping the Events API token away from frontend code.

Pixel + Events API uses both channels. Matching browser and server events share the same event ID, allowing TikTok to identify duplicate copies and count the conversion once.

WooCommerce conversion tracking

The plugin understands WooCommerce products, variations, quantities, prices, currencies and order totals. It can map the customer journey from a product view through cart and checkout to Purchase.

Purchase events use a persistent order-based event ID. Refreshing the thank-you page, changing an order status or retrying a failed server delivery does not create a new conversion identity for the same order.

• Product and product-category views
• WordPress and WooCommerce searches
• Classic and AJAX add-to-cart actions
• WooCommerce Blocks cart and checkout support
• Checkout and payment-information events
• Registration and completed Purchase events
• Simple and variation product data
• HPOS-compatible order delivery information

All current TikTok web standard events

The event manager includes the current TikTok web standard-event set:

AddPaymentInfo, AddToCart, AddToWishlist, ApplicationApproval, CompleteRegistration, Contact, CustomizeProduct, Download, FindLocation, InitiateCheckout, Purchase, Schedule, Search, StartTrial, SubmitApplication, SubmitForm, Subscribe and ViewContent.

Each event can be enabled or disabled and assigned to the browser Pixel, Events API or both. This lets the website owner collect only the events that are relevant to the business.

Background Events API delivery

Server events are placed in a controlled background queue instead of making the customer wait for TikTok during checkout. WooCommerce Action Scheduler is used when available, with WordPress Cron as a fallback.

Temporary delivery errors are retried with a bounded delay. Events are grouped by connection, successful personal payloads are removed, and a limited non-personal receipt is retained to prevent the same event from being queued again.

Consent and privacy controls

Tracking can wait for marketing consent. The plugin can use a site-managed consent decision, the WordPress Consent API or a developer filter for a custom consent platform.

Advanced Matching and attribution are optional and disabled on a new installation. Email addresses, phone numbers and external customer IDs are normalized and SHA-256 hashed before transmission. Direct match keys such as IP address, user agent, ttclid and _ttp can be controlled separately.

The website owner remains responsible for choosing a lawful consent setup, updating the privacy notice and enabling only the data fields required for the intended TikTok campaigns.

Optional TikTok modules

• Custom Events: create controlled click, form-submit and page-view rules or send an event through a shortcode, JavaScript or PHP hook.
• Matching & Attribution: add consent-based matching data and record first-touch or last-touch TikTok click and UTM attribution.
• TikTok Login Kit and Display API: authorize a reviewed TikTok developer application and display the connected profile or videos with shortcodes.
• Ads & Reports: read advertiser, campaign and integrated performance data from an approved TikTok API for Business account. This module does not create or edit campaigns.
• Developer Webhooks: receive supported TikTok developer notifications through a signed endpoint with timestamp, replay and request-rate protection.

Secure connection and license storage

Measurement, Developer and Business connections are stored as separate profiles. Access tokens, refresh tokens, client secrets and license data use site-bound authenticated encryption and are not printed into frontend configuration.

The plugin uses the Eupor IT SLM Plus licensing and update system. Tracking and licensed API modules run only with an active license and intact protected plugin files. The license page remains available if activation needs to be repaired, and public version information can still be displayed without an active license.

Designed for controlled growth

You can begin with a single Pixel ID and later add Events API, attribution, profile display or reporting when the website is ready. Disabled modules do not register their related frontend hooks or API work, helping to keep the plugin focused on the features that are actually in use.

TikTok products that require a separate partner agreement, regional Shop access, advertiser write permission or application review are not presented as ordinary switches. These integrations should only be added after the required TikTok access and real acceptance testing are available.

Version 3.0.0

TikTok Pixel – Modular TikTok Tracking for WordPress and WooCommerce.
- Added an optional Quick Setup wizard for Pixel-only, Events API-only and hybrid tracking.
- Added a modular feature registry so unused TikTok integrations can remain disabled.
- Added encrypted Measurement, TikTok Developer and Business API connection profiles.
- Added all 18 current TikTok web standard events with separate Pixel and Events API controls.
- Added support for multiple Pixel IDs with isolated browser instances.
- Added shared browser/server event IDs and persistent WooCommerce Purchase deduplication.
- Added selectable Purchase milestones, same-ID retry and HPOS-compatible order delivery status.
- Added Action Scheduler background delivery with WP-Cron fallback, bounded retries and Retry-After support.
- Added optional Advanced Matching with shared browser/server normalization and SHA-256 hashing.
- Added consent-based ttclid and UTM first-touch or last-touch attribution.
- Added WordPress personal-data export and erasure support for stored order attribution.
- Added TikTok Login Kit OAuth with one-time state validation, encrypted refresh tokens, renewal and revocation.
- Added Display API shortcodes for authorized profiles, recent videos and selected videos.
- Added read-only advertiser, campaign and integrated performance reporting.
- Added signed Developer webhooks with timestamp, replay and request-rate protection.
- Added a fixed official TikTok endpoint allowlist, safe response limits and structured errors.
- Expanded the Eupor IT admin area with Modules, Connections, Events, Ads & Reports, Diagnostics and Help.
- Preserved Eupor IT SLM Plus Product and Item Reference 30177 and the stable tiktok-pixel update identifier.
- Expanded protected core-file integrity checks and privacy-focused uninstall cleanup.
- Fixed unpaid payment-complete Purchase tracking, consent-denied registration loss, disabled custom rules and multiple-Pixel startup edge cases.

Version 2.0.0

TikTok Pixel – TikTok Pixel and Events API integration for WooCommerce.
- Rebuilt conversion tracking around TikTok Pixel and Events API 2.0.
- Added browser-only, server-only and hybrid tracking modes.
- Added shared event ID deduplication for Pixel and Events API events.
- Added WooCommerce funnel events, product data, currency, value and order mapping.
- Added Advanced Matching, consent controls and a bounded asynchronous event queue.
- Added encrypted Eupor IT SLM Plus licensing and protected update authorization.
- Added Product Reference and Item Reference 30177 while retaining tiktok-pixel as the update identifier.

Version 1.0.1

TikTok Pixel - TikTok Pixel Integration for WooCommerce.
- Plugin updates as per TikTok latest documentation

Version 1.0

TikTok Pixel - TikTok Pixel Integration for WooCommerce.
- Initial release