Envía eventos web a GA4 con el Protocolo de medición

1. Introducción

Última actualización: 30/04/2019

Qué compilarás

  • En este codelab, aprenderás a enviar eventos externos a GA4 con Measurement Protocol.
  • En este codelab, se supone que ya tienes una página web o un sitio con Google Analytics 4 implementado.

Qué aprenderás

  • Pasos para realizar tu primera llamada a la API de MP
  • Comprende los parámetros necesarios para la llamada
  • Envía y valida tu llamada de prueba
  • Compila una secuencia de comandos de muestra en Python para realizar la llamada

Requisitos

  • Un sitio o una página web
  • Cualquier IDE para realizar cambios
  • Cuenta de GA4
  • Opcional: Entorno de desarrollo de Python (o Colab)

2. Recopila los campos obligatorios

Crea un secreto de API en GA4

Navega a GA4 y crea tu nuevo secreto de API en Administrador > Flujos de datos > elige tu flujo > Protocolo de medición > Crear.

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

Puedes proporcionar cualquier apodo y se mostrará el valor del secreto, que puedes usar en tu llamada.

Recopila client_id

Puedes usar cualquiera de los siguientes métodos para recopilar tu client_id.

  1. Recopilación a través de gTag

Ambos se explican en detalle a continuación.

Recopilación a través de gtag

Puedes recuperar tu client_id a través de tu sitio web con el siguiente código :

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

A continuación, se incluyen más vínculos según tu infraestructura

3. Cómo construir la llamada

Puedes crear una llamada de muestra con el Generador de eventos en GA4. (Para ello, debes acceder y habilitar las cookies). Asegúrate de que el botón de activación esté configurado como "gtag.js".

b904d2a053eb7817.png

Deberás completar los siguientes campos

  • api_secret: Ya se creó anteriormente en GA4
  • measurement_id: Para obtenerlo, puedes navegar a Administrador > Flujos de datos > elige tu flujo . Debería mostrarse de la siguiente manera:

d362992ff592c675.png

  • client_id: Ya recuperaste este valor.
  • El parámetro user_id no es obligatorio. Por ahora, puedes dejarlo en blanco.
  • Categoría: Cambia esta opción a "Personalizado" en el menú desplegable y, luego, ingresa el nombre del evento que desees (no uses ningún evento recopilado automáticamente). Aquí usamos "test_from_codelab".

cf580a708bb0a8a2.png

De manera opcional, también puedes proporcionar parámetros de eventos o propiedades del usuario haciendo clic en los botones que se encuentran a continuación.

da59bb982f6f906a.png

Una vez que hayas completado todo, deberías ver algo como esto, con un botón para "Validar evento":

31f720d550906298.png

Una vez que llegues a este punto, haz clic en "VALIDATE EVENT" , el botón destacado en naranja. Debería mostrar el siguiente mensaje, en el que se especifica que el evento es válido, y verás un botón para "ENVIAR A GA". En este punto, si el evento aparece como no válido, la herramienta te indicará el campo exacto en el que hay un problema, y podrás corregirlo y volver a intentarlo.

1d63d1e067c46294.png

Ahora puedes hacer clic en el botón, y debería enviar un evento de prueba a GA4.

4. Cómo validar eventos en GA4

Una vez que envíes el evento, puedes navegar a tu cuenta de GA4 y consultar el informe En tiempo real. Deberías ver el evento

7b9e9a0f74b64757.png

Los eventos pueden tardar alrededor de 24 horas en propagarse desde la vista en tiempo real hasta la pestaña de informes de eventos real, por lo que no debes preocuparte si no ves esto en los informes de eventos normales de inmediato.

5. Cómo compilar una secuencia de comandos de Python

Ahora que lo probaste, puedes examinar la llamada a la API y la carga útil del evento para compilar una arquitectura similar en Python (o en cualquier lenguaje que elijas) que pueda realizar esta llamada. Luego, puedes programar esta acción con la frecuencia que desees y ponerla en funcionamiento. Para esta parte, puedes usar cualquier IDE de tu elección que admita Python o simplemente usar un notebook de Google Colab que no requiera instalación en tu dispositivo.

Si vuelves al Generador de eventos de GA4, verás que el extremo es el siguiente:

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

La carga útil del evento era la siguiente:

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

Puedes traducir esto a Python con algo como lo siguiente:

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

Una vez que ejecutes esto con los valores correctos, deberías ver el evento reflejado en tiempo real en GA4.

6. Felicitaciones

Felicitaciones, usaste correctamente Measurement Protocol en GA4. Ahora puedes crear arquitecturas de soluciones eficaces para enviar datos más significativos a Google Analytics y mejorar tus análisis de marketing y empresariales. Para aprovechar al máximo esta función, también te sugerimos que te conectes a Google Ads y que importes estos eventos como conversiones.

Aprendiste lo siguiente:

  • Cómo recopilar las variables adecuadas para realizar llamadas a MP
  • Cómo enviar y validar eventos de prueba
  • Cómo compilar un script para enviar llamadas de MP

Documentos de referencia