Cómo conectar Google Analytics 4 a Merez

Configurar Google Analytics 4 en Merez toma menos de media hora y sirve para dos cosas: que Merez envíe eventos a tu propiedad con el Measurement Protocol y que lea tus métricas para mostrarlas en Resumen → Analítica web. Aquí tienes los tres campos, dónde se consigue cada uno, cómo probarlos y qué revisar cuando algo no aparece.

Qué necesitas antes de empezar

Antes de tocar Merez, confirma que tienes esto. Si falta algo, la integración se guarda a medias o no arranca.

• Módulo Analítica activo en tu plan de Merez. Si no lo tienes, la fila de la integración muestra el estado “Requiere módulo (Analítica)” y no podrás guardar la configuración.
• Una propiedad de GA4 con un flujo web que ya reciba datos. El flujo es la fuente del ID de medición y del secreto. Si tu sitio no está midiendo, GA4 no tiene nada que entregar y Merez no puede inventarlo.
• Rol de Administrador en esa propiedad de GA4. Crear secretos y ver el ID de propiedad exige permisos de administración; con roles menores la opción no aparece. Los roles y sus alcances están descritos en la ayuda de Google Analytics.
• El correo de la cuenta de servicio de Merez. Es la identidad con la que Merez lee tus métricas. Te lo entrega el equipo de Merez junto con la integración; se agrega en GA4 como Visualizador.
• Sesión abierta en analytics.google.com con la cuenta que administra la propiedad, en el mismo navegador donde vas a configurar Merez.
• Permiso de edición en Merez: solo el dueño de la cuenta (el correo principal) puede abrir y guardar esta configuración. Los demás usuarios ven la fila y su estado, pero no editan credenciales.

Las credenciales, una por una

Son tres campos. Dos son obligatorios y el tercero solo hace falta si quieres ver métricas dentro de Merez. No los confundas: el ID de medición y el ID de propiedad son números distintos y viven en sitios distintos de GA4.

Campo en Merez	Qué es	Dónde se consigue exactamente
ID de medición	Identificador del flujo web, con formato G-XXXXXXXXXX. Es el measurement_id que viaja en la URL de cada envío al Measurement Protocol.	GA4 → Administrador → Recopilación y modificación de datos → Flujos de datos → tu flujo → Detalles del flujo → ID de medición.
API Secret	Secreto que autentica los envíos. Es una credencial privada: quien lo tenga puede escribir eventos en tu propiedad. Por eso se maneja solo del lado del servidor.	GA4 → Administrador → Flujos de datos → tu flujo → Secretos de API de Measurement Protocol → Crear → pon un sobrenombre (por ejemplo, merez-produccion) → Crear → copia el valor.
ID de propiedad (opcional)	El número interno de la propiedad. No es el G- del flujo. Merez lo usa únicamente para leer métricas y pintar Resumen → Analítica web.	GA4 → Administrador → Configuración de la propiedad → ID de propiedad.

Las tres credenciales no bastan para leer datos. La API de datos de GA4 respeta los permisos de la propiedad: si la cuenta de servicio de Merez no está dentro, la consulta falla aunque el envío funcione. Agrégala en GA4 → Administrador → Acceso a la propiedad → Añadir usuario, pega el correo de la cuenta de servicio y asígnale el rol Visualizador. Con ese rol alcanza para leer; no le des Administrador si no lo necesitas.

Un detalle que evita la mitad de los problemas: si rotas el secreto en GA4, el valor viejo sigue existiendo hasta que lo borres. Crea el nuevo, pégalo en Merez, guarda y solo entonces elimina el anterior.

Simulación de uso: de la plataforma a Merez

Caso: Distribuciones La 80, una distribuidora de abarrotes en Bogotá que vende a tiendas de barrio. Pauta en Google y recibe pedidos por WhatsApp, y quiere saber cuántos de esos leads vienen del sitio. Su propiedad de GA4 ya mide el sitio con la etiqueta de Google.

