Google Analytics 4 con Beaconry: Measurement Protocol sobre el endpoint REST de WordPress

GA4 es el canal donde la pérdida por adblockers es más visible porque cada tienda lo corre. Beaconry sustituye gtag.js por un dispatch server-side de Measurement Protocol y te devuelve el 25-30 % de las sesiones que adblockers bloquearon en gtag.

Setup, 90 segundos

GA4 necesita dos valores: el Measurement ID (G-XXXXXXXXXX) y un API Secret de Measurement Protocol. Ambos viven bajo Admin → Data Streams → web stream → Measurement Protocol API secrets. Crea un secret etiquetado "Beaconry plugin", copia ambos valores en Beaconry → Tracking → GA4, guarda. Hecho.

El API Secret se cifra en reposo con AES-256-CBC usando los auth salts de WordPress. Si prefieres mantenerlo fuera de la base de datos, define BCNR_GA4_MEASUREMENT_ID y BCNR_GA4_API_SECRET en wp-config.php y deja vacíos los campos del formulario.

Eventos out of the box

Los mismos seis eventos WooCommerce más las cuatro señales estándar de engagement. Sin llamadas gtag('event', ...) en el código del tema, sin Site Kit, sin contenedor de Tag Manager.

• page_view en cada page-load consentido.
• user_engagement al 50 % de scroll más 10 segundos (el trigger canónico GA4 de "engaged session").
• generate_lead en cada envío de Kadence Blocks Form o Fluent Forms.
• view_item, add_to_cart, begin_checkout, purchase para WooCommerce.
• refund al cambiar el estado a refunded, con valor negativo, misma event_id que el purchase original.

Todos los eventos disparan con el client_id del visitante (construido a partir de un valor de cookie estable), session_id (Beaconry la genera y persiste 30 minutos de inactividad), y las click-IDs relevantes desde la cookie nl_ext cuando estén presentes.

Qué se envía vs gtag

Funcionalmente idéntico desde la perspectiva de GA4. La única diferencia es el origen del request: https://www.google-analytics.com/mp/collect vía tu servidor WordPress (server-to-server) vs la misma URL desde el navegador del visitante (que adblockers bloquean).

Beaconry reenvía el payload del evento como un único request MP por evento. El navegador del visitante ve un request a /wp-json/beaconry/v1/event en tu dominio (200 bytes, same-origin). El navegador no ve www.google-analytics.com en absoluto, salvo que tengas activado el modo híbrido (que para GA4 no recomendamos, ya que gtag añade 60 KB y no hay ventaja de cookie first-party como con Meta).

Settings recomendados del lado GA4

Dentro de GA4, tres configuraciones hacen los datos más útiles independiente de la herramienta de tracking:

• Retención de datos: 14 meses (Admin → Retención de datos). Por defecto son 2 meses, demasiado corto para comparativas año-vs-año.
• Divisa de reporting coincidente con la divisa de tu tienda (Admin → Detalles de propiedad).
• Marcar eventos como conversiones para generate_lead, purchase, sign_up, contact (Configurar → Events → activar "Marcar como conversión").

Ninguno es específico de Beaconry. Es solo higiene sensata de GA4.

Verificación

GA4 → Reports → Realtime confirma la llegada de eventos en 30 segundos. La pestaña DebugView muestra eventos individuales con detalle completo de parámetros; Beaconry tiene un toggle de modo debug por canal que añade debug_mode: true al payload, lo que enruta eventos a DebugView en vez de a los reports estándar. Útil durante staging, retirar antes del lanzamiento.

Dónde ahorra dinero

La recuperación de adblock es el beneficio principal, pero GA4 tiene un segundo vector de coste: el export a BigQuery. Si vendes vía WooCommerce y quieres datos de conversión limpios en BigQuery para modelado de atribución posterior, los datos tienen que llegar primero a GA4. El dispatch server-side cierra ese hueco. El 25-30 % de conversiones que gtag perdía ahora están en BigQuery, no solo en tu cabeza.

Lo que Beaconry NO sustituye

• Custom dimensions y metrics: configuración del lado GA4; Beaconry envía parámetros de evento, GA4 los mapea a dimensiones según tu config.
• Definiciones de audiencia: define audiencias en GA4, Beaconry solo alimenta eventos.
• Reportes de funnel y exploración: GA4 los construye desde el stream de eventos que Beaconry provee.

Para llevar

Para GA4 la respuesta es inequívoca: cambiar a Measurement Protocol vía Beaconry, dejar gtag apagado, recuperar 25-30 % de volumen de conversión en tus reports. Setup en 90 segundos, el contrato API no cambia desde la perspectiva de GA4, y dejas de enviar el bytecode de gtag a tus visitantes.