Troubleshooting

An event never fires on the second step

Both steps are probably one page. Give each step its own page with a different query condition — see Getting started, step 3. The overlay will show scope revisit — reload or re-entry from the same rule.

Events show in the overlay but never reach Events Manager

Check the overlay header for dry run. If the host is not in Settings → Live hostnames (or STEPCOUNT_LIVE_HOSTS), nothing is sent. Then check consent: in require mode, nothing is sent until the visitor grants it.

Every event appears twice in Events Manager

Another copy of the same pixel is still installed — in the theme, a tag manager or another plugin. Pixelonce must be the only thing loading that pixel. Duplicate browser + server pairs with the same event id are normal and deduplicated by Meta.

A click or form event stopped firing after an update

Open the trigger health check on the Pixelonce dashboard. A selector or ajax action that has not matched recently is flagged — usually a renamed CSS class or a changed form action.

My conversions don't match Ads Manager

Event counts and attributed conversions are different numbers: attribution windows, view-through conversions, modelled conversions and the ad account's settings all change what Ads Manager reports. First confirm with the overlay that each step fires exactly once per applicant. If it does, the difference is almost always attribution, not tracking.

Pro (when it launches): the licence says site_limit

Your plan's sites are all in use. Deactivate the licence in Pixelonce → Settings → Licence on a site you no longer use, or see which hosts are active on the Manage licence page.

How do I update the free plugin?

Download the latest zip from this site and upload it under Plugins → Add New → Upload Plugin; WordPress offers to replace the installed version and keeps your settings. Updates also arrive automatically from WordPress.org under Dashboard → Updates, including for sites that installed the zip from this site.

Still stuck?

Use the support form and attach the diagnostic export from Pixelonce → Support → Download diagnostic file. It is required: it holds your configuration, recent decisions and the trigger health report, which is what we need to answer.