Conectar Google Analytics 4 a Elido

Elido envía eventos de conversión a GA4 del lado del servidor utilizando el Measurement Protocol. Esto significa que las conversiones aparecen en GA4 independientemente de si el usuario tiene un bloqueador de anuncios, sin necesidad de JavaScript en su página.

Lo que necesitas#

• Una propiedad de GA4 (no Universal Analytics).
• Acceso al panel de Admin de la propiedad.
• Aproximadamente 5 minutos.

Paso 1 — Encuentra tu Measurement ID#

1. Ve a Google Analytics.
2. Haz clic en Admin (icono de engranaje en la parte inferior izquierda).
3. En Property, haz clic en Data streams → Web.
4. Haz clic en tu web data stream.
5. Copia el Measurement ID — comienza con G-, por ejemplo G-XXXXXXXXXX.

Paso 2 — Crea un secreto de API de Measurement Protocol#

En la misma página de data stream:

1. Desplázate hasta Measurement Protocol API secrets.
2. Haz clic en Create.
3. Dale un nombre ("Elido") y haz clic en Create.
4. Copia el valor secreto. Solo se muestra una vez. Si lo pierdes, crea uno nuevo — los secretos antiguos siguen funcionando hasta que los elimines.

Paso 3 — Configura en Elido#

1. Ve a Dashboard → Conversions → GA4 → Set up forwarding.
2. Pega el Measurement ID y el API secret.
3. Haz clic en Save. Elido envía inmediatamente un evento de prueba (elido_test) a GA4.

Cómo Elido mapea client_id#

GA4 requiere un client_id para atribuir eventos a un usuario. Elido lo deriva de:

1. Si la página de destino de tu enlace corto establece una cookie _ga y el valor se devuelve a través de tu píxel de conversión — Elido lo lee directamente.
2. De lo contrario, Elido aplica hash al click_id de Elido (por ejemplo, clk_abc123) a una cadena con formato UUID estable y la utiliza como client_id.

Esto significa que GA4 mostrará estos eventos bajo un "usuario" que puede no coincidir con tus sesiones web existentes de GA4 — no se unirán. Para una unión completa de sesiones, pasa el valor de la cookie _ga a tu servidor e inclúyelo en la llamada a la API de Conversiones de Elido.

Nombres de eventos en GA4#

Elido reenvía estos eventos:

Evento de Elido	Nombre de evento en GA4
conversion.recorded	purchase (con valor + moneda)
link.clicked (si está habilitado)	elido_click
threshold.exceeded	elido_threshold

El evento purchase se utiliza porque GA4 tiene informes integrados para él en la sección de Monetization. Todos los eventos incluyen utm_source, utm_medium, utm_campaign como parámetros de evento.

Solución de problemas#

No aparecen eventos en Realtime — Verifica el Measurement ID y el API secret. Un API secret incorrecto devuelve HTTP 204 (sin contenido) pero GA4 descarta silenciosamente la carga útil. Verifica llamando directamente al endpoint del Measurement Protocol:

curl -X POST \
  "https://www.google-analytics.com/debug/mp/collect?measurement_id=G-XXXX&api_secret=YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"test","events":[{"name":"elido_test","params":{}}]}'

Una llamada de depuración exitosa devuelve {"validationMessages":[]}.

Los eventos aparecen en Realtime pero no en los informes regulares — Los eventos del Measurement Protocol pueden tardar entre 24 y 48 horas en aparecer en los informes de GA4 que no son en tiempo real. Esta es una limitación de GA4, no un problema de Elido.

Moneda incorrecta en los eventos de compra — Elido lee la moneda del campo currency del evento de conversión. El valor predeterminado es EUR. Establécelo explícitamente en tu llamada a la API de registro de conversiones.

Eventos duplicados — Si tu sitio también dispara un evento purchase de GA4 del lado del cliente, verás duplicados. Deshabilita el evento del lado del cliente o usa un nombre de evento diferente en la configuración de mapeo de Elido.