Documentación · Documentación técnica

Seguimiento de Analytics

Este documento describe cómo el plugin ADP Car Market Hub registra eventos de visitas y de inteligencia de negocio (BI) para los listados de vehículos, dónde se almacenan los datos, cómo se retienen y qué controles de privacidad están disponibles.

Cuándo usar este documento

Lea este documento si necesita:

Comprender qué interacciones en el front-end se rastrean y cuáles no.
Configurar la retención de datos o desactivar el seguimiento por motivos de privacidad.
Conectar el sistema de consentimiento con el banner de cookies o consentimiento del sitio.
Auditar cómo se crea, escribe y limpia la tabla de analytics.

Para conocer el endpoint REST subyacente que recibe los eventos desde el píxel del front-end, consulte REST API Endpoints.

Descripción general

Analytics se implementa en la clase AS24CI\Analytics. Mantiene una única tabla personalizada y registra eventos tipificados que alimentan la pestaña de administración Analytics y el widget del dashboard.

Se distinguen dos capas de seguimiento:

Eventos de visualización de página — view, view_archive, view_compare, view_favorites. Se registran siempre que analytics esté habilitado.
Eventos de BI — filter_search, contact_open, lead_sent. Se registran solo cuando tanto analytics como el interruptor de BI están habilitados.

Los eventos del front-end se envían mediante un pequeño píxel de seguimiento encolado en wp_footer que realiza un POST a /wp-json/as24ci/v1/analytics/track. Los ayudantes del lado de PHP (Analytics::track_view(), track_filter_search(), track_contact_open(), track_lead_sent()) escriben directamente en la tabla cuando se les llama desde flujos del lado del servidor.

Requisitos o prerrequisitos

WordPress con la REST API disponible (por defecto).
Permiso para crear tablas personalizadas (se usa dbDelta() durante la activación y en admin_init para actualizaciones).
Una estrategia de privacidad / consentimiento si su sitio está sujeto al RGPD o legislación comparable. Consulte las Notas operativas más abajo.

Esquema de la base de datos

El plugin almacena los eventos en <prefix>as24ci_analytics:

Columna	Tipo	Notas
`id`	`BIGINT UNSIGNED AUTO_INCREMENT`	Clave primaria.
`post_id`	`BIGINT UNSIGNED NOT NULL`	ID de la publicación del vehículo, o `0` para eventos globales.
`event_type`	`VARCHAR(20)`	Uno de los nombres de evento permitidos.
`extra_data`	`LONGTEXT NULL`	Payload opcional. Codificado en JSON para `filter_search`.
`created_at`	`DATETIME`	Marca de tiempo UTC.

Índices: (post_id, event_type, created_at), (event_type, created_at), (created_at).

La versión del esquema se almacena en as24ci_analytics_db_version y dbDelta() se vuelve a aplicar cuando cambia la versión en disco.

Instrucciones paso a paso

Abra la pestaña de administración Analytics.
Active el interruptor principal (as24ci_analytics_enabled). Hasta que esté activado, no se registrará ningún evento.
Decida si desea activar también el interruptor de BI (as24ci_analytics_bi_enabled) para los eventos de filtro, apertura de contacto y envío de lead.
(Recomendado) Establezca la ventana de retención de datos en días.
(Opcional) Active el modo Requerir consentimiento y conecte su banner de consentimiento al filtro as24ci_analytics_consent_check; devuelva false para los visitantes que no hayan otorgado el consentimiento.
(Opcional) Ajuste la jurisdicción de privacidad para mostrar las etiquetas correctas en la interfaz de administración.
Para eliminar todos los datos recopilados bajo demanda, utilice el botón Purgar en la interfaz de administración. La acción está protegida por la capacidad manage_as24_imports y un nonce dedicado.

Referencia de configuración

