Documentatie · Technische documentatie

Analytics Tracking

Dit document beschrijft hoe de ADP Car Market Hub plugin bezoekers- en business-intelligence (BI) gebeurtenissen voor voertuigadvertenties registreert, waar de gegevens worden opgeslagen, hoe ze worden bewaard en welke privacy-instellingen beschikbaar zijn.

Wanneer u dit document moet gebruiken

Lees dit document als u het volgende wilt doen:

Begrijpen welke interacties aan de frontend worden gevolgd en welke niet.
Gegevensbewaring configureren of tracking uitschakelen om privacyredenen.
Het toestemmingssysteem koppelen aan de cookie- of toestemmingsbanner van de site.
Controleren hoe de analytics-tabel wordt aangemaakt, beschreven en opgeschoond.

Voor het onderliggende REST-eindpunt dat gebeurtenissen van de frontend-pixel ontvangt, raadpleegt u REST API Endpoints.

Overzicht

Analytics is geïmplementeerd in de klasse AS24CI\Analytics. Deze onderhoudt een enkele aangepaste tabel en registreert getypeerde gebeurtenissen die het tabblad Analytics in de beheeromgeving en de dashboard-widget voeden.

Er worden twee trackinglagen onderscheiden:

Paginaweergave-gebeurtenissen — view, view_archive, view_compare, view_favorites. Worden geregistreerd wanneer analytics is ingeschakeld.
BI-gebeurtenissen — filter_search, contact_open, lead_sent. Worden alleen geregistreerd wanneer zowel analytics als de BI-schakelaar zijn ingeschakeld.

Frontend-gebeurtenissen worden verzonden door een kleine trackingpixel die is ingesloten in wp_footer en een POST-verzoek stuurt naar /wp-json/as24ci/v1/analytics/track. PHP-helpers aan de serverzijde (Analytics::track_view(), track_filter_search(), track_contact_open(), track_lead_sent()) schrijven rechtstreeks naar de tabel wanneer ze worden aangeroepen vanuit server-side workflows.

Vereisten of randvoorwaarden

WordPress met de REST API beschikbaar (standaard).
Toestemming om aangepaste tabellen te maken (dbDelta() wordt gebruikt tijdens activering en op admin_init voor upgrades).
Een privacy- / toestemmingsstrategie als uw site onder de AVG (GDPR) of vergelijkbare wetgeving valt. Zie Operationele opmerkingen hieronder.

Databaseschema

De plugin slaat gebeurtenissen op in <prefix>as24ci_analytics:

Kolom	Type	Opmerkingen
`id`	`BIGINT UNSIGNED AUTO_INCREMENT`	Primaire sleutel.
`post_id`	`BIGINT UNSIGNED NOT NULL`	Voertuig post-ID, of `0` voor globale gebeurtenissen.
`event_type`	`VARCHAR(20)`	Een van de toegestane gebeurtenisnamen.
`extra_data`	`LONGTEXT NULL`	Optionele payload. JSON-gecodeerd voor `filter_search`.
`created_at`	`DATETIME`	UTC-tijdstempel.

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

De schemaversie wordt opgeslagen in as24ci_analytics_db_version en dbDelta() wordt opnieuw toegepast wanneer de versie op de schijf wijzigt.

Stapsgewijze instructies

Open het tabblad Analytics in de beheeromgeving.
Schakel de hoofdschakelaar in (as24ci_analytics_enabled). Zolang deze niet aan staat, worden er geen gebeurtenissen geregistreerd.
Bepaal of u ook de BI-schakelaar (as24ci_analytics_bi_enabled) wilt inschakelen voor filter-, contact-open- en lead-verzonden-gebeurtenissen.
(Aanbevolen) Stel de bewaarperiode voor gegevens in dagen in.
(Optioneel) Schakel de modus Toestemming vereisen in en koppel uw toestemmingsbanner aan het filter as24ci_analytics_consent_check — retourneer false voor bezoekers die geen toestemming hebben gegeven.
(Optioneel) Pas het privacy-rechtsgebied aan om de juiste labels in de beheeromgeving weer te geven.
Om alle verzamelde gegevens direct te verwijderen, gebruikt u de knop Opschonen in de beheeromgeving. Deze actie is beveiligd met de capability manage_as24_imports en een specifieke nonce.

Configuratiereferentie

