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 the as24ci_analytics_consent_check PHP filter (server side).

Step by step instructions

Enable analytics

  1. Open Car Market Hub → Analytics.
  2. Toggle Enable Analytics on to start collecting page views on vehicle detail, archive, compare and favorites pages.
  3. Optionally toggle Enable BI Tracking on to additionally record filter searches, contact form opens and leads.
  4. Set Data Retention (days) between 7 and 365.
  5. Save.

Use the dashboards

  1. 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.
  2. The five KPI cards compare the selected period against the immediately preceding period of the same length and show a trend indicator.
  3. 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).
  4. 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

  1. Keep Filter Data Minimization on (recommended) so free-text search values (such as the s query parameter) are stripped from filter records before storage.
  2. Choose a Privacy Law / Jurisdiction value, or leave Auto-detect to let the plugin infer it from your AutoScout24 API domain and configured currency.
  3. Save.
  1. Scroll to the CMP Consent Integration card at the bottom of the page.
  2. Toggle Require External Consent Signal on. This blocks all analytics tracking until consent is signaled.
  3. Configure your CMP / cookie banner to: - set window.as24ciConsentGranted = true once consent is granted (client-side), - return true for the as24ci_analytics_consent_check PHP filter (server-side).
  4. Save. Until both signals are present, no analytics data is collected.

Purge all analytics data

  1. Scroll to the Clear All Analytics Data card (Danger Zone).
  2. Click Purge All Data and confirm in the modal.
  3. All page views, leads, filter searches and contact events are deleted permanently and cannot be recovered.

Configuration reference

Settings card

FieldNotes
Enable AnalyticsMaster switch for page-view tracking.
Enable BI TrackingAdds 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 MinimizationStrips free-text search fields (e.g. the s parameter) from filter tracking records. Recommended on.
Privacy Law / JurisdictionAuto-detect (uses API domain + currency as signals), or pick one explicitly.

KPI cards (top of page)

CardPeriod semantics
Total InventoryLive 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. PriceAverage 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

SectionRequires BI tracking
Import ActivityNo
Views Per DayNo
Conversion Funnel – Vehicle Detail PagesYes
Engagement by Page TypeNo
Vehicles by Body TypeNo
Top Filter SearchesYes
Standing Time AnalysisYes
Price PerformanceYes
Most Viewed VehiclesYes
Most Inquired VehiclesYes
Price Distribution / InsightsNo
Market Intelligence & Pricing DistributionYes

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.

FieldNotes
Require External Consent SignalOff 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

FieldNotes
Purge All DataDeletes 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.as24ciConsentGranted and 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.