Getting started
From a fresh install to a funnel that reports one event per step, usually in about ten minutes.
1. Install and activate
- Install it from WordPress.org: in your dashboard go to Plugins → Add New, search “Pixelonce” and click Install. Or download the free zip (no account or key needed) and upload it under Plugins → Add New → Upload Plugin.
- Upload it under Plugins → Add New → Upload Plugin and activate it.
2. Run the setup wizard
The wizard opens on first run and asks for one thing per step:
- Pixel — your Meta pixel (dataset) id. Pixelonce loads the pixel itself at the top of
<head>and turns off automatic event detection, so nothing fires that you did not declare. Remove any other copy of the same pixel from your theme or other plugins. - Pages — the steps of your funnel. A page is a URL path plus optional query conditions.
- Server copy (optional) — a Conversions API access token. See Conversions API.
- Test — open the funnel with the debug overlay and watch the decisions.
3. Describe each step as its own page
This is the one rule that matters most. If your form keeps every step on /apply and changes ?step=, create one page per step with a different query condition. Each page is its own “where did the visitor come from” key; merge two steps into one page and moving between them looks like a reload, so the second step's event never fires.
| Page | Path | Query | Event |
|---|---|---|---|
| apply-start | /apply | step=1 | InitiateCheckout · once per session |
| apply-details | /apply | step=2 | ViewContent · once per visit |
| apply-done | /apply | step=done | Lead · once per visitor |
If the steps change by ajax without changing the URL at all, fire the events from a binding instead.
4. Set your live hostnames
Under Settings → Live hostnames, only the listed hosts send real events. Every other host runs in dry run: events are evaluated and shown in the overlay but never sent. The site's own host is filled in on activation, so a staging copy made later starts safely in dry run.
5. Check it
Add ?stepcount_debug=1 to a funnel URL while logged in as an administrator, walk through the steps, reload, press back. Every event should fire exactly when you expect — and the overlay tells you why each one did not. More in Debugging.
Free and Pro
Pixelonce is free: Meta's standard events and your own custom events, with no limits on events, pages or pixels, the Conversions API copy, consent handling and the debug overlay.
Pro is coming soon: a separate add-on with Google Analytics 4, more ad platforms (TikTok, Google Ads, LinkedIn, Pinterest) and priority support. Join the waitlist.