1. En GA4, abre Administrador → Flujos de datos y confirma que el flujo web del sitio está recibiendo tráfico en los últimos días. Si el flujo está vacío, ese es el problema y no la integración.
2. Entra al flujo y copia el ID de medición (G-...). Ese es el primer campo de Merez.
3. En el mismo flujo, abre Secretos de API de Measurement Protocol, crea uno llamado merez-produccion y copia el valor completo. El valor se muestra al crearlo; si cierras sin copiarlo, crea otro.
4. Vuelve a Administrador → Configuración de la propiedad y copia el ID de propiedad, que es un número. Si lo dejas por fuera, Merez enviará eventos pero el resumen web quedará vacío.
5. En Administrador → Acceso a la propiedad, agrega el correo de la cuenta de servicio de Merez con rol Visualizador. Este paso es el que habilita la lectura.
6. En Merez, abre Analítica → Google Analytics 4. La fila está en “Sin configurar”. Pega el ID de medición, el API Secret y el ID de propiedad, y guarda. Con los datos completos la fila pasa a “Conectada”; si guardas solo el ID de medición, verás “Faltan credenciales”.
7. Pulsa “Enviar evento de prueba”. Merez envía un evento de prueba a tu propiedad. Abre GA4 → Administrar → DebugView: el evento aparece con su nombre y sus parámetros en menos de un minuto, junto al dispositivo o la sesión de depuración.
8. Revisa Informes → Tiempo real. El mismo evento debe sumar en el recuento por nombre de evento. Esa es la confirmación de que el envío llegó al flujo correcto.
9. Por último, entra a Resumen → Analítica web en Merez. Si el ID de propiedad y el permiso están bien, aparecen sesiones y usuarios de los últimos días. Ese panel no muestra el evento de prueba: lee métricas agregadas.

Lo que cambió en Merez con el recorrido: la fila pasó de “Sin configurar” a “Conectada”, la prueba quedó registrada y el resumen empezó a leer la propiedad. Lo que cambió en GA4: un secreto nuevo en el flujo y un usuario más con rol Visualizador.

Cómo comprobar que quedó bien

Haz dos verificaciones separadas, porque el envío y la lectura fallan por motivos distintos.

1. Envío. Pulsa “Enviar evento de prueba” y mira DebugView. Debe aparecer el evento con sus parámetros. Si no aparece, el problema está en el par ID de medición + secreto, o en el flujo.
2. Lectura. Entra a Resumen → Analítica web y confirma que hay datos de los últimos días. Si el envío funciona pero el resumen está vacío, el problema está en el ID de propiedad o en el permiso de Visualizador.
3. Estado. La fila debe decir “Conectada”. Cualquier otro estado del panel es una pista: “Faltan credenciales” apunta a campos incompletos, “Pausada” a una desactivación manual y “Requiere módulo (Analítica)” al plan.

DebugView muestra los eventos marcados para depuración, no todo el tráfico histórico de la propiedad. Si lo usas como única prueba, vas a concluir que la integración está rota cuando en realidad solo estás mirando una ventana parcial (Google Analytics Help, consultado el 7 de noviembre de 2026).

Errores frecuentes

Síntoma	Causa	Qué hacer
La fila queda en “Faltan credenciales”	Falta el ID de medición o el API Secret, o el secreto se pegó incompleto o con espacios	Vuelve a copiar el valor desde GA4 y guarda otra vez. Si perdiste el secreto, crea uno nuevo en el mismo flujo.
La prueba se envía pero no aparece en DebugView	El ID de medición y el secreto son de flujos distintos, o el flujo no es web	Confirma que ambos salen del mismo flujo web y crea el secreto en ese flujo.
Aparece en DebugView pero no en Tiempo real	Retraso normal de procesamiento de GA4	Espera unos minutos y vuelve a mirar. No dispares la prueba en bucle.
Resumen → Analítica web está vacío	Falta el ID de propiedad o la cuenta de servicio no tiene acceso	Revisa el número en Configuración de la propiedad y el rol Visualizador en Acceso a la propiedad.
La fila dice “Requiere módulo (Analítica)”	Tu plan no incluye el módulo Analítica	Pide la activación del módulo. Sin él no se guarda la configuración.
El API Secret quedó en un chat, un repositorio o una captura	El secreto permite escribir en tu propiedad	Crea un secreto nuevo, actualízalo en Merez, guarda y borra el viejo en GA4.

Límites y buenas prácticas

Merez no crea propiedades ni flujos en GA4, no instala la etiqueta en tu sitio y no arregla un etiquetado mal hecho. Tampoco puede leer datos que Google no le autoriza: si el permiso no existe, no hay resumen. El Measurement Protocol es una interfaz de Google y sus requisitos cambian cuando Google los cambia; la documentación consultada en noviembre de 2026 mantiene el protocolo sin planes de retirada, aunque recomienda la API de Data Manager para integraciones nuevas.

• Trata el API Secret como una contraseña de escritura. No lo compartas por chat ni lo dejes en capturas de pantalla.
• Rota el secreto cuando alguien sale del equipo o cuando sospeches que se filtró. Un secreto por integración y por entorno.
• Revisa cada mes que la fila siga en “Conectada”, que el flujo siga recibiendo tráfico y que el ID de propiedad sea el de la propiedad correcta.
• No uses la cuenta de servicio de Merez para otras herramientas. Si se comparte, no podrás saber quién leyó qué.
• DebugView sirve para depurar, no para validar negocio. La validación real es que el resumen y los informes de GA4 cuadren con lo que ves en tu operación.