Montar Google Analytics 4 (gtag vía mu-plugin) #102

Closed
opened 2026-06-28 19:14:41 +00:00 by rafa · 0 comments
Owner

Objetivo

Montar Google Analytics 4 en el WordPress nuevo (wp-nuevo.feadulta.com, que pasará a www.feadulta.com en el cutover).

Método: gtag vía mu-plugin

Insertar el snippet gtag.js (G-XXXXXXX) en el <head> desde un mu-plugin (p. ej. fea-analytics.php, o dentro de fea-homepage.php), enganchado a wp_head. Solo en front-end (no en wp-admin).

Por qué mu-plugin y no Site Kit: el cambio de dominio en el cutover es indoloro — el Measurement ID no está atado al dominio, no hay que reconectar nada. Site Kit, en cambio, se ata a la URL vía Search Console y exige reverificar tras el cambio.

Cambio de dominio (cutover wp-nuevo → www): sin problema

  • El G-XXXXXXX es portable; sigue igual en www. Solo actualizar la Stream URL del data stream (informativa).
  • Cookie con dominio "auto" → se asienta en .feadulta.com (raíz común de wp-nuevo y www) → continuidad de client_id, no se rompen sesiones.
  • GA4 no valida el hostname; durante esta fase el host wp-nuevo.feadulta.com aparecerá en los informes (opcional filtrarlo luego).
  • Cloudflare delante no afecta (gtag es client-side).

Decisiones

  • NO filtrar tráfico interno por IP. Las IPs nuestras (Rafa/Inma) cuentan dentro de las métricas — volumen no relevante (decisión Rafa, 2026-06-19).

Pasos

  1. Crear propiedad GA4 + data stream web → obtener G-XXXXXXX.
  2. mu-plugin que imprime el gtag en wp_head (solo front).
  3. Probar en local (Docker) y desplegar a prod. Recordar gotchas de prod: subir ficheros con ssh '... cat > ruta' (scp no va), verificar server-side / GA Realtime (Cloudflare bloquea headless).
  4. Verificar en GA4 → Tiempo real que llegan hits.

Pendiente

  • Measurement ID G-XXXXXXX (lo crea/aporta Rafa).
## Objetivo Montar **Google Analytics 4** en el WordPress nuevo (`wp-nuevo.feadulta.com`, que pasará a `www.feadulta.com` en el cutover). ## Método: gtag vía mu-plugin Insertar el snippet `gtag.js` (`G-XXXXXXX`) en el `<head>` desde un **mu-plugin** (p. ej. `fea-analytics.php`, o dentro de `fea-homepage.php`), enganchado a `wp_head`. Solo en front-end (no en `wp-admin`). **Por qué mu-plugin y no Site Kit:** el cambio de dominio en el cutover es **indoloro** — el Measurement ID no está atado al dominio, no hay que reconectar nada. Site Kit, en cambio, se ata a la URL vía Search Console y exige reverificar tras el cambio. ## Cambio de dominio (cutover wp-nuevo → www): sin problema - El `G-XXXXXXX` es portable; sigue igual en `www`. Solo actualizar la *Stream URL* del data stream (informativa). - Cookie con dominio "auto" → se asienta en `.feadulta.com` (raíz común de `wp-nuevo` y `www`) → **continuidad de `client_id`**, no se rompen sesiones. - GA4 no valida el hostname; durante esta fase el host `wp-nuevo.feadulta.com` aparecerá en los informes (opcional filtrarlo luego). - Cloudflare delante no afecta (gtag es client-side). ## Decisiones - **NO filtrar tráfico interno por IP.** Las IPs nuestras (Rafa/Inma) cuentan dentro de las métricas — volumen no relevante (decisión Rafa, 2026-06-19). ## Pasos 1. Crear propiedad GA4 + data stream web → obtener `G-XXXXXXX`. 2. mu-plugin que imprime el gtag en `wp_head` (solo front). 3. Probar en local (Docker) y desplegar a prod. Recordar gotchas de prod: subir ficheros con `ssh '... cat > ruta'` (scp no va), verificar server-side / GA Realtime (Cloudflare bloquea headless). 4. Verificar en **GA4 → Tiempo real** que llegan hits. ## Pendiente - Measurement ID `G-XXXXXXX` (lo crea/aporta Rafa).
rafa closed this issue 2026-06-28 19:14:41 +00:00
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rafa/feadulta#102