Dokumentation · Admin-Referenz
Analytics-Referenz
Dieses Dokument ist eine Referenz für den Bereich Analytics des ADP Car Market Hub-Plugins (Car Market Hub → Analytics). Es beschreibt, wie das Analytics-Tracking funktioniert, welche Dashboards verfügbar sind, die Datenschutz-Optionen, die optionale CMP-Einwilligungsschranke und die Bereinigungsaktion im Gefahrenbereich.
Wann dieses Dokument zu verwenden ist
Verwenden Sie diese Referenz, wenn Sie das plugininterne Analytics aktivieren oder anpassen möchten, den Unterschied zwischen einfachem Seitenaufruf-Tracking und Business Intelligence (BI)-Tracking verstehen wollen, Datenaufbewahrungs- und Datenschutzeinstellungen konfigurieren, eine externe Consent Management Platform integrieren oder alle gespeicherten Analytics-Daten löschen möchten.
Übersicht
Der Analytics-Bildschirm zeigt oben immer eine KPI-Leiste mit fünf Karten (Gesamtbestand, Neue Importe, Durchschnittspreis, Leads gesamt, Conversion-Rate), eine Zeitraumauswahl (7 / 14 / 30 / 90 / 180 Tage, eingeschränkt durch die konfigurierte Aufbewahrungsdauer) und eine Einstellungskarte. Wenn das Tracking aktiviert ist, werden darunter zusätzliche Dashboard-Zeilen gerendert.
Es stehen zwei Tracking-Modi zur Verfügung:
- Seitenaufruf-Tracking — erfasst Aufrufe auf Fahrzeugdetail-, Archiv-, Vergleichs- und Favoritenseiten.
- BI-Tracking — erfasst zusätzlich Filtersuchen, das Öffnen von Kontaktformularen und Lead-Ereignisse, was Conversion-Funnel- und Top-Suchanalysen ermöglicht.
Datenschutz wird als zentrales Anliegen behandelt: Neben den Tracking-Schaltern stehen eine Länderauswahl, ein Schalter zur Minimierung von Freitexten und eine optionale externe Einwilligungsschranke zur Verfügung.
Voraussetzungen oder Bedingungen
- Berechtigung zur Verwaltung des Plugins.
- Ein über das Car Market Hub importierter Fahrzeugbestand.
- Für aussagekräftige Conversion- / BI-Metriken: Aktivieren Sie die Lead-Erfassung (siehe Leads-Referenz).
- Für die CMP-Schranke: Eine Consent Management Platform oder ein Cookie-Banner, das
window.as24ciConsentGranted = true(clientseitig) setzen und auf den PHP-Filteras24ci_analytics_consent_check(serverseitig) reagieren kann.
Schritt-für-Schritt-Anleitung
Analytics aktivieren
- Öffnen Sie Car Market Hub → Analytics.
- Aktivieren Sie Enable Analytics, um mit der Erfassung von Seitenaufrufen auf Fahrzeugdetail-, Archiv-, Vergleichs- und Favoritenseiten zu beginnen.
- Aktivieren Sie optional Enable BI Tracking, um zusätzlich Filtersuchen, das Öffnen von Kontaktformularen und Leads zu erfassen.
- Stellen Sie die Data Retention (days) auf einen Wert zwischen 7 und 365 ein.
- Speichern Sie die Einstellungen.
Dashboards nutzen
- Wählen Sie oben auf dem Bildschirm einen Wert für Select Period (7 / 14 / 30 / 90 / 180 Tage). Die Auswahl ist auf Zeiträume beschränkt, die in das aktive Aufbewahrungsfenster passen.
- Die fünf KPI-Karten vergleichen den ausgewählten Zeitraum mit dem unmittelbar vorhergehenden Zeitraum derselben Länge und zeigen einen Trendindikator.
- Scrollen Sie nach unten, um nacheinander folgende Bereiche zu sehen: Import-Aktivität, Aufrufe pro Tag, Conversion-Funnel (nur BI), Interaktion nach Seitentyp, Fahrzeuge nach Karosserieform, Top-Filtersuchen (nur BI), Standzeitanalyse (nur BI), Preis-Performance (nur BI), Meistgesehene Fahrzeuge (nur BI), Meistangefragte Fahrzeuge (nur BI), Preisverteilung, Einblicke in die Preisverteilung und Market Intelligence (nur BI).
- Die Tabellen für Standzeit, Preis-Performance, meistgesehene und meistangefragte Fahrzeuge verfügen jeweils über ein Dropdown-Menü Show N rows (5 / 10 / 20 / 30 / 50 / 100, Standard ist 5), um zu steuern, wie viele Zeilen die jeweilige Tabelle anzeigt.
Datenschutz-Optionen konfigurieren
- Lassen Sie Filter Data Minimization aktiviert (empfohlen), damit Freitext-Suchwerte (wie der Suchparameter
s) vor der Speicherung aus den Filterdatensätzen entfernt werden. - Wählen Sie einen Wert für Privacy Law / Jurisdiction oder belassen Sie es bei Auto-detect, damit das Plugin diesen anhand Ihrer AutoScout24-API-Domain und der konfigurierten Währung ableitet.
- Speichern Sie die Einstellungen.
Mit einer Consent Management Platform verbinden
- Scrollen Sie zur Karte CMP Consent Integration unten auf der Seite.
- Aktivieren Sie Require External Consent Signal. Dies blockiert jegliches Analytics-Tracking, bis die Einwilligung signalisiert wird.
- Konfigurieren Sie Ihr CMP / Cookie-Banner so, dass:
-
window.as24ciConsentGranted = truegesetzt wird, sobald die Einwilligung erteilt wurde (clientseitig), -truefür den PHP-Filteras24ci_analytics_consent_checkzurückgegeben wird (serverseitig). - Speichern Sie die Einstellungen. Solange nicht beide Signale vorhanden sind, werden keine Analytics-Daten erfasst.
Alle Analytics-Daten löschen
- Scrollen Sie zur Karte Clear All Analytics Data (Gefahrenbereich).
- Klicken Sie auf Purge All Data und bestätigen Sie im Modal-Fenster.
- Alle Seitenaufrufe, Leads, Filtersuchen und Kontaktereignisse werden dauerhaft gelöscht und können nicht wiederhergestellt werden.
Konfigurations-Referenz
Einstellungskarte
| Feld | Hinweise |
|---|---|
| Enable Analytics | Hauptschalter für das Seitenaufruf-Tracking. |
| Enable BI Tracking | Ergänzt das Tracking um Filtersuchen, Kontaktformular-Öffnungen und Leads für Funnel-Analysen. |
| Data Retention (days) | Datensätze, die älter als dieser Wert sind, werden automatisch gelöscht. Bereich: 7–365 Tage. |
| Filter Data Minimization | Entfernt Freitext-Suchfelder (z. B. den Parameter s) aus den Filter-Tracking-Datensätzen. Empfohlen. |
| Privacy Law / Jurisdiction | Auto-detect (nutzt API-Domain + Währung als Signale) oder wählen Sie explizit eine Gerichtsbarkeit aus. |
KPI-Karten (oben auf der Seite)
| Karte | Semantik des Zeitraums |
|---|---|
| Total Inventory | Aktuell live veröffentlichte Fahrzeuge. Kein historischer Schnappschuss, daher wird keine Differenz angezeigt. |
| New Imports (Last N Days) | Während des ausgewählten Zeitraums veröffentlichte Fahrzeuge im Vergleich zum unmittelbar vorhergehenden Zeitraum derselben Länge. |
| Avg. Price | Durchschnittlicher Angebotspreis aller aktuell live veröffentlichten Fahrzeuge. Kein historischer Schnappschuss, daher wird keine Differenz angezeigt. |
| Total Leads (Last N Days) | Gesendete Leads während des ausgewählten Zeitraums im Vergleich zum vorhergehenden Zeitraum derselben Länge. |
| Conversion Rate (Last N Days) | Leads / Aufrufe × 100 für den ausgewählten Zeitraum im Vergleich zum vorhergehenden Zeitraum derselben Länge. |
Dashboard-Zeilen
| Bereich | Erfordert BI-Tracking |
|---|---|
| Import Activity | Nein |
| Views Per Day | Nein |
| Conversion Funnel – Vehicle Detail Pages | Ja |
| Engagement by Page Type | Nein |
| Vehicles by Body Type | Nein |
| Top Filter Searches | Ja |
| Standing Time Analysis | Ja |
| Price Performance | Ja |
| Most Viewed Vehicles | Ja |
| Most Inquired Vehicles | Ja |
| Price Distribution / Insights | Nein |
| Market Intelligence & Pricing Distribution | Ja |
Die Karten für Standzeitanalyse, Preis-Performance, meistgesehene Fahrzeuge und meistangefragte Fahrzeuge enthalten jeweils ein tabellenspezifisches Dropdown-Menü Show N rows (Optionen: 5, 10, 20, 30, 50, 100; Standard ist 5), das die Anzahl der angezeigten Zeilen in dieser Tabelle begrenzt.
CMP Consent Integration
| Feld | Hinweise |
|---|---|
| Require External Consent Signal | Standardmäßig deaktiviert. Wenn aktiviert, wird Analytics vollständig blockiert, bis sowohl die JS-Variable als auch der PHP-Filter true zurückgeben. |
Integrationspunkte:
- PHP-Filter (serverseitig):
as24ci_analytics_consent_check - JavaScript-Variable (clientseitig):
window.as24ciConsentGranted
Gefahrenbereich
| Feld | Hinweise |
|---|---|
| Purge All Data | Löscht sofort jeden Analytics-Datensatz (Aufrufe, Leads, Filtersuchen, Kontaktereignisse). Kann nicht rückgängig gemacht werden. |
Betriebshinweise
- Das Tracking erfolgt ausschließlich als First-Party-Lösung. Das Plugin lädt keine Analytics-Skripte von Drittanbietern.
- Die KPI-Zeitraumauswahl wird anhand der konfigurierten Aufbewahrungsdauer gefiltert. Bei einer Aufbewahrungsdauer von 30 Tagen werden beispielsweise nur 7 / 14 / 30 Tage angeboten.
- Einige KPIs (Total Inventory, Avg. Price) spiegeln den aktuellen Zustand wider und zeigen bewusst keine Differenz an, da das Plugin keine täglichen Schnappschüsse dieser Werte speichert.
- Die CMP-Schranke ist unabhängig von den Einstellungen für Filter Data Minimization und Jurisdiction — sie ist eine zusätzliche, optionale Sperre, die das Schreiben von Datensätzen verhindert, bis eine externe Einwilligung vorliegt.
- Das Deaktivieren von Enable Analytics stoppt die neue Erfassung, löscht jedoch keine vorhandenen Datensätze. Verwenden Sie die Schaltfläche Clear All Analytics Data, um diese zu entfernen.
- Die automatische Erkennung (Auto-detect) der Gerichtsbarkeit nutzt die AutoScout24-API-Basis-URL und die konfigurierte Währung als Signale; es handelt sich um eine Heuristik. Für rechtliche Konformität wählen Sie bitte eine explizite Gerichtsbarkeit aus.
Fehlerbehebung
- Es erscheinen keine Daten auf den Dashboards. Vergewissern Sie sich, dass Enable Analytics aktiviert ist, seit der Aktivierung Zugriffe stattgefunden haben und — falls Sie ein CMP angebunden haben — die Einwilligung erteilt wird (
window.as24ciConsentGrantedund der PHP-Filter müssen beide true sein). - Die Conversion-Rate ist immer 0%. Stellen Sie sicher, dass Leads erfasst werden (siehe Leads-Referenz) und dass der ausgewählte Zeitraum sowohl Aufrufe als auch Lead-Ereignisse enthält.
- Nur für BI verfügbare Bereiche fehlen. Aktivieren Sie Enable BI Tracking. Der Funnel, die Top-Filtersuchen, die Standzeit, die Preis-Performance, die meistgesehenen/meistangefragten Fahrzeuge und die Market Intelligence-Karten erfordern den BI-Modus.
- Das Dropdown-Menü für den Zeitraum ist sehr kurz. Erhöhen Sie die Data Retention (days), um längere Zeiträume freizuschalten (90 oder 180 Tage erfordern eine ausreichend lange Aufbewahrung).
- Alte Datensätze bleiben nach dem Verringern der Aufbewahrungsdauer bestehen. Die Aufbewahrungsdauer wird durch einen Hintergrundjob erzwungen; geben Sie dem System etwas Zeit für die Bereinigung oder nutzen Sie Purge All Data für eine sofortige vollständige Löschung.
- Die automatisch erkannte Gerichtsbarkeit sieht falsch aus. Wählen Sie den korrekten Wert explizit aus dem Dropdown-Menü aus.