Conversion Tracking

Analytics tools show you page views easily — but the events that matter, the purchases, never reach them. This function sends every Voxel purchase to Google Analytics 4 and Umami as real conversion events: transaction ID, order value, currency, and line items.

Overview

Everything sold through Voxel flows through its order system — product orders, bookings, promotions, membership plans, listing plans, claim requests. Conversion Tracking captures each purchase at the exact moment the order is paid (race-proof against duplicate payment webhooks) and dispatches it in the customer's own browser session, so your campaign and traffic-source attribution stays intact.

• GA4 receives a standard purchase event — it feeds GA4's Monetization and conversion reports natively
• Umami receives a purchase event with the order data

Key Features

• Covers every Voxel purchase type: products, bookings, promotions, memberships, listing plans, claims
• Real GA4 ecommerce events with transaction ID, value, currency, and items
• Zero configuration — auto-detects your existing GA4/Umami snippet from any source (the Analytics & Custom Tags function, another plugin, or a pasted snippet)
• Fires exactly once per order — duplicate payment webhooks can't double-count
• Dispatches in the buyer's real browser session for correct attribution
• Fully page-cache safe

Setup Instructions

1. Navigate to Voxel Toolkit → Functions and enable Conversion Tracking
2. Make sure a GA4 or Umami snippet is on your site — the easiest way is the Analytics & Custom Tags function
3. Done — the next paid order appears in your analytics as a conversion

Settings

All optional — the defaults track everything, everywhere:

Setting	Description	Default
What to track	Which purchase categories count: products & bookings, promotions, memberships, listing plans, claims	All
Send to	GA4 and/or Umami	Both
Skip zero-value orders	Ignore free purchases (e.g. free listing plans)	Off
Track test-mode orders	Include Voxel test-mode purchases — useful while verifying your setup	Off

How It Works

1. An order is paid — Voxel marks the moment atomically, so it can only be counted once
2. The conversion is queued for that customer
3. On their next page load (normally the order confirmation page, seconds later), the event fires in their browser through gtag() / umami.track()
4. Attribution — campaign, source, session — is preserved because the event fires in the buyer's real session

Verifying Your Setup

1. Enable Track test-mode orders
2. Make a test purchase
3. Watch the purchase event arrive in GA4 DebugView or Umami realtime
4. Turn the setting back off for production

Use Cases

Ad Campaign ROI

See which campaigns actually produce paying members and listing upgrades, not just clicks.

Revenue Reports in GA4

Voxel revenue appears in GA4's Monetization reports with real values and items.

Privacy-Friendly Tracking

Umami users get conversions without adding Google to the site.

Troubleshooting

Conversions not appearing

• Confirm a GA4 or Umami snippet actually loads on your site (check the browser console for gtag/umami)
• The event fires on the customer's next page load after payment — the buyer must return to the site (the checkout redirect normally does this)
• Ad blockers block analytics scripts; test in a clean browser

Test purchases don't track

• Test-mode orders are skipped by default — enable Track test-mode orders while verifying

Renewals missing

• Subscription renewals that happen entirely in the background are queued until the customer's next visit