Dokumentation · Technische Dokumentation

Analytics-Tracking

Dieses Dokument beschreibt, wie das ADP Car Market Hub-Plugin Besucher- und Business-Intelligence-Ereignisse (BI) für Fahrzeug-Listings erfasst, wo die Daten gespeichert werden, wie lange sie aufbewahrt werden und welche Datenschutz-Kontrollfunktionen zur Verfügung stehen.

Wann Sie dieses Dokument lesen sollten

Lesen Sie dieses Dokument, wenn Sie Folgendes tun müssen:

Verstehen, welche Front-End-Interaktionen erfasst werden und welche nicht.
Die Datenaufbewahrung konfigurieren oder das Tracking aus Datenschutzgründen deaktivieren.
Das Consent-System an das Cookie- oder Consent-Banner der Website anbinden.
Überprüfen, wie die Analytics-Tabelle erstellt, beschrieben und geleert wird.

Informationen zum zugrunde liegenden REST-Endpunkt, der Ereignisse vom Front-End-Pixel empfängt, finden Sie unter REST-API-Endpunkte.

Übersicht

Die Analytics-Funktion ist in der Klasse AS24CI\Analytics implementiert. Sie verwaltet eine eigene benutzerdefinierte Tabelle und erfasst typisierte Ereignisse, die den Admin-Tab Analytics und das Dashboard-Widget speisen.

Es wird zwischen zwei Tracking-Ebenen unterschieden:

Seitenaufruf-Ereignisse (Page-View) — view, view_archive, view_compare, view_favorites. Werden immer erfasst, wenn Analytics aktiviert ist.
BI-Ereignisse — filter_search, contact_open, lead_sent. Werden nur erfasst, wenn sowohl Analytics als auch der BI-Schalter aktiviert sind.

Front-End-Ereignisse werden durch ein kleines Tracking-Pixel übermittelt, das in wp_footer eingereiht ist und einen POST-Request an /wp-json/as24ci/v1/analytics/track sendet. PHP-seitige Hilfsfunktionen (Analytics::track_view(), track_filter_search(), track_contact_open(), track_lead_sent()) schreiben bei Aufrufen aus serverseitigen Abläufen direkt in die Tabelle.

Anforderungen oder Voraussetzungen

WordPress mit verfügbarer REST-API (Standard).
Berechtigung zum Erstellen benutzerdefinierter Tabellen (dbDelta() wird bei der Aktivierung und bei admin_init für Upgrades verwendet).
Eine Datenschutz- / Consent-Strategie, falls Ihre Website der DSGVO oder vergleichbaren Gesetzen unterliegt. Siehe Betriebliche Hinweise weiter unten.

Datenbankschema

Das Plugin speichert Ereignisse in <prefix>as24ci_analytics:

Spalte	Typ	Hinweise
`id`	`BIGINT UNSIGNED AUTO_INCREMENT`	Primärschlüssel.
`post_id`	`BIGINT UNSIGNED NOT NULL`	Fahrzeug-Post-ID, oder `0` für globale Ereignisse.
`event_type`	`VARCHAR(20)`	Einer der zulässigen Ereignisnamen.
`extra_data`	`LONGTEXT NULL`	Optionaler Payload. JSON-kodiert für `filter_search`.
`created_at`	`DATETIME`	UTC-Zeitstempel.

Indizes: (post_id, event_type, created_at), (event_type, created_at), (created_at).

Die Schema-Version wird in as24ci_analytics_db_version gespeichert und dbDelta() wird erneut angewendet, wenn sich die Version auf dem Datenträger ändert.

Schritt-für-Schritt-Anleitung

Öffnen Sie den Admin-Tab Analytics.
Aktivieren Sie den Hauptschalter (as24ci_analytics_enabled). Solange dieser nicht aktiv ist, werden keine Ereignisse erfasst.
Entscheiden Sie, ob Sie auch den BI-Schalter (as24ci_analytics_bi_enabled) für Filter-, Kontakt-Öffnungs- und Lead-Gesendet-Ereignisse aktivieren möchten.
(Empfohlen) Legen Sie den Zeitraum für die Datenaufbewahrung in Tagen fest.
(Optional) Aktivieren Sie den Modus Einwilligung erforderlich und verbinden Sie Ihr Consent-Banner mit dem Filter as24ci_analytics_consent_check — geben Sie false für Besucher zurück, die keine Einwilligung erteilt haben.
(Optional) Passen Sie die Datenschutz-Jurisdiktion an, um die korrekten Labels in der Admin-Benutzeroberfläche anzuzeigen.
Um alle gesammelten Daten bei Bedarf zu löschen, verwenden Sie die Schaltfläche Bereinigen in der Admin-Benutzeroberfläche. Diese Aktion ist durch die Berechtigung manage_as24_imports und ein spezielles Nonce geschützt.

Konfigurationsreferenz

