Google Analytics GA4: configuración y ayuda

Sigue los pasos de Inicio rápido.

Abre "Configure" en "Module Manager". Usa Configuración para ID y controles de seguimiento, y Diagnóstico para comprobaciones. Hay páginas separadas de Licencia, Soporte, Actualizar e "Integrity".

"Enhanced Conversions" calcula el hash de correo, teléfono, nombre, apellidos, ciudad, región y código postal tras quitar espacios de los extremos y convertir a minúsculas. El ISO del país se envía sin hash. Los campos de dirección proceden de la primera dirección del cliente, si está disponible. Esta opción es independiente del seguimiento del ID de cliente con hash.

Interacción con productos

El rastreador compartido también reconoce cambios de variante e interacciones con detalles del producto. Por defecto limita la intención alta a una vez por producto/sesión. Mantén esto separado de tu configuración principal de conversiones de compra.

Cuando Cookies Revolution está activo, el módulo lo detecta y puede colocarse al final de displayHeader para que la CMP inicialice Consent Mode primero. Usa Reparar el orden de hooks en Diagnóstico si hace falta.

Sin esa CMP detectada, el módulo emite valores predeterminados de Consent Mode que deniegan almacenamiento analítico, publicitario, de datos de usuario de publicidad y de personalización, pero permiten el de seguridad. Es un fragmento predeterminado. No crea un banner ni obtiene consentimiento. Configura las actualizaciones mediante tu herramienta de consentimiento.

El control de aptitud del navegador omite controladores ajenos al frontend, bots/herramientas de auditoría reconocidos, empleados excluidos y navegadores con mpr_notrack=1. Para excluir un navegador de prueba:

document.cookie = 'mpr_notrack=1; path=/; max-age=31536000; SameSite=Lax';

Las compras de servidor requieren el consentimiento analítico guardado del comprador, sus ID de cliente y sesión GA originales y el permiso para que este módulo envíe datos a la propiedad GA4 configurada. También se aplican las exclusiones voluntarias del navegador y las exclusiones de empleados. "Server-Side Purchase Fallback" está desactivado por defecto. Para activarlo, introduce credenciales válidas y establece "Purchase recovery hostname" con el nombre de host HTTPS de tu tienda de producción, sin protocolo ni ruta.

El módulo carga GA4 de forma asíncrona mediante displayHeader. Envía eventos e-commerce por estas rutas:

Este formulario no tiene interruptores separados para estos eventos e-commerce estándar. Su presencia depende de los hooks correspondientes y del flujo del tema.

Los datos de compra incluyen referencia del pedido como transaction_id, valor, moneda, impuestos, envío, cupones y líneas de artículos. Los campos disponibles incluyen ID, nombre, precio, cantidad, marca, categoría, variante y descuento. Revisa estos valores con un pedido de prueba usando tu configuración de impuestos, descuentos y envío.

"Track custom events" tiene No por defecto. El campo "Custom event rules" empieza vacío. Añade reglas, activa el interruptor y guarda:

[
  {"event":"gallery_browse","trigger":"click","selector":".product-images img,.images-container img","params":{"component":"product_gallery"},"once":false},
  {"event":"checkout_page_seen","trigger":"url","contains":["/order"],"params":{"area":"checkout"},"once":true},
  {"event":"module_page_seen","trigger":"controller","controllers":["module"],"modules":["mprwishlist"]},
  {"event":"size_guide_opened","trigger":"event","dom_event":"shop:size-guide-opened","params":{"component":"size_guide"},"once":false}
]

document.dispatchEvent(new CustomEvent('shop:size-guide-opened'));

Usa nombres de eventos y parámetros que empiecen por una letra, contengan letras, dígitos o guiones bajos y tengan como máximo 40 caracteres. Los nombres y prefijos reservados se rechazan. Se filtran claves de parámetros parecidas a datos personales. Los selectores de clic pueden tener hasta 500 caracteres. once es false por defecto para clics y true para reglas URL, de controlador y DOM. Adapta los filtros de controlador/módulo a tu ruta real.

La validación del pedido registra las compras aptas para su recuperación. Tras 30 minutos sin confirmación del navegador, la tarea cron compartida pone en cola y envía los eventos Measurement Protocol purchase aptos con los datos del comprador guardados durante la compra:

task: send_ga4_measurement_protocol
callable: mprgoogleanalytics::cronProcessMeasurementProtocolQueue
schedule: every:300
context: any
timeout: 30

Asegúrate de que tu ejecutor cron MPR compartido ejecute esta tarea. Comprueba el registro de eventos en Diagnóstico y la cola de conversiones compartida. Las filas de registro usan el prefijo de tu base de datos seguido de mpr_analytics_events; ps_ es solo el prefijo habitual de ejemplo. La limpieza de retención se ejecuta tras una validación de pedido apta. La recuperación de compras caduca 72 horas después del pedido. La conservación de los registros de recuperación sigue "Log Retention (days)".

Las compras de navegador y servidor usan la referencia del pedido como transaction_id. Un registro compartido asigna cada compra a un único canal de envío. La recuperación de servidor solo gestiona pedidos que siguen sin confirmación del navegador tras 30 minutos.

Los ID de cliente y sesión del servidor proceden de las cookies GA originales guardadas antes del pedido. Si faltan o no son válidos, se retiene la recuperación; el módulo no genera identidades de sustitución. La cola no convierte los eventos solo de navegador en eventos de servidor.

Abre Diagnóstico y usa Ejecutar comprobaciones. Revisa configuración requerida, validez de reglas, orden de hooks, visibilidad del grupo del módulo, detección de CMP, scripts duplicados, exclusiones y estado de Measurement Protocol. Usa Reparar el orden de hooks o Reparar el grupo de módulos cuando proceda.

Usa un navegador de cliente normal para comprobar solicitudes de red y GA4 DebugView. Los agentes de bots/auditoría pueden estar excluidos deliberadamente. Prueba vista de producto, cambios del carrito, proceso de compra, inicio de sesión, registro, búsqueda y pedido completo. Verifica la referencia de transacción y los totales de artículos.

Si no carga ninguna etiqueta, comprueba "Enable Tracking", "Measurement ID", exclusiones de empleados/opt-out, ejecución de hooks y titularidad duplicada. Si el tema omite displayProductActions o displayBeforeCarrier, puede faltar el evento relacionado.

Si falta la compra de servidor, comprueba interruptor de respaldo, ID, secreto, asignación de la función de seguimiento al módulo, proceso de cola y registro HTTP/errores reciente. Un secreto vacío deja disponible el seguimiento de navegador. Los totales GA4 pueden diferir de PrestaShop por scripts bloqueados, consentimiento, atribución, retrasos de informes y reembolsos. El seguimiento de compras del módulo no es un sistema de conciliación contable.

Establece "Enable Tracking" en No y guarda para pausar esta integración. Desinstala mediante "Module Manager" para eliminar menú, registro cron y configuración. La tabla de cola compartida se conserva si otro módulo usa el paquete de conversiones; de lo contrario, su helper de desinstalación la elimina. Gestiona la propiedad GA4 y sus datos históricos en Google Analytics. El registro usa almacenamiento compartido; no elimines una tabla compartida manualmente.

Usa los nombres de los ajustes anteriores cuando una captura difiera de tu versión instalada.