PixelFox Docs
Installation

WordPress

The PixelFox plugin for WordPress and WooCommerce.

The PixelFox WordPress plugin installs the tag on every page and, with WooCommerce active, tracks the whole funnel - with the purchase sent server-side so it survives ad blockers. It runs in two modes: offline (anonymous, nothing leaves your server, an API key is the whole setup) and online (the full product with identity, segments and the dashboard).

Install

  1. Download the plugin zip from your PixelFox dashboard.
  2. Plugins → Add New → Upload Plugin, upload the zip, activate PixelFox.
  3. Open Settings → PixelFox and paste your API key - the only required setting - then pick the mode and your business category.

Settings

SettingWhat it does
ModeOffline - anonymous only or Online - full dashboard. See below
API keyYour site's key. Required
Site IDNeeded for courier fraud checks and feedback. Found in your dashboard URL
Business categoryShows the recommended conversion events for your kind of store
WooCommerce eventsTrack product views, add-to-cart, checkout and purchases (on by default)
Courier fraud checkShow a COD risk score on the order screen
COD restrictionWithdraw cash on delivery below a delivery success rate you choose (default 60%). Fails open: if the lookup is unavailable, COD stays enabled
Custom loaderLoad vendor tags (GTM, GA4, Meta, TikTok) through your first-party tracking domain, so blocklists matching the vendors' domains do not fire
Advanced → Ingest hostWhere the tag sends events and where it is loaded from. Leave blank for api.pixelfox.app; set it to your custom ingest endpoint, e.g. https://t.yourstore.com, to serve everything from your own domain
Advanced → Dashboard API host, Script URLLeave blank unless you self-host

Re-check connection at the bottom of the page tests the key against the host.

Offline and online

OfflineOnline
The tagA tiny local collector; no external scriptThe PixelFox tag from the ingest host
Where events goA table in your own database only. No page view or conversion is transmittedYour database and PixelFox
IdentityNot collectedLogged-in shoppers identified, cross-device stitching, segments
Dashboard reportingThe plugin's own sales summaryThe full dashboard
Courier fraud checksWork in both modes - they are queries against the shared fraud dataset by nature, and can be turned off

Switch modes at any time; nothing already recorded is lost.

WooCommerce events

With WooCommerce active you get, with no extra configuration:

  • product_viewed on product pages; view_cart on the cart page; search with the query on search results.
  • add_to_cart - on form posts and on AJAX adds (the event rides back with the cart fragments, so themes like Astra, Flatsome and Kadence work without a page reload); remove_from_cart.
  • checkout_started when the checkout form renders (CartFlows steps that are not the checkout are skipped).
  • complete_registration on a new account's first page.
  • purchase - sent server-side from woocommerce_thankyou and from the processing/completed status transitions (a closed tab still counts), with the order id, total, currency, line items, the billing profile (online mode), the shopper's IP and user agent, and the click ids, _fbp/_fbc/_ttp/Reddit/UET cookies, GA client id and PixelFox device id snapshotted on the order at checkout. Once per order.

Logged-in shoppers are identified to the tag once per session (online mode), so the anonymous browsing before login, the account, and every device they use join one person - see identity and devices.

Attribution

The plugin keeps first-touch (90 days) and last-touch (7 days) cookies with the UTM parameters, the click ids (gclid, fbclid, msclkid, ttclid, li_fat_id, ScCid, rdt_cid, twclid, wbraid, gbraid) and the landing URL, and stamps them on the order at checkout.

Also in the plugin

  • COD protection: withdraw cash on delivery below a risk threshold, add an advance payment fee, and block checkout for listed phones or IPs. See COD protection.
  • Fraud meta box on the order screen with the cross-courier history, and feedback.
  • Delivery outcomes reported from order status changes into the shared fraud dataset.
  • Deleting the plugin removes its options, blocklists and local events table.

The plugin's folder, main file (pixelfox.php), settings option and text domain are named pixelfox. A store that installed the plugin while it was still called "Signals" keeps its settings: the first load after updating copies them across, and nothing needs re-entering.

On this page