Integrations, Google Analytics
Las analíticas web son opt-in y mínimas: provee un ID de Google Analytics o Tag Manager en Settings → Integrations, y cada página construida recibe el script de Google correspondiente: nada más, y absolutamente nada hasta que tu visitante haya interactuado con la página. No hay analíticas por página, no hay datos fluyendo hacia el CMS, y (en modo air-gap) no hay llamadas externas en absoluto.
Qué IDs fijar
Dos campos, coordinados:
- GA4 measurement ID (
G-XXXXXXXXXX); la ruta directa de Google Analytics 4: el gtag.js estándar se agrega a cada página. - GTM container ID (
GTM-XXXXXXX), en cambio encamina el site a través de Google Tag Manager, donde los tags que gestionas viven en el container.
Funcionan en la misma página pero no cargan ambos: GTM gana cuando ambos están llenos (el loader de gtag GA4 se omite intencionalmente para que el tracking no se duplique por dos caminos). Elige uno: el ID de GA4 si trackeas directamente en Google Analytics, o GTM si el container es donde vive tu tracking.
Cómo el script llega a la página
Cada build inyecta el snippet loader en cada página construida una vez, y el loader mismo es deliberadamente educado:
- Se dispara solo después de que el visitante interactúa: click, scroll, keydown, o el primer touch.
- Si la cookie notice de tu site está activa, la analítica solo corre después de que el visitante haya aceptado la cookie: la cookie se usa directamente, y los rechazos (
cookie_consent=0) son honrados por el loader incluso sin tooling. - GA4/GTM configurados: exactamente uno de los dos carga: GA4 solo carga gtag.js; GTM carga el loader estándar de GTM (control completo del container), con esto para que el site no pueda descargar el tracking por duplicado.
Los tags aparecen en el momento del build en las páginas generadas, así que el efecto es instantáneo por rebuild de página y no se necesita configuración dinámica.
Modo air-gap
Fijar el modo air-gap del environment apaga todo el panel:
- Los dos campos pasan a read-only y una notice inline lo dice: "External analytics scripts (GA4, GTM) are disabled and will not be emitted in builds."
- El build mismo strippea los IDs, así que un valor obsoleto no puede hacer que el site llame a Google; el strippeo de snippets también verificado mantiene las URLs fuera-del-site fuera de las páginas emitidas.
- Activar el air-gap después desarma automáticamente estos IDs; los valores se quedan en los settings para después.
Campo relacionado en la misma pestaña
- X / Twitter handle (con el
@), no es analítica, construye el meta tagtwitter:siteen cada página construida para tarjetas de enlace más lindas. Mismo panel de Integrations, sistema distinto, listado por completitud.
Notas prácticas
- Deja los campos en blanco para no tener ninguna analítica: el CMS sirve páginas limpias, sin scripts, que es el comportamiento por defecto del proyecto.
- Como estos son campos de texto sin validación del lado del cliente, un paste al que le falte un carácter (por ejemplo, olvidar el prefix
G-) resulta en un script sin uso en lugar de un error: revisa el page source de una página construida para confirmar que el measurement ID aparece correctamente. - Si usas GTM, recuerda que los tags de GA4 que creas dentro del container se gestionan en el provider: deja
ga4_iden blanco en Chinaski para evitar un segundo camino de doble cabeza. - Los trackers custom más allá de GA4/GTM (Piwik, Plausible, Meta pixel…) pertenecen al sistema de Snippets (el mecanismo estándar de inyección de head/body), con el mismo loading consciente de consent y (en modo air-gap) las reglas de strippeo de URLs externas.
La versión corta
Pega un identificador de GA4 o de GTM bajo Settings → Integrations y el loader de Google correspondiente queda horneado en cada build: consciente del consent si tu cookie banner está encendido, solo después de una primera interacción, doblemente asegurado en modo air-gap; y nada de eso viaja de ida y vuelta por tu server.