PixLedger
PixLedger fires your Meta Pixel, GA4, and GTM events AND logs every single event locally — so you always know what was tracked, what failed, what was blocked by consent, and why.
The Event Intelligence Layer
Every event that fires through PixLedger is recorded in your own database with a full audit trail: which provider received it, whether it was delivered successfully, whether it was blocked by consent, and the complete payload that was sent.
What PixLedger Tracks
WooCommerce Events * ViewContent — product page visits * AddToCart — cart additions with product data * RemoveFromCart — cart removals * CartView — cart page visits * InitiateCheckout — checkout page visits * AddPaymentInfo — payment details entered * AddShippingInfo — shipping details entered * CouponApplied — discount codes applied * Purchase — completed orders with full order data * OrderRefunded — refunds issued * ProductReview — WooCommerce product reviews submitted
Universal WordPress Events (works on any WordPress site) * PageView — every frontend page load with page context * NotFound404 — 404 errors with requested URL * OutboundLinkClick — clicks on external links * PhoneClick — clicks on tel: links * EmailClick — clicks on mailto: links * DownloadClick — clicks on downloadable files (PDF, ZIP, DOC, etc.) * FormSubmit — any form submission * UserLogin — user login events * UserRegister — new user registrations * CommentPosted — comment submissions * SearchPerformed — site search queries * SearchEmpty — searches with zero results
Custom Events
* Declarative: add data-pxl-event="EventName" to any HTML element — no code needed
* Programmatic: pxl('track', 'EventName', { properties }) for developers
Supported Providers
- Meta Pixel — browser-side pixel events with advanced matching (hashed email)
- Google Analytics 4 — GA4 ecommerce events with full items array
- Google Tag Manager — dataLayer pushes in GA4 Enhanced Ecommerce schema
Key Features
Event Log A real-time, searchable log of every event that fires on your site. See exactly what was tracked, by which provider, with what payload. Filter by provider, event name, status, or date. Paginated with bulk delete and auto-refresh.
Event Configuration Panel Choose exactly which events PixLedger tracks. Enable or disable any event individually. Defaults are sensible out of the box — turn off what you don’t need, enable what you do.
Consent Mode v2 Built-in Consent Mode v2 support. Events are blocked at the pipeline level when consent is denied — not as an afterthought. The Event Log shows blocked events with the specific consent category that denied them.
Tag Detection PixLedger detects if Meta Pixel, GA4, or GTM are already loaded by another plugin or your theme. It skips its own injection automatically to prevent duplicate events. Detection notices are shown in Settings.
Visitor ID Tracking Every event is tagged with an anonymous visitor ID (90-day cookie) so you can trace a visitor’s journey across sessions. Visible in the Event Log — clickable journey view available in Pro.
Attribution Capture UTM parameters, click IDs (fbclid, gclid, ttclid, msclkid), landing page, and referrer are captured on every page load and saved to the order on purchase.
Rate Limiting Configurable rate limiting prevents spam bots from flooding your event log. Default: 5 same-event repetitions per visitor per minute. Adjustable in Settings.
Works on Any WordPress Site
PixLedger works with or without WooCommerce. Universal events (PageView, clicks, forms, search, user account events) fire on any WordPress site. WooCommerce ecommerce events load automatically when WooCommerce is detected.
Privacy & GDPR
- Customer emails are SHA-256 hashed before storage — never stored in plain text
- Visitor IDs are anonymous — no personally identifiable information
- Form field values are never captured — only form metadata
- Event log retention is fully configurable (minimum 1 hour, default 7 days, no upper limit)
- Full data removal on plugin deletion via uninstall.php
PixLedger Pro
PixLedger Pro adds server-side tracking, advanced analytics, and journey intelligence:
- Meta Conversions API (CAPI) — server-side events that bypass ad blockers
- GA4 Measurement Protocol — server-side GA4 events
- Google Ads Enhanced Conversions — server-side conversion API
- Reconciliation Dashboard — compare platform-reported conversions vs actual WooCommerce data
- Attribution Dashboard — first-touch, last-touch, and multi-touch attribution reports
- Visitor Journey Intelligence — click any visitor ID to see their complete event timeline
- Product Journey View — see the last N journeys that led to buying a specific product
- Advanced Event Log — extended date range, CSV/JSON export
- Additional platforms — TikTok, Pinterest, Microsoft Bing, and more
Learn more at pixledger.com.
External Services
PixLedger connects to the following third-party services to deliver tracking events to advertising and analytics platforms. These connections only occur when the respective provider is enabled and configured in Settings.
Meta Pixel
PixLedger loads the Meta Pixel script (fbevents.js) from connect.facebook.net and sends ecommerce and page events to Meta on every relevant page load. This occurs only when Meta Pixel is enabled and a Pixel ID is configured. Data sent includes event names, page URLs, and hashed customer email (for advanced matching). No data is sent if Meta Pixel is disabled in Settings.
Google Analytics 4
PixLedger loads the GA4 script (gtag.js) from googletagmanager.com and sends ecommerce and page events to Google Analytics on every relevant page load. This occurs only when GA4 is enabled and a Measurement ID is configured. Data sent includes event names, page URLs, and ecommerce data (product names, prices, order values). No data is sent if GA4 is disabled in Settings.
Google Tag Manager
PixLedger loads the GTM container script (gtm.js) from googletagmanager.com and pushes events to the window.dataLayer object. This occurs only when GTM is enabled and a Container ID is configured. The data pushed includes event names and ecommerce data in GA4 Enhanced Ecommerce schema. No script is loaded if GTM is disabled in Settings, or if GTM is already loaded by another plugin or your theme.
