✅ Checklist de Depuración de GA4
Google Analytics 4 (GA4) te da una vista más completa del comportamiento de tus visitantes en distintos dispositivos. Esta guía resume la configuración básica de seguimiento de vistas de página y una checklist de puntos comunes a revisar cuando los datos no aparecen como esperas.
📋 Contenido de este Tutorial
🛠️ Configuración Básica de Seguimiento
✅ Checklist de Depuración
📝 Notas
🛠️ Configuración Básica de Seguimiento
Inicia sesión en tu cuenta de GA4.
Ve al panel de Administración.
Selecciona Crear Propiedad y ponle un nombre descriptivo relacionado a tu Sitio o Embudo.
Ve a Flujo de Datos (Data Stream) en el menú lateral.
Elige la opción Web, ingresa la URL de tu Sitio o Embudo, nómbrala y haz clic en Crear Flujo.
Agrega el código Google Site Tag (gtag.js) al Código de Seguimiento del Encabezado (Head Tracking Code) de tu Sitio o Embudo, o usa Google Tag Manager siguiendo sus instrucciones oficiales.
✅ Checklist de Depuración
El código no aparece dentro de la etiqueta <head> al ver el código fuente: es normal. Los códigos de seguimiento se inyectan del lado del cliente (navegador), por lo que no se ven en el código fuente inicial, aunque siguen siendo compatibles con Google Tag Manager.
Un campo personalizado actualizado no se refleja en la página: los campos personalizados se guardan en la base de datos de contactos, pero la página obtiene esos datos desde el almacenamiento local o cookies del navegador. Las actualizaciones hechas desde Automatizaciones o el backend no se sincronizan automáticamente al navegador; necesitas capturar el dato en un formulario o usar un script personalizado para actualizarlo.
Imágenes borrosas o de carga lenta: desactiva la optimización automática para esa imagen específica, desactiva la optimización de imágenes de fondo, o sube un archivo de mayor resolución.
Los valores personalizados no se muestran o se rompen: revisa si el texto tiene un hipervínculo (elimínalo) o si el contenido viene de una IA con caracteres especiales como \\n (reemplázalos por <br/> usando el formateador de texto).
No sabes en qué página está el visitante en el sitio en vivo: abre la pestaña de Red (Network) del navegador, activa el filtro XHR, recarga la página y revisa el payload del evento correspondiente.
La página no renderiza correctamente (desalineada, en bucle, con errores visuales): elimina código personalizado en elementos de código y en códigos de seguimiento, busca "c-custom-code" en el inspector del constructor, desactiva opciones "sticky" en secciones o elementos, elimina temporizadores vencidos, y revisa la consola del navegador por errores de hidratación.
Encabezados de seguridad bloquean scripts, imágenes o estilos: revisa la pestaña de Seguridad en Configuración de tu Sitio, elimina temporalmente los encabezados personalizados para aislar el problema, asegúrate de no tener saltos de línea en los valores, y valida la sintaxis de tu Content-Security-Policy con el evaluador de CSP de Google.
📝 Notas
Después de completar la configuración, los datos de GA4 pueden tardar entre 24 y 48 horas en reflejarse por completo.
Prueba siempre en modo incógnito después de aplicar correcciones, para descartar caché del navegador.