Optiesleutel	Doel	Standaard
`as24ci_analytics_enabled`	Hoofdschakelaar voor tracking.	`'0'` (uit)
`as24ci_analytics_bi_enabled`	Schakelt filter- / contact- / lead-gebeurtenissen in.	`'1'` (aan, wanneer analytics aan staat)
`as24ci_analytics_retention_days`	Aantal dagen geschiedenis dat wordt bewaard door de dagelijkse opschoning. Afgerond naar een minimum van `7`.	`180`
`as24ci_analytics_require_consent`	Indien `'1'`, vereisen gebeurtenissen expliciete toestemming via het filter.	`'0'`
`as24ci_analytics_filter_minimization`	Indien `'1'`, worden vrije tekstzoekopdrachten verwijderd uit `filter_search` payloads vóór opslag.	`'1'`
`as24ci_analytics_privacy_jurisdiction`	Handmatige overschrijving van rechtsgebied; `'auto'` laat de plugin dit automatisch detecteren.	`'auto'`

Voor de volledige lijst met plugin-opties, zie Options And Settings Storage.

Operationele opmerkingen

De hoofdschakelaar staat standaard op uit, zodat analytics opt-in is.
Wanneer Toestemming vereisen is ingeschakeld, blokkeert de plugin de gebeurtenis, tenzij het filter as24ci_analytics_consent_check de waarde true retourneert. De standaard gekoppelde waarde is true, dus het configureren van deze modus zonder een toestemmingsintegratie in te richten staat tracking stilzwijgend toe.
De payload filter_search is geminimaliseerd: de sleutels s, search en q worden standaard verwijderd, en de lijst kan worden gefilterd via as24ci_analytics_filter_blocked_keys.
Paginaweergave-gebeurtenissen (view, view_archive, enz.) omzeilen de BI-schakelaar, maar respecteren nog steeds de hoofdschakelaar en de toestemmingscontrole.
Gegevensbewaring wordt dagelijks uitgevoerd via de as24ci_daily_cleanup WP-Cron-gebeurtenis. De opschoning verwijdert rijen waarvan created_at ouder is dan de geconfigureerde periode.
Opschoonacties (purge) legen de tabel onmiddellijk en worden uitgevoerd ongeacht de huidige status van de schakelaars, zodat verzamelde gegevens altijd op verzoek kunnen worden verwijderd.
Geregistreerde gegevens zijn bewust minimaal: voertuig-ID, type gebeurtenis, optionele geminimaliseerde payload en tijdstempel. De plugin slaat geen IP-adressen, user agents, sessie-ID's of bezoekersidentificaties op in deze tabel.
De analytics-tabel wordt verwijderd bij het deïnstalleren (ongeacht de schakelaar verwijder inhoud bij deïnstallatie) omdat deze gegevens voor het volgen van bezoekers bevat. Zie Uninstall And Cleanup Behavior.

Privacy en rechtsgebied

De plugin biedt een lijst met erkende rechtsgebieden (gdpr, dsgvo, revdsg, uk_gdpr, generic) en probeert automatisch een geschikt label te detecteren op basis van de site-instellingen. De detectielogica is louter informatief; de juridische beslissingen over de rechtmatige grondslag en toestemming blijven de verantwoordelijkheid van de site-eigenaar. Controleer het gedetecteerde rechtsgebied in de huidige plugin-versie voordat u hierop vertrouwt voor nalevingsdocumentatie.

Problemen oplossen

Geen gebeurtenissen geregistreerd — controleer of as24ci_analytics_enabled op '1' staat. De hoofdschakelaar staat standaard uit.
Paginaweergaven verschijnen wel, maar filterzoekopdrachten niet — de BI-schakelaar (as24ci_analytics_bi_enabled) staat uit.
Alle gebeurtenissen worden stilzwijgend genegeerd na het inschakelen van toestemming — het filter as24ci_analytics_consent_check retourneert false, of er is geen integratie gekoppeld maar een aangepaste plugin filtert de waarde naar false. Controleer dit met een tijdelijke add_filter callback die true retourneert.
Oude gegevens worden niet opgeschoond — controleer of de cron-gebeurtenis as24ci_daily_cleanup is geregistreerd en of WP-Cron (of een externe cron) actief is. Zie Cron Events And Scheduler.
Opschoonknop doet niets — de AJAX-actie vereist de capability manage_as24_imports en de nonce as24ci_purge_analytics. Controleer het netwerktabblad van de browser op een 403.