Invia eventi web a GA4 utilizzando Measurement Protocol

1. Introduzione

Ultimo aggiornamento: 2019-04-30

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 o un sito in cui è implementato Google Analytics 4.

Cosa imparerai a fare

  • Procedura per effettuare la tua prima chiamata MP
  • Comprendere i parametri richiesti per la chiamata
  • Invia e convalida la 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 a cui apportare modifiche
  • Account GA4
  • Facoltativo - Ambiente di sviluppo Python (o Colab)

2. Raccogli i campi obbligatori

Crea un API secret in GA4

Vai a GA4 e crea il tuo nuovo API secret andando su Admin (Amministrazione) > Stream di dati > scegli il tuo stream > Measurement Protocol > Crea

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

Puoi fornire qualsiasi nickname e verrà visualizzato il valore del secret che potrai utilizzare nella tua chiamata

Raccogli client_id

Per raccogliere il tuo client_id puoi utilizzare uno dei seguenti metodi.

  1. Raccolta tramite gtag

Entrambe le opzioni sono illustrate dettagliatamente 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 in base alla tua infrastruttura

3. Costruzione della chiamata

Puoi creare una chiamata di esempio utilizzando il generatore di eventi in GA4. Ciò richiede l'accesso e l'abilitazione dei cookie. Assicurati che il pulsante di attivazione/disattivazione sia impostato su "gtag.js".

b904d2a053eb7817.png

Devi compilare i seguenti campi

  • api_secret: già creato in precedenza in GA4
  • Measurement_id: per accedere, vai ad Amministrazione > Stream di dati > scegli il tuo stream . Dovrebbe essere visualizzato come di seguito

d362992ff592c675.png

  • client_id: hai già recuperato questo valore
  • user_id non è obbligatorio. Puoi lasciarlo vuoto per ora
  • Categoria: modifica questa impostazione 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"

cf580a708bb0a8a2.png

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

da59bb982f6f906a.png

Una volta inseriti tutti i dati, dovresti vedere una schermata simile a questa, con il pulsante "Convalida evento"

31f720d550906298.png

Una volta raggiunto questo obiettivo, fai clic su "CONVALIDA EVENTO" , il pulsante evidenziato in arancione. Dovrebbe essere visualizzato il messaggio riportato di seguito, in cui viene specificato che l'evento è valido. Inoltre, dovrebbe essere visualizzato il pulsante "INVIA A GA". A questo punto, se l'evento non risulta valido, lo strumento ti indicherà il campo esatto in cui si è verificato il problema. Puoi risolvere il problema e riprovare.

1d63d1e067c46294.png

Ora puoi fare clic sul pulsante per inviare un evento di prova a GA4.

4. Convalida degli eventi in GA4

Dopo aver inviato l'evento, puoi accedere al tuo account GA4 e controllare In tempo reale. Dovresti vedere l'evento previsto

7b9e9a0f74b64757.png

La propagazione degli eventi dalla visualizzazione In tempo reale alla scheda dei report sugli eventi effettivi potrebbe richiedere circa 24 ore, quindi non preoccuparti se non la vedi subito nei report sugli eventi standard.

5. Creazione di uno script Python

Dopo averlo testato, puoi esaminare la chiamata API e il payload dell'evento per creare un'architettura simile in Python (o in qualsiasi linguaggio di tua scelta) in grado di effettuare questa chiamata. Puoi quindi programmarlo e renderlo operativo in base alla frequenza desiderata. Per questa parte, puoi utilizzare qualsiasi IDE di tua scelta che supporti Python o semplicemente un blocco note di Google Colab che non richiede alcuna installazione sul tuo dispositivo.

Facendo riferimento al generatore di eventi GA4, noterai che l'endpoint è l'esempio riportato di seguito.

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 tradurla in Python usando qualcosa di 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)

Se esegui questa operazione con i valori corretti, dovresti vedere lo stesso evento in tempo reale in GA4.

6. Complimenti

Complimenti, hai utilizzato correttamente Measurement Protocol in GA4. Ora puoi creare potenti architetture di soluzioni per inviare dati più significativi a Google Analytics e migliorare le attività di marketing e le analisi aziendali. Per sfruttare al massimo tutto ciò, ti consigliamo anche di connetterti a Google Ads e di importare questi eventi come conversioni.

Hai appreso

  • 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

Documenti di riferimento