WordPress

The PixelFox WordPress plugin injects the tag on every page and - when WooCommerce is active - records product_added_to_cart and server-side purchase events.

Install

1. Download signals.php (or copy it from packages/wordpress/ in the repo).
2. Upload it to wp-content/plugins/ (or zip it and use Plugins → Add New → Upload).
3. Activate PixelFox in the plugins list.
4. Open Settings → PixelFox and paste:
   • API key - from your PixelFox dashboard.
   • Host - your ingest API URL, e.g. https://api.pixelfox.app.
   • Script URL - where signals.min.js is served from.

The tag is injected via the wp_head hook on every front-end page.

WooCommerce events

With WooCommerce active you get, with zero extra configuration:

• product_added_to_cart - fired on the next page render after an add-to-cart (flashed through the session), with product_id, product_name, price, quantity and currency.
• purchase - sent server-side from the woocommerce_thankyou hook (and the processing/completed status transitions, so a closed tab still counts) straight to /v1/ingest, with order_id, total, currency, the line items, the full billing profile (email, phone, name, city, state, postcode, country), the customer id, the shopper's IP and user agent as recorded by WooCommerce, and the _fbp/_fbc cookies and click ids snapshotted on the order at checkout. Because it originates on your server it is immune to ad blockers, and the profile lets PixelFox hash and forward every match key Meta and TikTok weigh.

Limitations

• AJAX/block-based carts don't reload the page, so the flashed product_added_to_cart event fires on the next page navigation. For instant tracking, define a click event on your add-to-cart button in the dashboard instead - no code needed.
• The server-side purchase event uses a fresh UUID as its event_id. If you also track purchases in the browser on the thank-you page, disable one of the two to avoid double counting on GA4 (Facebook/TikTok dedup only applies when both sides share an id).