SUITE MODULE — ANALYTICS & SEO
WordPress Customer Journey Analytics — Track Every Visitor Path From Landing to Conversion
LuperIQ Customer Journey Mapping captures every page view, cart action, and conversion across your WordPress and WooCommerce site. Nine dashboard tabs give you real-time session monitoring, configurable funnel visualization, ecommerce event tracking, visitor segmentation, path analysis, breakdowns by campaign and product, search term extraction, AI referrer detection, and CSV exports — all without leaving your WordPress admin.
The Problem With WordPress Visitor Analytics
WordPress does not include built-in visitor analytics. Most store owners rely on Google Analytics or third-party SaaS tools that send all visitor data to external servers, require separate logins, and cannot show you what happened inside your WooCommerce checkout flow. You see aggregate page views but never the actual sequence of pages a single visitor walked through before they converted or abandoned their cart.
When a customer drops off mid-funnel, you have no way to know which page they were on, whether they added items to their cart first, or what search term brought them to your site. Debugging conversion issues becomes guesswork. You end up switching between multiple dashboards, exporting data manually, and still missing the full picture of how visitors move through your store.
LuperIQ Customer Journey Mapping solves this by recording every session event directly inside your WordPress database. A lightweight frontend beacon captures page views, cart actions, form submissions, and conversions. The admin dashboard lets you replay individual journeys, visualize your funnel with custom regex-based stages, segment visitors by behavior, track search terms from seven major engines, detect AI assistant referrals, and export everything as CSV — all from a single admin page with nine tabs.
Complete WordPress Journey Analytics in One Module
Everything runs inside your WordPress admin. No external services required for core functionality.
Real-Time Session Monitoring
The Overview tab shows active sessions in the last 5 minutes, journeys in the last 24 hours, conversion rate, and average journey time. An activity timeline chart auto-refreshes at configurable intervals from 30 seconds to 30 minutes with a visual countdown and pause control.
Individual Journey Replay
The Journeys tab lists every recent session with session ID, IP address, user ID, start and end times, page count, and duration. Click any session to open a detail modal showing the complete event sequence with timestamps, URLs, referrers, UTM parameters, and dwell time per page.
Configurable Funnel Visualization
Define up to 20 funnel stages using URL regex patterns in Settings. The Funnel tab shows visitor counts and drop-off rates for each stage. Supports time-windowed analysis and period-over-period comparison to spot conversion trends.
Visitor Segmentation
Automatic segmentation classifies visitors into four groups: High Intent (5+ events or cart activity), Browsers (5+ events without conversion), Converters (completed a conversion event), and At Risk (removed items from cart). Segments update with each time range change.
Ecommerce Event Tracking
The Ecommerce tab aggregates add-to-cart, remove-from-cart, form-submit, and conversion events across your selected time window. Counts update via AJAX with full CSV export support.
Search Term Extraction
Automatically parses referrer URLs from Google, Bing, Yahoo, DuckDuckGo, Yandex, Brave, and Ecosia to extract the search queries that brought visitors to your site. Includes trend charts and CSV export.
AI Assistant Referrer Detection
Identifies traffic from ChatGPT, Perplexity, Claude, Microsoft Copilot, and Google Gemini. A dedicated panel shows referral counts by AI platform with hourly trend visualization.
Dual Storage Backend
Events are written to the WordPress database by default with automatic table creation. When ClickHouse is configured, events are simultaneously written to both backends. ClickHouse enables advanced analytics like path analysis, product and campaign breakdowns, and sub-second queries across millions of rows.
Google OAuth Integration
Connect your Google account to pull data from GA4, Google Search Console, and Google Ads directly into the Customer Journey dashboard. The connector status is displayed on both the Overview and Settings tabs.
Who This Module Is Built For
WooCommerce Store Owners
You need to understand why visitors abandon carts and which pages lead to conversions. Customer Journey Mapping shows you the exact path each visitor takes from landing page to checkout, with ecommerce event counts and funnel drop-off rates you can act on.
WordPress Site Administrators
Your site gets traffic from search engines and AI assistants but you have no visibility into what happens after visitors arrive. The Overview tab gives you a single-screen summary of sessions, top pages, top referrers, search terms, and AI referral sources.
Marketing Teams
Campaign UTM parameters are captured with every event. The Breakdowns tab shows performance by campaign and by product. Compare any two time periods side by side to measure the impact of a promotion or content change.
Agencies and Developers
The REST API endpoint accepts custom event types. ClickHouse integration enables path analysis and product breakdowns at scale. WP-CLI commands let you seed demo data and run smoke tests in staging environments.
Nine Dashboard Tabs, One Admin Page
Overview
Active sessions, journeys in 24 hours, conversion rate, average journey time, activity timeline, segments, behavior insights, top pages, top referrers, search terms, AI referrers, and security events.
Journeys
Paginated session list with session ID, IP, user ID, timestamps, page count, and duration. Click to open session detail modal with full event replay. Filter by search engine, search term, or AI referrer host.
Funnel
Regex-based stage configuration with visitor counts and drop-off percentages. Supports time-windowed queries and period comparison with delta indicators.
Visitors
Session-grouped visitor list showing last activity timestamp, total event count, and event type summary. Refreshes independently from other tabs.
Ecommerce
Aggregated counts of add-to-cart, remove-from-cart, form-submit, and conversion events. Time-windowed with CSV export.
Realtime
Live event feed showing timestamp, event type, session ID, and URL for every incoming event. Separate live feed panel streams events as they arrive.
Paths
Visualize the most common visitor paths through your site. See which page sequences lead to conversions and where visitors drop off.
Breakdowns
Analyze performance by campaign, product, referrer source, and other dimensions. Compare time periods to measure the impact of changes.
Settings
Toggle the frontend beacon, configure data retention from 1 to 3650 days, manage funnel stages with a visual editor or JSON input, override the week-start day per user, view Google connector status, and purge old data on demand.
Under the Hood — How Journey Tracking Works
When a visitor loads any page on your site, the lightweight JavaScript beacon sends a POST request to the REST endpoint at /luperiq/v1/cjm/track. The payload includes the page URL, referrer URL, session ID (stored client-side), and any UTM parameters present in the URL. The REST handler writes the event to the WordPress database table wp_luperiq_journey_events with the visitor's IP, user agent, and WordPress user ID if logged in.
If ClickHouse is configured and reachable, the same event is simultaneously written to the ClickHouse journey_events table via HTTP insert. A circuit breaker with a 10-minute cooldown prevents repeated failed ClickHouse writes from slowing down page loads. When ClickHouse is unavailable, the WordPress database continues capturing all events without interruption.
On the admin side, every AJAX endpoint checks the WordPress nonce and verifies manage_options capability before returning data. Query results are cached as WordPress transients with 60-second TTLs to reduce database load. The daily cleanup cron job removes events older than the configured retention period, and background table creation uses a 24-hour transient gate to avoid running CREATE TABLE IF NOT EXISTS on every request.
The module registers with LuperIQ Data Core using the journey.events pipeline alias with a 90-day TTL. When Data Core is active, events flow through the centralized pipeline for cross-module analytics. The module also exposes a WP-CLI command (wp lqcjm smoke) for automated testing that seeds demo sessions, verifies menu registration, checks AJAX handlers, confirms the REST endpoint, and validates that query methods return data.
Advanced Time Range and Comparison
The toolbar provides 14 time range presets: Last 15 minutes, Last 1 hour, Last 6 hours, Last 24 hours, Last 7 days, Last 30 days, Today, Yesterday, This week, Last week, This month, This quarter, Last quarter, and Year to date. You can also set custom date-time ranges with the Advanced panel. The Compare toggle lets you select a second time window and see delta values side by side in the funnel and timeline panels.
Each tab can be individually opted in or out of the global time range via the Apply to Tabs control. The Realtime tab operates independently by default. A Share button copies a URL that encodes the current tab, time range, and comparison settings so you can send a specific view to a team member. All toolbar preferences — including the selected tab, auto-refresh interval, and time range — are saved per user via AJAX and restored on the next visit.
Frequently Asked Questions
Does this module require WooCommerce?
No. Customer Journey Mapping works on any WordPress site. WooCommerce is optional — when active, the module tracks ecommerce-specific events like add-to-cart, remove-from-cart, and conversion. Without WooCommerce, it still tracks page views, form submissions, and custom events.
Will this slow down my site for visitors?
The frontend beacon is a lightweight JavaScript file that sends a single asynchronous POST request per page load. The REST endpoint responds immediately and writes to the database in the same request cycle. ClickHouse writes use a 1-second timeout so they never block the visitor's experience.
Do I need ClickHouse to use this module?
No. The WordPress database is the default and fully functional backend. ClickHouse is optional and enables advanced features like path analysis, product and campaign breakdowns, search term extraction, and AI referrer detection. All core features — sessions, funnel, visitors, ecommerce, and realtime — work with the WordPress database alone.
How does the funnel work?
You define up to 20 stages in Settings, each with a name and a URL regex pattern. The module counts distinct session IDs whose URLs match each pattern within the selected time range. Drop-off rates are calculated as the percentage decrease from one stage to the next.
What data is stored and for how long?
Each event record contains a session ID, Unix timestamp, event type, page URL, referrer URL, UTM source, medium, and campaign, WordPress user ID, IP address, and user agent. The default retention period is 90 days, configurable from 1 to 3650 days. A daily cron job automatically purges expired records.
Can I export data?
Yes. Nine CSV export endpoints cover sessions, events, ecommerce, funnel stages, error logs, search terms, AI referrers, top paths, and breakdowns. Individual sessions can also be exported as CSV or JSON from the session detail modal.
How does the Google integration work?
The module checks for the LuperIQ Google Connector, which handles OAuth authentication with Google. Once authenticated, you can connect GA4 properties, Google Search Console sites, and Google Ads accounts. The connector status is displayed on the Overview and Settings tabs.
Is the data private and secure?
All data stays in your own WordPress database and optional ClickHouse instance. No visitor data is sent to external services. Every admin AJAX request requires a valid WordPress nonce and manage_options capability. REST endpoint tracking verifies nonces for logged-in users. Database queries use prepared statements and all output is escaped.
See Every Visitor Journey on Your WordPress Site
Install LuperIQ, activate Customer Journey Mapping, and start tracking visitor paths in minutes. Real-time monitoring, funnel visualization, ecommerce analytics, and CSV exports are all included.