GA4, Measurement Protocol

Despacho server-side a Google Analytics 4 vía el Measurement Protocol oficial. Dos valores, ambos sacados de la propiedad web GA4 que debe recibir los eventos de Beaconry.

1. Buscar Measurement ID y API Secret

• Abre Google Analytics y haz clic en el icono de engranaje (Admin) abajo a la izquierda.
• En Recogida y modificación de datos, elige Flujos de datos.
• Haz clic en el flujo web que debe recibir los eventos de Beaconry.
• El Measurement ID tiene la forma G-XXXXXXXXXX. Cópialo.
• Baja a Measurement Protocol, API secrets y haz clic en Crear.
• Ponle de alias "Beaconry plugin", haz clic en Crear y copia el valor del secret.

2. Pegar las credenciales en Beaconry

WordPress Admin, Beaconry, Tracking, Google Analytics 4. Pega los dos valores. Guarda.

El API Secret se cifra en reposo con AES-256-GCM. Alternativa con constantes: BCNR_GA4_MEASUREMENT_ID y BCNR_GA4_API_SECRET en wp-config.php.

3. Enviar el evento de prueba

Pulsa Enviar evento de prueba GA4. Beaconry dispara un evento de prueba síncrono beaconry_test_ping al Measurement Protocol y reporta la validación inline.

Comprueba en GA4, Informes, Tiempo real en unos 30 segundos. El evento debe aparecer con el user-agent y la fuente correctos.

4. Ajustes recomendados de la propiedad GA4

Estos están dentro de GA4, no en Beaconry. Evitan los errores típicos.

• Retención de datos: 14 meses. Admin, Retención de datos. El default es de 2 meses, demasiado corto para comparaciones interanuales.
• Divisa de reporting. Admin, Detalles de la propiedad, Divisa. Cambia a EUR si los eventos usan EUR.
• Marcar eventos como conversiones. Configurar, Eventos, activa "Marcar como conversión" en generate_lead, submit_application, sign_up, purchase, contact.
• Tiempo real y DebugView para pruebas. Informes, Tiempo real muestra eventos en unos 30 segundos. DebugView solo muestra eventos con debug_mode: true en el payload (Beaconry se puede poner en debug mode desde la pestaña Advanced).

Qué se envía automáticamente

• page_view en cada carga de página con consentimiento.
• user_engagement al 50 por ciento de scroll más 10 segundos.
• generate_lead en cada envío de Kadence Blocks Form o Fluent Forms.
• add_to_cart, begin_checkout, purchase para WooCommerce. Incluye line items, divisa y valor.

event_id estable por pedido para deduplicación cross-device si también corres un setup gtag en el navegador en paralelo.

Troubleshooting

• "validation_messages" en la respuesta del Measurement Protocol. El endpoint debug de Beaconry los captura. Pestaña Logs, GA4 dispatches, haz clic en cualquiera para ver el feedback de validación de Google.
• Eventos en Tiempo real pero no en informes estándar. Los informes estándar de GA4 tienen 24 a 48 horas de retraso de procesamiento. Tiempo real es la fuente de verdad para "¿llegó el evento?".
• "User Property limit reached". GA4 limita las propiedades de usuario personalizadas a 25 por propiedad. Beaconry usa tres (user_id, nl_pref_state, nl_attribution). Si también usas gtag con propiedades personalizadas, podrías llegar al límite.