Invia eventi web a GA4 utilizzando Measurement Protocol

1. Introduzione

Ultimo aggiornamento: 30/04/2019

Cosa creerai

In questo codelab imparerai a inviare eventi esterni a GA4 utilizzando Measurement Protocol.
Questo codelab presuppone che tu abbia già una pagina web/un sito con Google Analytics 4 implementato.

Cosa imparerai a fare

Passaggi per effettuare la prima chiamata di Measurement Protocol
Parametri obbligatori per la chiamata
Invio e convalida della chiamata di prova
Crea uno script di esempio in Python per effettuare la chiamata

Che cosa ti serve

Un sito web/una pagina web
Qualsiasi IDE per apportare modifiche
Account GA4
(Facoltativo) Ambiente di sviluppo Python (o Colab)

2. Raccogliere i campi obbligatori

Crea API secret in GA4

Vai a GA4 e crea il nuovo secret API andando ad Amministrazione > Stream di dati > scegli il tuo stream > Measurement Protocol > Crea.

Puoi fornire qualsiasi nickname e verrà visualizzato il valore del segreto, che potrai utilizzare nella chiamata.

Raccogli client_id

Puoi utilizzare uno dei metodi riportati di seguito per raccogliere il client_id.

Raccolta tramite gTag

Entrambi sono spiegati in dettaglio di seguito.

Raccolta tramite gTag

Puoi recuperare il tuo client_id tramite il tuo sito web utilizzando :

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

Di seguito sono riportati altri link a seconda dell'infrastruttura

gtag.js('get')

3. Costruzione della chiamata

Puoi creare una chiamata di esempio utilizzando Event Builder in GA4. (è necessario effettuare l'accesso e abilitare i cookie). Assicurati che il pulsante di attivazione/disattivazione sia impostato su "gtag.js".

Dovrai compilare i seguenti campi

api_secret: già creato in precedenza in GA4
measurement_id: per ottenere questo valore, puoi andare ad Amministrazione > Stream di dati > scegli lo stream . Dovrebbe essere visualizzato come di seguito

client_id: hai già recuperato questo valore
user_id non è obbligatorio. Per il momento puoi lasciarlo vuoto
Categoria: cambia questa opzione in "Personalizzata" dal menu a discesa e inserisci il nome dell'evento che preferisci (non utilizzare alcun evento raccolto automaticamente). Qui utilizziamo "test_from_codelab"

Se vuoi, puoi anche scegliere di fornire parametri evento e/o proprietà utente facendo clic sui pulsanti di seguito.

Una volta compilato tutto, dovresti vedere qualcosa di simile a questo, con un pulsante per "Convalida evento".

Una volta raggiunto questo punto, fai clic su "CONVALIDA EVENTO" , il pulsante evidenziato in arancione. Dovrebbe essere visualizzato il messaggio riportato di seguito, che specifica che l'evento è valido, e un pulsante "INVIA A GA". A questo punto, se l'evento risulta non valido, lo strumento ti indicherà il campo esatto in cui si verifica un problema, che potrai correggere e riprovare.

Ora puoi fare clic sul pulsante e dovrebbe essere inviato un evento di test a GA4.

4. Convalida degli eventi in GA4

Una volta inviato l'evento, puoi andare al tuo account GA4 e controllare la sezione In tempo reale. Dovresti vedere l'evento

Potrebbero essere necessarie circa 24 ore prima che gli eventi vengano propagati dalla visualizzazione in tempo reale alla scheda dei report sugli eventi effettivi, quindi non preoccuparti se non li vedi immediatamente nei report sugli eventi regolari.

5. Creazione di uno script Python

Ora che l'hai provata, puoi esaminare la chiamata API e il payload dell'evento per creare un'architettura simile in Python (o in qualsiasi linguaggio a tua scelta) che possa effettuare questa chiamata. Puoi quindi pianificarlo con la frequenza che preferisci e renderlo operativo. Per questa parte, puoi utilizzare qualsiasi IDE a tua scelta che supporti Python o semplicemente un notebook Google Colab, che non richiede alcuna installazione sul tuo dispositivo.

Tornando allo strumento di creazione eventi GA4, vedrai che l'endpoint è il seguente:

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

Il payload dell'evento era il seguente

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

Puoi tradurlo in Python utilizzando un codice simile a questo

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 volta eseguita l'operazione con i valori corretti, dovresti vedere l'evento in tempo reale in GA4.

6. Complimenti

Congratulazioni, hai utilizzato correttamente Measurement Protocol in GA4. Ora puoi creare architetture di soluzioni efficaci per inviare dati più significativi a Google Analytics e migliorare l'analisi del marketing e dell'attività. Per sfruttare al meglio questa funzionalità, ti consigliamo anche di connetterti a Google Ads e di importare questi eventi come conversioni.

Hai imparato

Come raccogliere le variabili giuste per effettuare chiamate MP
Come inviare e convalidare gli eventi di test
Come creare uno script per inviare chiamate MP