Depura y prueba tu configuración del lado del servidor
Una configuración del lado del servidor tiene más piezas que un contenedor web: el navegador, tu subdominio, el contenedor de servidor y los proveedores que hay detrás. Cuando faltan datos, encuentras el fallo siguiendo un hit a lo largo de ese camino. Esta lección te muestra las herramientas para cada paso y los problemas más frecuentes, con sus soluciones.
Intermedio 9 min de lectura
Lo que aprenderás
- Usar el Preview web y el de servidor a la vez y leer qué hizo el contenedor de servidor con cada solicitud.
- Confirmar en DevTools y en GA4 DebugView que los hits llegan a tu subdominio y a GA4.
- Reconocer y solucionar las causas más habituales de datos que faltan en el servidor.
- Usar las pestañas del contenedor en SGTM.space para revisar el estado, el DNS, el tráfico y tu instalación en producción.
01 Usa el Preview web y el de servidor a la vez
El Preview de GTM funciona en los dos contenedores a la vez. El orden importa: la sesión de Preview del servidor tiene que estar abierta antes de que el Preview web envíe nada, y ambas deben ejecutarse en el mismo navegador.
- 1 Abre el contenedor de servidor en GTM y haz clic en Preview. Se abre una pestaña de Tag Assistant en
sgtm.example.com. Déjala abierta. - 2 En el mismo navegador, abre el contenedor web y haz clic en Preview. Introduce la dirección de tu sitio y haz clic en Connect.
- 3 Navega por el sitio y provoca el evento que quieres probar.
- 4 Cambia a la pestaña del Preview del servidor. Cada solicitud entrante aparece en la columna de la izquierda.
Selecciona una solicitud y léela de arriba abajo:
- Request: la solicitud HTTP entrante y el Client que la reclamó. Un hit de GA4 debería reclamarlo el cliente GA4.
- Tags: qué etiquetas se activaron y cuáles no. Si una etiqueta no se activó, normalmente es porque su activador no coincidió.
- Outgoing HTTP requests (en la pestaña Request): lo que el servidor envió a GA4 o a otro proveedor, y el código de estado que recibió. Un estado 2xx significa que el proveedor lo aceptó.
- Event Data: los parámetros que extrajo el cliente. Comprueba que han llegado el nombre del evento y sus parámetros.
02 Revisa el navegador y GA4
El Preview te dice qué hizo GTM. Dos comprobaciones más confirman qué salió realmente del navegador y qué llegó a GA4.
- 1 Abre DevTools (F12), ve a la pestaña Network y filtra por
collect. - 2 Recarga la página. Deberías ver solicitudes a tu propio subdominio, no a
google-analytics.com. - 3 Mira el estado:
200o204significa que tu servidor de etiquetado aceptó el hit.
https://sgtm.example.com/g/collect?v=2&tid=G-XXXXXXXXXX&en=page_view&...Después abre GA4, ve a Admin, luego Data display y DebugView. Los eventos de un navegador en el Preview de GTM se marcan automáticamente como tráfico de depuración. Fuera del Preview, añade a tu etiqueta de Google el parámetro debug_mode con el valor true para verlos ahí.
03 Problemas habituales y cómo solucionarlos
La mayoría de las configuraciones rotas fallan en uno de estos puntos. Revísalos en orden, del DNS al proveedor.
- Comprobar DNS falla o el subdominio no resuelve. Puede que el registro aún se esté propagando (espera hasta una hora), que el nombre incluya el dominio dos veces (
sgtm.example.com.example.com, porque algunos paneles añaden el dominio por ti) o que el proxy de Cloudflare esté activado. En Cloudflare el registro debe estar en DNS only (nube gris), no en la nube naranja. - Container Config incorrecto o antiguo. Si el contenedor de servidor del Preview no coincide con el que editas en GTM, vuelve a copiar el Container Config desde Admin y Container Settings y asegúrate de que tu contenedor en SGTM.space usa exactamente esa cadena. Un config de otro contenedor de servidor envía tu tráfico al contenedor equivocado.
- Los hits siguen yendo a
google-analytics.com. Falta el parámetroserver_container_urlen la etiqueta de Google, tiene una errata o no publicaste el contenedor web después de añadirlo. Consulta la lección 3. - Funciona en Preview pero no con visitantes reales. El contenedor de servidor nunca se publicó. El Preview usa tu espacio de trabajo; el tráfico real usa la versión publicada. Haz clic en Submit y Publish en el contenedor de servidor.
- Llegan solicitudes pero nada llega a GA4. El contenedor de servidor no tiene etiqueta GA4 o su activador no coincide. Añade una etiqueta Google Analytics: GA4 activada por Client Name equals
GA4, como se explica en la lección 4. - Faltan hits de algunos visitantes. Los bloqueadores de anuncios aún pueden frenar solicitudes y, con Consent Mode, puede que las etiquetas no se activen o solo envíen pings sin cookies hasta que el visitante acepte. Consulta la lección 6 y la lección 8.
- De repente se rechazan todas las solicitudes. El contenedor ha alcanzado el límite de solicitudes de su plan de SGTM.space. Las solicitudes se rechazan hasta que se amplíe el límite o empiece un nuevo periodo. La pestaña Analíticas muestra lo cerca que estás.
04 Usa las pestañas del contenedor en SGTM.space
Cada contenedor de SGTM.space tiene pestañas que responden a las preguntas que GTM no puede responder.
- Resumen: el estado del contenedor y sus comprobaciones de salud. Empieza aquí cuando no llega absolutamente nada.
- DNS: los registros que hay que añadir y su estado. Usa Comprobar DNS después de cada cambio.
- Analíticas: el número de solicitudes por día. Una caída repentina a cero apunta a una instalación rota o a un cambio de DNS, no a GA4.
- Preview Mode: envía durante 60 minutos las solicitudes coincidentes de webhooks, un CRM o tu backend a tu sesión abierta de Preview del servidor.
Preview Mode te ayuda cuando las solicitudes no vienen de tu navegador y, por tanto, falta la cookie normal de Preview.
- 1 Abre Preview en el contenedor de servidor. En el menú de arriba a la derecha elige Send requests manually y copia el valor de la cabecera
X-Gtm-Server-Preview. - 2 En SGTM.space abre la pestaña Preview Mode y pega el token.
- 3 Si quieres, indica un prefijo de ruta (por ejemplo
/webhooks) y una IP de origen, para que solo se reenvíen esas solicitudes. - 4 Haz clic en Guardar e iniciar durante 60 minutos y lanza el webhook o la llamada del backend. Aparecerá en tu sesión de Preview.
05 Lista rápida de pruebas
-
https://sgtm.example.com/healthzdevuelve 200 y el contenedor está Listo en Resumen. - DevTools muestra solicitudes
collecta tu subdominio con estado 200 o 204. - El Preview del servidor muestra la solicitud reclamada por el cliente GA4.
- La etiqueta GA4 se activó y su solicitud saliente recibió un estado 2xx.
- El evento aparece en GA4 DebugView.
- Los dos contenedores están publicados.
Preguntas frecuentes
¿Por qué el Preview del servidor está vacío si el Preview web muestra eventos?
O los hits no van a tu subdominio (revisa server_container_url y la pestaña Network), o abriste el Preview del servidor en otro navegador o después del Preview web. Abre primero el Preview del servidor y luego inicia el Preview web en el mismo navegador.
¿Puedo depurar solicitudes de mi backend o de un webhook?
Sí. Copia el token X-Gtm-Server-Preview desde Send requests manually en el Preview del servidor y pégalo en la pestaña Preview Mode de SGTM.space. Las solicitudes coincidentes aparecerán en tu sesión de Preview durante 60 minutos.
GA4 muestra menos eventos que la pestaña Analíticas. ¿Se pierden datos?
No necesariamente. La pestaña Analíticas cuenta cada solicitud que recibe tu contenedor, incluidas las cargas de scripts, los bots y los eventos que ninguna etiqueta reenvía. Compara un solo evento en Preview y en DebugView en lugar de los totales.
¿Listo para ponerlo en práctica?
Despliega un contenedor GTM de servidor en tu propio dominio en pocos minutos. El plan Gratis no pide tarjeta.
Crear una cuenta gratuita