Documentazione · Documentazione tecnica

Tracciamento Analytics

Questo documento descrive come il plugin ADP Car Market Hub registra gli eventi dei visitatori e di business-intelligence (BI) per gli annunci di veicoli, dove vengono memorizzati i dati, come vengono conservati e quali controlli sulla privacy sono disponibili.

Quando utilizzare questo documento

Leggi questo documento se hai bisogno di:

Comprendere quali interazioni front-end vengono tracciate e quali no.
Configurare la conservazione dei dati o disabilitare il tracciamento per motivi di privacy.
Collegare il sistema di consenso al banner dei cookie o del consenso del sito.
Verificare come viene creata, scritta e svuotata la tabella di analytics.

Per l'endpoint REST sottostante che riceve gli eventi dal pixel front-end, consulta REST API Endpoints.

Panoramica

La funzionalità di Analytics è implementata nella classe AS24CI\Analytics. Gestisce una singola tabella personalizzata e registra eventi tipizzati che alimentano la scheda amministrativa Analytics e il widget della bacheca.

Si distinguono due livelli di tracciamento:

Eventi di visualizzazione pagina — view, view_archive, view_compare, view_favorites. Registrati ogni volta che analytics è abilitato.
Eventi BI — filter_search, contact_open, lead_sent. Registrati solo quando sia analytics che l'opzione BI sono abilitati.

Gli eventi front-end vengono inviati da un piccolo pixel di tracciamento accodato in wp_footer che effettua una richiesta POST a /wp-json/as24ci/v1/analytics/track. Gli helper lato PHP (Analytics::track_view(), track_filter_search(), track_contact_open(), track_lead_sent()) scrivono direttamente nella tabella quando vengono chiamati dai flussi lato server.

Requisiti o prerequisiti