Optionsschlüssel	Zweck	Standard
`as24ci_analytics_enabled`	Hauptschalter für das Tracking.	`'0'` (aus)
`as24ci_analytics_bi_enabled`	Aktiviert Filter- / Kontakt- / Lead-Ereignisse.	`'1'` (an, wenn Analytics an ist)
`as24ci_analytics_retention_days`	Tage des Verlaufs, die bei der täglichen Bereinigung aufbewahrt werden. Abgerundet auf ein Minimum von `7`.	`180`
`as24ci_analytics_require_consent`	Wenn `'1'`, erfordern Ereignisse eine ausdrückliche Einwilligung über den Filter.	`'0'`
`as24ci_analytics_filter_minimization`	Wenn `'1'`, werden Freitext-Suchbegriffe vor der Speicherung aus den `filter_search`-Payloads entfernt.	`'1'`
`as24ci_analytics_privacy_jurisdiction`	Manuelle Überschreibung der Jurisdiktion; `'auto'` lässt das Plugin diese automatisch erkennen.	`'auto'`

Die vollständige Liste der Plugin-Optionen finden Sie unter Speicherung von Optionen und Einstellungen.

Betriebliche Hinweise

Der Hauptschalter ist standardmäßig auf aus gestellt, sodass Analytics ein Opt-in erfordert.
Wenn Einwilligung erforderlich aktiviert ist, blockiert das Plugin das Ereignis, es sei denn, der Filter as24ci_analytics_consent_check gibt true zurück. Der standardmäßig übergebene Wert ist true. Wenn Sie diesen Modus konfigurieren, ohne eine Consent-Integration anzubinden, wird das Tracking stillschweigend zugelassen.
Der Payload filter_search wird minimiert: Die Schlüssel s, search und q werden standardmäßig entfernt, und die Liste kann über as24ci_analytics_filter_blocked_keys gefiltert werden.
Seitenaufruf-Ereignisse (view, view_archive usw.) umgehen den BI-Schalter, beachten aber weiterhin den Hauptschalter und die Einwilligungsschranke.
Die Datenbereinigung läuft täglich über das WP-Cron-Ereignis as24ci_daily_cleanup. Die Bereinigung löscht Zeilen, bei denen created_at älter als das konfigurierte Zeitfenster ist.
Bereinigungsaufrufe leeren die Tabelle sofort und werden unabhängig vom aktuellen Zustand der Schalter ausgeführt, sodass gesammelte Daten jederzeit auf Abruf entfernt werden können.
Die erfassten Daten sind bewusst minimal gehalten: Fahrzeug-ID, Ereignistyp, optionaler minimierter Payload, Zeitstempel. Das Plugin speichert in dieser Tabelle keine IP-Adressen, User-Agents, Session-IDs oder Besucher-Identifikatoren.
Die Analytics-Tabelle wird bei der Deinstallation gelöscht (unabhängig vom Schalter Inhalte bei Deinstallation löschen), da sie Besucher-Tracking-Daten enthält. Siehe Verhalten bei Deinstallation und Bereinigung.

Datenschutz und Jurisdiktion

Das Plugin bietet eine Liste anerkannter Jurisdiktionen (gdpr, dsgvo, revdsg, uk_gdpr, generic) und versucht, anhand der Website-Einstellungen automatisch ein passendes Label zu erkennen. Die Erkennungslogik dient nur zur Information; die rechtlichen Entscheidungen über die Rechtsgrundlage und die Einwilligung verbleiben beim Website-Betreiber. Überprüfen Sie die erkannte Jurisdiktion in der aktuellen Plugin-Version, bevor Sie sich für Compliance-Dokumentationen darauf verlassen.

Fehlerbehebung

Keine Ereignisse erfasst — Stellen Sie sicher, dass as24ci_analytics_enabled auf '1' steht. Der Hauptschalter ist standardmäßig deaktiviert.
Seitenaufrufe erscheinen, aber Filtersuchen nicht — Der BI-Schalter (as24ci_analytics_bi_enabled) ist deaktiviert.
Alle Ereignisse werden nach Aktivierung der Einwilligung stillschweigend verworfen — Der Filter as24ci_analytics_consent_check gibt false zurück, oder es ist keine Integration angebunden, aber ein benutzerdefiniertes Plugin filtert den Wert auf false. Überprüfen Sie dies mit einem temporären add_filter-Callback, der true zurückgibt.
Alte Daten werden nicht gelöscht — Stellen Sie sicher, dass das Cron-Ereignis as24ci_daily_cleanup registriert ist und dass WP-Cron (oder ein externer Cron) ausgeführt wird. Siehe Cron-Ereignisse und Scheduler.
Bereinigen-Schaltfläche bewirkt nichts — Die AJAX-Aktion erfordert die Berechtigung manage_as24_imports und das Nonce as24ci_purge_analytics. Überprüfen Sie den Netzwerk-Tab des Browsers auf einen 403-Fehler.