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 el Protocolo de medición.
  • 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 crear tu primera llamada al 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 web 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

Crear un Secret de API en GA4

Navega a GA4 y crea tu nuevo secreto de API en Administrador > Flujos de datos > elige tus novedades > Protocolo de medición > Crea

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

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

Recopilar client_id

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

  1. Recopilación mediante gtag

Ambos se explican en detalle a continuación.

Recopilación mediante gtag

Puedes recuperar tu client_id a través de tu sitio web utilizando :

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

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

3. Construcción de la llamada

Puedes crear una llamada de muestra mediante el Creador de eventos en GA4. (Para ello, debes acceder a tu cuenta y habilitar las cookies). Asegúrate de que el botón de activación esté establecido en "gtag.js".

b904d2a053eb7817.png

Deberás completar los siguientes campos

  • api_secret: Ya se creó anteriormente en GA4
  • Measurement_id: Para obtener esto, puedes navegar a Administrador > Flujos de datos > elige tu transmisión . Se debe mostrar como se muestra a continuación

d362992ff592c675.png

  • client_id: Ya recuperó este valor
  • El campo user_id no es obligatorio. Puedes dejarlo en blanco por ahora
  • Category: cambia esta opción a "Custom" del menú desplegable y escribe cualquier nombre de evento que desees (no uses ningún evento recopilado automáticamente). Aquí usamos “test_from_codelab”

cf580a708bb0a8a2.png

De manera opcional, también puedes optar por proporcionar parámetros de eventos o propiedades del usuario. Para ello, haz clic en los botones que aparecen a continuación

da59bb982f6f906a.png

Una vez que hayas completado todos los pasos, deberías ver algo como esto, con un botón para "Validar el evento".

31f720d550906298.png

Cuando alcances este límite, haz clic en “VALIDAR EVENTO”. , el botón resaltado en naranja. Debería mostrar el siguiente mensaje, en el que se especifica que el evento es válido, y debería aparecer el botón “ENVIAR A DG”. 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 puedes corregirlo y volver a intentarlo.

1d63d1e067c46294.png

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

4. Valida eventos en GA4

Una vez que hayas enviado el evento, puedes navegar a tu cuenta de GA4 y consultar la opción En tiempo real. Deberías ver que el evento se transmite

7b9e9a0f74b64757.png

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

5. Compila una secuencia de comandos de Python

Ahora que la probaste, puedes examinar la llamada a la API y la carga útil del evento para crear una arquitectura similar en Python (o en cualquier lenguaje que elijas) que pueda realizar esta llamada. Luego, puedes programarlo con la frecuencia deseada y ponerlo en funcionamiento. Para esta parte, puedes usar cualquier IDE que desees que sea compatible con Python o simplemente un notebook de Google Colab que no requiera ninguna instalación en tu dispositivo

Si vuelves al compilador 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 usando 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 de manera similar cómo el evento se refleja en tiempo real en GA4.

6. Felicitaciones

Felicitaciones. Utilizaste correctamente el Protocolo de medición en GA4. Ahora puedes crear arquitecturas de soluciones potentes para enviar datos más significativos a Google Analytics y mejorar tus estadísticas empresariales y de marketing. Para aprovechar al máximo esta situación, también te sugerimos conectarte a Google Ads y, luego, importar estos eventos como conversiones.

Aprendiste lo siguiente:

  • Cómo recopilar las variables correctas para hacer llamadas al MP
  • Cómo enviar y validar eventos de prueba
  • Cómo crear una secuencia de comandos para enviar llamadas de MP

Documentos de referencia