Dokumentation · Technische Dokumentation

Analytics-Tracking

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

Wann Sie dieses Dokument verwenden sollten

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

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

Für den zugrunde liegenden REST-Endpunkt, der Events vom Frontend-Pixel empfängt, siehe REST API Endpoints.

Übersicht

Analytics ist in der Klasse AS24CI\Analytics implementiert. Sie verwaltet eine einzelne benutzerdefinierte Tabelle und zeichnet typisierte Events auf, welche den Admin-Tab Analytics und das Dashboard-Widget speisen.

Es wird zwischen zwei Tracking-Ebenen unterschieden:

Seitenaufruf-Events — view, view_archive, view_compare, view_favorites. Werden immer aufgezeichnet, wenn Analytics aktiviert ist.
BI-Events — filter_search, contact_open, lead_sent. Werden nur aufgezeichnet, wenn sowohl Analytics als auch der BI-Schalter aktiviert sind.

Frontend-Events werden durch ein kleines Tracking-Pixel übermittelt, das in wp_footer eingereiht wird und per POST an /wp-json/as24ci/v1/analytics/track sendet. PHP-seitige Hilfsfunktionen (Analytics::track_view(), track_filter_search(), track_contact_open(), track_lead_sent()) schreiben direkt in die Tabelle, wenn sie aus serverseitigen Abläufen aufgerufen werden.

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 unten.

Datenbankschema

Das Plugin speichert Events 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 Events.
`event_type`	`VARCHAR(20)`	Einer der zulässigen Event-Namen.
`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 eingeschaltet ist, werden keine Events aufgezeichnet.
Entscheiden Sie, ob Sie auch den BI-Schalter (as24ci_analytics_bi_enabled) für Filter-, Kontakt-Öffnungs- und Lead-gesendet-Events aktivieren möchten.
(Empfohlen) Legen Sie das Zeitfenster für die Datenaufbewahrung in Tagen fest.
(Optional) Aktivieren Sie den Modus Einwilligung erforderlich und verknüpfen 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 Beschriftungen in der Admin-Benutzeroberfläche anzuzeigen.
Um alle gesammelten Daten bei Bedarf zu entfernen, verwenden Sie die Schaltfläche Bereinigen in der Admin-Benutzeroberfläche. Die Aktion ist durch die Berechtigung manage_as24_imports und ein dediziertes 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-Events.	`'1'` (ein, wenn Analytics aktiv 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 Events eine explizite 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'`

Für die vollständige Liste der Plugin-Optionen siehe Options And Settings Storage.

Betriebliche Hinweise

Der Hauptschalter ist standardmässig auf aus gestellt, sodass Analytics ein Opt-in erfordert.
Wenn Einwilligung erforderlich aktiviert ist, blockiert das Plugin das Event, es sei denn, der Filter as24ci_analytics_consent_check gibt true zurück. Der standardmässig verknüpfte 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ässig entfernt, und die Liste kann über as24ci_analytics_filter_blocked_keys gefiltert werden.
Seitenaufruf-Events (view, view_archive etc.) umgehen den BI-Schalter, respektieren aber weiterhin den Hauptschalter und die Einwilligungsschranke.
Die Datenaufbewahrung wird täglich über das WP-Cron-Event as24ci_daily_cleanup ausgeführt. 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 des Schalters ausgeführt, sodass gesammelte Daten jederzeit auf Abruf entfernt werden können.
Die aufgezeichneten Daten sind bewusst minimal gehalten: Fahrzeug-ID, Event-Typ, 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 Uninstall And Cleanup Behavior.

Datenschutz und Jurisdiktion

Das Plugin stellt eine Liste anerkannter Jurisdiktionen bereit (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 Events aufgezeichnet — Vergewissern Sie sich, dass as24ci_analytics_enabled auf '1' steht. Der Hauptschalter ist standardmässig deaktiviert.
Seitenaufrufe erscheinen, aber Filtersuchen nicht — Der BI-Schalter (as24ci_analytics_bi_enabled) ist deaktiviert.
Alle Events 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-Event as24ci_daily_cleanup registriert ist und dass WP-Cron (oder ein externer Cron) ausgeführt wird. Siehe Cron Events And 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.