Documentation · Admin Reference
Analytics Reference
This document is a reference for the Analytics screen of the ADP Car Market Hub plugin (Car Market Hub → Analytics). It covers how analytics tracking works, the dashboards available, the privacy controls, the optional CMP consent gate and the danger-zone purge action.
When to use this document
Use this reference when you want to enable or tune in-plugin analytics, understand the difference between basic page-view tracking and Business Intelligence (BI) tracking, configure data retention and privacy settings, integrate with an external Consent Management Platform, or remove all stored analytics data.
Overview
The Analytics screen always shows a top KPI strip with five cards (Total Inventory, New Imports, Avg. Price, Total Leads, Conversion Rate), a period selector (7 / 14 / 30 / 90 / 180 days, restricted by the configured retention) and a settings card. When tracking is enabled, additional dashboard rows are rendered below.
Two tracking modes are available:
- Page-view tracking — records views on vehicle detail, archive, compare and favorites pages.
- BI tracking — additionally records filter searches, contact form opens and lead events, enabling conversion funnel and top-search analyses.
Privacy is treated as a first-class concern: a jurisdiction selector, a free-text minimization toggle and an optional external-consent gate are exposed alongside the tracking switches.
Requirements or prerequisites
- Permission to manage the plugin.
- A vehicle inventory imported through Car Market Hub.
- For meaningful conversion / BI metrics: enable lead capture (see Leads Reference).
- For the CMP gate: a Consent Management Platform or cookie banner that can set
window.as24ciConsentGranted = true(client side) and respond to theas24ci_analytics_consent_checkPHP filter (server side).
Step by step instructions
Enable analytics
- Open Car Market Hub → Analytics.
- Toggle Enable Analytics on to start collecting page views on vehicle detail, archive, compare and favorites pages.
- Optionally toggle Enable BI Tracking on to additionally record filter searches, contact form opens and leads.
- Set Data Retention (days) between 7 and 365.
- Save.
Use the dashboards
- At the top of the screen, choose a Select Period value (7 / 14 / 30 / 90 / 180 days). The selector is filtered to periods that fit within the active retention window.
- The five KPI cards compare the selected period against the immediately preceding period of the same length and show a trend indicator.
- Scroll down to view, in order: Import Activity, Views Per Day, Conversion Funnel (BI only), Engagement by Page Type, Vehicles by Body Type, Top Filter Searches (BI only), Standing Time Analysis (BI only), Price Performance (BI only), Most Viewed Vehicles (BI only), Most Inquired Vehicles (BI only), Price Distribution, Price Distribution Insights and Market Intelligence (BI only).
- The Standing Time, Price Performance, Most Viewed and Most Inquired tables each have a Show N rows dropdown (5 / 10 / 20 / 30 / 50 / 100, default 5) to control how many rows that table displays.
Configure privacy controls
- Keep Filter Data Minimization on (recommended) so free-text search values (such as the
squery parameter) are stripped from filter records before storage. - Choose a Privacy Law / Jurisdiction value, or leave Auto-detect to let the plugin infer it from your AutoScout24 API domain and configured currency.
- Save.
Connect to a Consent Management Platform
- Scroll to the CMP Consent Integration card at the bottom of the page.
- Toggle Require External Consent Signal on. This blocks all analytics tracking until consent is signaled.
- Configure your CMP / cookie banner to:
- set
window.as24ciConsentGranted = trueonce consent is granted (client-side), - returntruefor theas24ci_analytics_consent_checkPHP filter (server-side). - Save. Until both signals are present, no analytics data is collected.
Purge all analytics data
- Scroll to the Clear All Analytics Data card (Danger Zone).
- Click Purge All Data and confirm in the modal.
- All page views, leads, filter searches and contact events are deleted permanently and cannot be recovered.
Configuration reference
Settings card
| Field | Notes |
|---|---|
| Enable Analytics | Master switch for page-view tracking. |
| Enable BI Tracking | Adds filter-search, contact-open and lead tracking for funnel analyses. |
| Data Retention (days) | Records older than this are deleted automatically. Range 7–365. |
| Filter Data Minimization | Strips free-text search fields (e.g. the s parameter) from filter tracking records. Recommended on. |
| Privacy Law / Jurisdiction | Auto-detect (uses API domain + currency as signals), or pick one explicitly. |
KPI cards (top of page)
| Card | Period semantics |
|---|---|
| Total Inventory | Live published vehicles right now. No historical snapshot, so no delta is shown. |
| New Imports (Last N Days) | Vehicles published during the selected period vs. the immediately preceding period of the same length. |
| Avg. Price | Average asking price of all live published vehicles right now. No historical snapshot, so no delta is shown. |
| Total Leads (Last N Days) | Lead-sent events during the selected period vs. the preceding period of the same length. |
| Conversion Rate (Last N Days) | Leads / views × 100 for the selected period vs. the preceding period of the same length. |
Dashboard rows
| Section | Requires BI tracking |
|---|---|
| Import Activity | No |
| Views Per Day | No |
| Conversion Funnel – Vehicle Detail Pages | Yes |
| Engagement by Page Type | No |
| Vehicles by Body Type | No |
| Top Filter Searches | Yes |
| Standing Time Analysis | Yes |
| Price Performance | Yes |
| Most Viewed Vehicles | Yes |
| Most Inquired Vehicles | Yes |
| Price Distribution / Insights | No |
| Market Intelligence & Pricing Distribution | Yes |
The Standing Time Analysis, Price Performance, Most Viewed Vehicles and Most Inquired Vehicles cards each include a per-table Show N rows dropdown (options 5, 10, 20, 30, 50, 100; default 5) that limits how many rows that table shows.
CMP Consent Integration
| Field | Notes |
|---|---|
| Require External Consent Signal | Off by default. When on, analytics is fully blocked until both the JS variable and the PHP filter return true. |
Integration points:
- PHP filter (server-side):
as24ci_analytics_consent_check - JavaScript variable (client-side):
window.as24ciConsentGranted
Danger Zone
| Field | Notes |
|---|---|
| Purge All Data | Deletes every analytics record (views, leads, filter searches, contact events) immediately. Cannot be undone. |
Operational notes
- Tracking is purely first-party. The plugin does not load third-party analytics scripts.
- The KPI period selector is filtered against the configured retention. For example, with a 30-day retention only 7 / 14 / 30 are offered.
- Some KPIs (Total Inventory, Avg. Price) reflect the current state and intentionally show no delta because the plugin does not store daily snapshots of those values.
- The CMP gate is independent of the Filter Data Minimization and Jurisdiction settings — it is an additional, opt-in lock that prevents any record from being written until external consent is granted.
- Disabling Enable Analytics stops new collection but does not delete existing records. Use the Clear All Analytics Data button to remove them.
- The Auto-detect jurisdiction uses the AutoScout24 API base URL and configured currency as signals; it is a heuristic. For legal compliance, choose an explicit jurisdiction.
Troubleshooting
- No data appears on the dashboards. Confirm Enable Analytics is on, that traffic has occurred since enabling, and — if you connected a CMP — that consent is being granted (
window.as24ciConsentGrantedand the PHP filter must both be true). - Conversion Rate is always 0%. Ensure leads are being captured (see Leads Reference) and that the selected period contains both views and lead events.
- BI-only sections are missing. Toggle Enable BI Tracking on. The funnel, top filter searches, standing time, price performance, most viewed/inquired and Market Intelligence cards require BI mode.
- The period dropdown is short. Increase Data Retention (days) to expose longer periods (90 or 180 days require sufficient retention).
- Old records linger after lowering retention. Retention is enforced by a background job; allow some time for cleanup or use Purge All Data for an immediate full wipe.
- Auto-detected jurisdiction looks wrong. Pick the correct value explicitly from the dropdown.