Debugging

The debug overlay lists every event Pixelonce considered on a page, whether it fired, and — the part that matters — why it did not.

Open the overlay

Add ?stepcount_debug=1 to any URL. On a live host the overlay opens for logged-in administrators only; on a dry-run (staging) host it opens for anyone. The stepcount_debug_allowed filter changes who may open it.

Pixelonce was first developed as StepCount, and the plugin still uses that name in its code: the stepcount_debug URL parameter, the stepcount_* filters and the StepCount JavaScript object. They are the real names; use them as written.

Reading a suppression

scope revisit — reload or re-entry from the same rule (checkout-step-2)

That line says: the event is set to once per visit, and the visitor arrived from the same page it was already fired for — so it was a reload or a re-entry, not a new arrival. Other common reasons:

  • scope session / visitor / entity — already fired for this session, visitor or value.
  • consent — the visitor has not granted consent (or refused it).
  • dry run — this host is not in the live-hostnames list; evaluated and logged, not sent.
  • sent elsewhere — the event is listed under Events sent elsewhere.

From the browser console

The plugin's JavaScript API is the StepCount object (its original name):

StepCount.context()   // visitor and session ids, page key, previous page key, dry-run state
StepCount.log()       // every decision made on this page

wp-config.php switches

ConstantEffect
STEPCOUNT_ENABLEDfalse switches all tracking off without deactivating the plugin
STEPCOUNT_LIVE_HOSTScomma-separated live hosts; overrides the setting
STEPCOUNT_FORCE_LIVEsend for real from a non-live host (logged on every request)
STEPCOUNT_TEST_PIXELsend every event to this one pixel id instead

When the template lies

Some templates render a different step than their URL says (a form that advances without changing the query string). The stepcount_request filter lets you correct the path and query Pixelonce matches pages against, so the decision is made on what the visitor actually sees.