documentation
Documentation
Start with Getting Started if you are installing. Go straight to Troubleshooting if something is already wrong — those pages are written from real debugging sessions, in the order the causes are worth checking.
42 articles · 13 written in full · the rest are outlines with their facts marked as unverified rather than guessed.
Getting Started
Install the plugin, connect Meta in about three minutes, and end on a matched pair you can see.
-
Install and activate
What PixelCapi needs from your server, how to install it, and the one thing to do straight after activating on a cached site.
-
The 3-minute setup (Meta)
Paste a Pixel ID and a Conversions API token. Which of the two Events Manager token options to pick, and the one step to do before pasting a real token.
-
Free vs Pro
What a PixelCapi Pro licence controls, what happens when one lapses, and which parts of the free-versus-paid split are still being decided.
-
Add Google (GA4 and Google Ads)
GA4 and Google Ads are separate products sharing one tag. What PixelCapi sends to each, why the GA4 tag is browser-only, and what is not implemented yet.
-
Add TikTok
TikTok wants the same customer data as Meta in a different shape. What differs, what the plugin handles for you, and what is not confirmed live.
-
Verify your first event
How to prove a browser event and a server event were paired — the exact evidence to look for, and what a healthy result looks like.
Platforms
What each platform needs, what it does differently, and where its own tools disagree with each other.
-
Meta
Pixel plus Conversions API, tokens and scopes, Test Events, multi-pixel and match quality — the full Meta reference.
outline
-
Google
GA4 Measurement Protocol, the Google Ads tag, Consent Mode v2 and DebugView — including what is confirmed and what is not.
outline
-
TikTok
Events API, test events and the hashing differences that make TikTok's requirements incompatible with Meta's.
outline
Events Reference
One page per event: when it fires, which side sends it, how it deduplicates, and what data it carries.
-
PageView
Fires on every page load. Browser and server, paired by a shared event ID generated at runtime.
outline
-
ViewContent
Fires on product and content pages. Browser and server, paired by a shared event ID.
outline
-
AddToCart
Fires when a product is added to the cart. The dedup path differs between the classic cart and the blocks cart.
outline
-
InitiateCheckout
Fires when checkout begins. Browser and server, paired by a shared event ID.
outline
-
AddPaymentInfo
Fires when payment details are entered at checkout.
outline
-
Purchase
Server-first: fires from the payment hook so the sale survives a thank-you page that never loads.
outline
-
Refund
Fires when an order is refunded in WooCommerce.
outline
-
Lead
Server-only by design. Fires on form submission through the supported form plugins.
outline
-
CompleteRegistration
Fires when a customer account is created.
outline
-
Search
Fires on site search. Browser and server, paired by a shared event ID.
outline
-
AddToWishlist
Fires when a product is added to a wishlist.
outline
Tools
The in-plugin instruments: Dedup Doctor, logs, diagnostics, and the roadmap tools that join them.
-
Dedup Doctor
The browser copy and the server copy of every event, side by side, compared by their actual event IDs.
outline
-
Logs and filters
The plugin's own send log: queue statuses, retries, and what to look at when an event has not arrived.
outline
-
Order-to-Event Reconciliation
In developmentDesigned to line WooCommerce orders up against the Purchase events that were actually sent, so a missing sale has an order number.
outline
-
Match Quality Center and Identity Store
In developmentDesigned to show which parameters each event actually carried, and to give guest checkouts a durable identifier.
outline
-
Health Watchdog and alerts
In developmentDesigned to keep checking after setup day and tell you when events stop arriving.
outline
-
Conflict Scanner
In developmentDesigned to name the other plugin, theme snippet or container that is firing the same pixel as you.
outline
-
Diagnostics and reachability
The plugin's self-report: what cannot be delivered with the current configuration, and why.
outline
Integrations
WooCommerce, form plugins and consent tools — what is detected automatically and what you configure.
-
WooCommerce
HPOS, the blocks cart, Subscriptions and refunds — what is automatic and what needs checking.
outline
-
Forms
Lead tracking through the supported form plugins, and why it is server-only.
outline
-
Consent plugins
How the plugin's consent source works, what fail-closed means, and how it relates to Google Consent Mode.
outline
Troubleshooting
The failures that actually happen, in the order they are worth checking, written from real debugging.
-
Events don't show — the ordered checklist
Seven causes in the order they are worth checking. Most ‘nothing is tracking’ reports are the first two, and both take under a minute to rule out.
-
Processed vs Deduplicated
What Meta's two labels actually mean, why a "deduplicated" server event is good news, and what a healthy row looks like.
-
LiteSpeed Cache and REST caching
Settings that save, then come back empty five minutes later. The cause is a cached REST response, not a broken save, and the fix has shipped.
-
Purchases missing after PayPal
Offsite payment means the thank-you page often never loads. Why Purchase fires from the payment hook instead, and why consent is stored at checkout.
-
Duplicate events
Five ways one conversion becomes two, how to tell them apart, and why a second plugin is the most common cause.
-
Match quality dropped
The costliest match-quality failure is invisible: a wrongly lowercased name hashes to something that matches nobody, and nothing reports an error.
-
Token error #100 — read versus write
A healthy Conversions API token fails a read with error #100. That is normal. The same error on an events POST is not, and means something different.
Account & Billing
Licences, sites, invoices, refunds and cancellation.
-
Licence activation
How a licence key is issued and activated on a site.
outline
-
Managing your sites
Adding, removing and moving site activations within your tier.
outline
-
Invoices and VAT
Freemius is the merchant of record and handles EU VAT and invoicing.
outline
-
Refunds
The 14-day money-back guarantee and how to request one.
outline
-
Cancelling
What stops and what keeps working when a subscription ends.
outline
Still stuck?
Run the free checker on the page that is misbehaving. It reads what a real visitor sees, which is usually where the answer is.