Suivi analytique

Ce document décrit comment le plugin ADP Car Market Hub enregistre les événements de visite et de business-intelligence (BI) pour les fiches de véhicules, où les données sont stockées, comment elles sont conservées et quels contrôles de confidentialité sont disponibles.

Quand utiliser ce document

Lisez ce document si vous devez :

• Comprendre quelles interactions front-end sont suivies et lesquelles ne le sont pas.
• Configurer la conservation des données ou désactiver le suivi pour des raisons de confidentialité.
• Connecter le système de consentement au bandeau de cookies ou de consentement du site.
• Auditer la manière dont la table analytique est créée, écrite et vidée.

Pour l'endpoint REST sous-jacent qui reçoit les événements du pixel front-end, voir Endpoints de l'API REST.

Aperçu

L'analyse est implémentée dans la classe AS24CI\Analytics. Elle maintient une table personnalisée unique et enregistre des événements typés qui alimentent l'onglet d'administration Analytics et le widget du tableau de bord.

Deux couches de suivi sont distinguées :

• Événements de page vue — view, view_archive, view_compare, view_favorites. Enregistrés dès que le suivi analytique est activé.
• Événements de BI — filter_search, contact_open, lead_sent. Enregistrés uniquement lorsque le suivi analytique et le commutateur BI sont tous deux activés.

Les événements front-end sont soumis par un petit pixel de suivi mis en file d'attente dans wp_footer qui envoie des requêtes POST à /wp-json/as24ci/v1/analytics/track. Les assistants côté PHP (Analytics::track_view(), track_filter_search(), track_contact_open(), track_lead_sent()) écrivent directement dans la table lorsqu'ils sont appelés depuis des flux côté serveur.

Configuration requise ou prérequis

• WordPress avec l'API REST disponible (par défaut).
• Autorisation de créer des tables personnalisées (dbDelta() est utilisé lors de l'activation et sur admin_init pour les mises à niveau).
• Une stratégie de confidentialité / consentement si votre site est soumis au RGPD ou à une législation comparable. Voir les Notes opérationnelles ci-dessous.

Schéma de la base de données

Le plugin stocke les événements dans <prefix>as24ci_analytics :

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

La version du schéma est stockée dans as24ci_analytics_db_version et dbDelta() est réappliqué lorsque la version sur le disque change.

Instructions étape par étape

1. Ouvrez l'onglet d'administration Analytics.
2. Activez le commutateur principal (as24ci_analytics_enabled). Tant que celui-ci n'est pas activé, aucun événement n'est enregistré.
3. Décidez s'il faut également activer le commutateur BI (as24ci_analytics_bi_enabled) pour les événements de filtre, d'ouverture de contact et d'envoi de lead.
4. (Recommandé) Définissez la fenêtre de conservation des données en jours.
5. (Optionnel) Activez le mode Consentement requis et connectez votre bandeau de consentement au filtre as24ci_analytics_consent_check — renvoyez false pour les visiteurs qui n'ont pas donné leur consentement.
6. (Optionnel) Ajustez la juridiction de confidentialité pour afficher les bonnes étiquettes dans l'interface d'administration.
7. Pour supprimer toutes les données collectées à la demande, utilisez le bouton Purger dans l'interface d'administration. L'action est protégée par la capacité manage_as24_imports et un nonce dédié.

Référence de configuration

Pour la liste complète des options du plugin, voir Stockage des options et des réglages.

Notes opérationnelles

• Le commutateur principal est désactivé par défaut (off), de sorte que le suivi analytique nécessite une démarche d'adhésion (opt-in).
• Lorsque le Consentement requis est activé, le plugin bloque l'événement à moins que le filtre as24ci_analytics_consent_check ne renvoie true. La valeur attachée par défaut est true, donc configurer ce mode sans lier une intégration de consentement autorise silencieusement le suivi.
• La charge utile filter_search est minimisée : les clés s, search et q sont supprimées par défaut, et la liste est filtrable via as24ci_analytics_filter_blocked_keys.
• Les événements de page vue (view, view_archive, etc.) contournent le commutateur BI mais respectent toujours le commutateur principal et la barrière de consentement.
• La conservation des données s'exécute quotidiennement via l'événement WP-Cron as24ci_daily_cleanup. Le nettoyage supprime les lignes où created_at est plus ancien que la fenêtre configurée.
• Les appels de purge vident immédiatement la table (truncate) et s'exécutent quel que soit l'état actuel du commutateur, de sorte que les données collectées peuvent toujours être supprimées à la demande.
• Les données enregistrées sont délibérément minimales : ID du véhicule, type d'événement, charge utile facultative minimisée, horodatage. Le plugin ne stocke pas les adresses IP, les agents utilisateurs, les ID de session ou les identifiants de visiteurs dans cette table.
• La table analytique est supprimée lors de la désinstallation (quel que soit l'état du commutateur supprimer le contenu lors de la désinstallation) car elle contient des données de suivi des visiteurs. Voir Comportement de désinstallation et de nettoyage.

Confidentialité et juridiction

Le plugin fournit une liste de juridictions reconnues (gdpr, dsgvo, revdsg, uk_gdpr, generic) et tente de détecter automatiquement une étiquette appropriée à partir des réglages du site. La logique de détection est informative ; les décisions juridiques concernant la base légale et le consentement restent de la responsabilité du propriétaire du site. Vérifiez la juridiction détectée dans la version actuelle du plugin avant de vous y fier pour votre documentation de conformité.

Dépannage

• Aucun événement enregistré — confirmez que as24ci_analytics_enabled est '1'. Le commutateur principal est désactivé par défaut.
• Les pages vues apparaissent mais pas les recherches par filtre — le commutateur BI (as24ci_analytics_bi_enabled) est désactivé.
• Tous les événements sont silencieusement rejetés après l'activation du consentement — le filtre as24ci_analytics_consent_check renvoie false, ou aucune intégration n'est connectée mais un plugin personnalisé filtre la valeur sur false. Inspectez cela avec un rappel temporaire add_filter qui renvoie true.
• Les anciennes données ne sont pas purgées — vérifiez que l'événement cron as24ci_daily_cleanup est enregistré et que WP-Cron (ou un cron externe) fonctionne. Voir Événements Cron et planificateur.
• Le bouton de purge ne fait rien — l'action AJAX nécessite la capacité manage_as24_imports et le nonce as24ci_purge_analytics. Vérifiez l'onglet réseau du navigateur pour un 403.

Documents connexes

• Endpoints de l'API REST
• Événements Cron et planificateur
• Stockage des options et des réglages
• Sécurité et capacités
• Comportement de désinstallation et de nettoyage
• Stockage et traitement des leads