WordPress con la REST API disponibile (impostazione predefinita).
Autorizzazione a creare tabelle personalizzate (dbDelta() viene utilizzato durante l'attivazione e su admin_init per gli aggiornamenti).
Una strategia per la privacy / il consenso se il tuo sito è soggetto al GDPR o a normative comparabili. Vedi le Note operative di seguito.

Schema del database

Il plugin memorizza gli eventi in <prefix>as24ci_analytics:

Colonna	Tipo	Note
`id`	`BIGINT UNSIGNED AUTO_INCREMENT`	Chiave primaria.
`post_id`	`BIGINT UNSIGNED NOT NULL`	ID dell'articolo del veicolo, o `0` per eventi globali.
`event_type`	`VARCHAR(20)`	Uno dei nomi di evento consentiti.
`extra_data`	`LONGTEXT NULL`	Payload opzionale. Codificato in JSON per `filter_search`.
`created_at`	`DATETIME`	Timestamp UTC.

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

La versione dello schema è memorizzata in as24ci_analytics_db_version e dbDelta() viene riapplicato quando la versione su disco cambia.

Istruzioni passo dopo passo

Apri la scheda amministrativa Analytics.
Abilita l'interruttore principale (as24ci_analytics_enabled). Fino a quando non è attivo, non viene registrato alcun evento.
Decidi se abilitare anche l'interruttore BI (as24ci_analytics_bi_enabled) per gli eventi di filtro, apertura contatti e invio lead.
(Consigliato) Imposta la finestra di conservazione dei dati in giorni.
(Opzionale) Abilita la modalità Richiedi consenso e collega il tuo banner di consenso al filtro as24ci_analytics_consent_check — restituisci false per i visitatori che non hanno concesso il consenso.
(Opzionale) Regola la giurisdizione sulla privacy per mostrare le etichette corrette nell'interfaccia utente di amministrazione.
Per rimuovere tutti i dati raccolti su richiesta, utilizza il pulsante Svuota nell'interfaccia utente di amministrazione. L'azione è protetta dalla funzionalità manage_as24_imports e da un nonce dedicato.

Riferimento di configurazione

Chiave opzione	Scopo	Predefinito
`as24ci_analytics_enabled`	Interruttore principale di tracciamento.	`'0'` (disattivato)
`as24ci_analytics_bi_enabled`	Abilita gli eventi di filtro / contatto / lead.	`'1'` (attivo, quando analytics è attivo)
`as24ci_analytics_retention_days`	Giorni di cronologia conservati dalla pulizia giornaliera. Ridotto a un minimo di `7`.	`180`
`as24ci_analytics_require_consent`	Quando `'1'`, gli eventi richiedono il consenso esplicito tramite il filtro.	`'0'`
`as24ci_analytics_filter_minimization`	Quando `'1'`, le chiavi di ricerca testuale libera vengono rimosse dai payload `filter_search` prima della memorizzazione.	`'1'`
`as24ci_analytics_privacy_jurisdiction`	Sostituzione manuale della giurisdizione; `'auto'` consente al plugin di rilevarla.	`'auto'`

Per l'elenco completo delle opzioni del plugin, consulta Opzioni e memorizzazione delle impostazioni.

Note operative

L'interruttore principale è impostato per impostazione predefinita su disattivato, pertanto l'analytics richiede l'attivazione esplicita (opt-in).
Quando Richiedi consenso è abilitato, il plugin blocca l'evento a meno che il filtro as24ci_analytics_consent_check non restituisca true. Il valore predefinito associato è true, quindi configurare questa modalità senza collegare un'integrazione di consenso consente implicitamente il tracciamento.
Il payload filter_search è ridotto al minimo: le chiavi s, search e q vengono rimosse per impostazione predefinita e l'elenco è filtrabile tramite as24ci_analytics_filter_blocked_keys.
Gli eventi di visualizzazione pagina (view, view_archive, ecc.) bypassano l'interruttore BI ma rispettano comunque l'interruttore principale e il controllo del consenso.
La conservazione dei dati viene eseguita quotidianamente tramite l'evento WP-Cron as24ci_daily_cleanup. La pulizia elimina le righe in cui created_at è più vecchio della finestra configurata.
Le chiamate di svuotamento troncano immediatamente la tabella e vengono eseguite indipendentemente dallo stato corrente dell'interruttore, in modo che i dati raccolti possano sempre essere rimossi su richiesta.
I dati registrati sono deliberatamente ridotti al minimo: ID veicolo, tipo di evento, payload opzionale ridotto al minimo, timestamp. Il plugin non memorizza indirizzi IP, user agent, ID sessione o identificatori dei visitatori in questa tabella.
La tabella analytics viene eliminata durante la disinstallazione (indipendentemente dall'interruttore elimina i contenuti alla disinstallazione) poiché contiene dati di tracciamento dei visitatori. Vedi Comportamento di disinstallazione e pulizia.

Privacy e giurisdizione

Il plugin fornisce un elenco di giurisdizioni riconosciute (gdpr, dsgvo, revdsg, uk_gdpr, generic) e tenta di rilevare automaticamente un'etichetta appropriata dalle impostazioni del sito. La logica di rilevamento è a scopo informativo; le decisioni legali sulla base giuridica e sul consenso rimangono di responsabilità del proprietario del sito. Verifica la giurisdizione rilevata nella versione corrente del plugin prima di fare affidamento su di essa per la documentazione di conformità.

Risoluzione dei problemi

Nessun evento registrato — conferma che as24ci_analytics_enabled sia '1'. L'interruttore principale è disattivato per impostazione predefinita.
Le visualizzazioni di pagina appaiono ma le ricerche con filtro no — l'interruttore BI (as24ci_analytics_bi_enabled) è disattivato.
Tutti gli eventi vengono eliminati silenziosamente dopo aver abilitato il consenso — il filtro as24ci_analytics_consent_check restituisce false, oppure non è collegata alcuna integrazione ma un plugin personalizzato sta filtrando il valore su false. Ispeziona con un callback temporaneo add_filter che restituisce true.
I vecchi dati non vengono eliminati — verifica che l'evento cron as24ci_daily_cleanup sia registrato e che WP-Cron (o un cron esterno) sia in esecuzione. Vedi Eventi cron e pianificatore.
Il pulsante Svuota non fa nulla — l'azione AJAX richiede la funzionalità manage_as24_imports e il nonce as24ci_purge_analytics. Controlla la scheda di rete del browser per un errore 403.