Clave de opción	Propósito	Por defecto
`as24ci_analytics_enabled`	Interruptor principal de seguimiento.	`'0'` (desactivado)
`as24ci_analytics_bi_enabled`	Habilita eventos de filtro / contacto / lead.	`'1'` (activado, cuando analytics está activo)
`as24ci_analytics_retention_days`	Días de historial conservados por la limpieza diaria. Redondeado hacia abajo a un mínimo de `7`.	`180`
`as24ci_analytics_require_consent`	Cuando es `'1'`, los eventos requieren consentimiento explícito a través del filtro.	`'0'`
`as24ci_analytics_filter_minimization`	Cuando es `'1'`, los términos de búsqueda de texto libre se eliminan de los payloads de `filter_search` antes de guardarse.	`'1'`
`as24ci_analytics_privacy_jurisdiction`	Sobrescritura manual de jurisdicción; `'auto'` permite que el plugin la detecte.	`'auto'`

Para ver la lista completa de opciones del plugin, consulte Options And Settings Storage.

Notas operativas

El interruptor principal está desactivado por defecto, por lo que el seguimiento requiere una acción de activación (opt-in).
Cuando Requerir consentimiento está activado, el plugin bloquea el evento a menos que el filtro as24ci_analytics_consent_check devuelva true. El valor adjunto por defecto es true, por lo que configurar este modo sin conectar una integración de consentimiento permite el seguimiento de forma silenciosa.
El payload de filter_search se reduce al mínimo: las claves s, search y q se eliminan por defecto, y la lista se puede filtrar a través de as24ci_analytics_filter_blocked_keys.
Los eventos de visualización de página (view, view_archive, etc.) omiten el interruptor de BI pero siguen respetando el interruptor principal y la barrera de consentimiento.
La retención de datos se ejecuta diariamente a través del evento de WP-Cron as24ci_daily_cleanup. La limpieza elimina las filas donde created_at es más antiguo que la ventana configurada.
Las llamadas de purga vacían (truncate) la tabla inmediatamente y se ejecutan independientemente del estado actual del interruptor, por lo que los datos recopilados siempre se pueden eliminar bajo demanda.
Los datos registrados son deliberadamente mínimos: ID del vehículo, tipo de evento, payload opcional minimizado y marca de tiempo. El plugin no almacena direcciones IP, user agents, IDs de sesión ni identificadores de visitantes en esta tabla.
La tabla de analytics se elimina al desinstalar (independientemente del interruptor eliminar contenido al desinstalar) porque contiene datos de seguimiento de visitantes. Consulte Uninstall And Cleanup Behavior.

Privacidad y jurisdicción

El plugin proporciona una lista de jurisdicciones reconocidas (gdpr, dsgvo, revdsg, uk_gdpr, generic) e intenta detectar automáticamente una etiqueta adecuada a partir de los ajustes del sitio. La lógica de detección es informativa; las decisiones legales sobre la base legítima y el consentimiento siguen siendo responsabilidad del propietario del sitio. Verifique la jurisdicción detectada en la versión actual del plugin antes de confiar en ella para la documentación de cumplimiento normativo.

Resolución de problemas

No se registran eventos — confirme que as24ci_analytics_enabled está configurado como '1'. El interruptor principal está desactivado por defecto.
Aparecen las visualizaciones de página pero no las búsquedas por filtro — el interruptor de BI (as24ci_analytics_bi_enabled) está desactivado.
Todos los eventos se descartan silenciosamente tras activar el consentimiento — el filtro as24ci_analytics_consent_check devuelve false, o no hay ninguna integración conectada pero un plugin personalizado está filtrando el valor a false. Inspeccione esto con una llamada de retorno temporal de add_filter que devuelva true.
Los datos antiguos no se están purgando — verifique que el evento de cron as24ci_daily_cleanup esté registrado y que WP-Cron (o un cron externo) se esté ejecutando. Consulte Cron Events And Scheduler.
El botón de purga no hace nada — la acción AJAX requiere la capacidad manage_as24_imports y el nonce as24ci_purge_analytics. Revise la pestaña de red del navegador para ver si hay un 403.