Inviare eventi

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Panoramica

Questa guida spiega come formattare e inviare richieste al Measurement Protocol di Google Analytics.

Inviare eventi

Per inviare un evento, effettua una richiesta HTTP POST al seguente endpoint:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Parametri obbligatori

Una richiesta valida richiede due insiemi di parametri che variano se utilizzi Firebase o gtag.js:

  1. Parametri URL

    • api_secret - Obbligatorio. Un elemento API SECRET generato nell'interfaccia utente di Google Analytics. Per creare un nuovo secret, vai a:
      Amministratore > stream di dati > scegli il tuo stream > Measurement Protocol > Create

    Consulta i parametri di ricerca per il riferimento completo.

  2. Testo JSON

    • user_id - Facoltativo. Identificatore univoco di un utente. Per ulteriori informazioni su questo identificatore, consulta la pagina User-ID per l'analisi multipiattaforma.

    • events - Obbligatorio. Un array di elementi evento.

    Consulta JSON POST BODY per il riferimento completo.

Affinché l'attività utente venga visualizzata nei report standard come in tempo reale, i parametri engagement_time_msec e session_id devono essere forniti come parte di params per un event.

Esempio:

{
"client_id": "x",
"events": [
  {
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123"
    }
  }
]
}

Anche se session_start è un nome evento prenotato, la creazione di un nuovo session_id creerà una nuova sessione senza dover inviare session_start.

Invia un evento

Per inviare un evento tutorial_begin, effettua la seguente richiesta:

Limitazioni

  • Le richieste possono avere al massimo 25 eventi.
  • Gli eventi possono avere al massimo 25 parametri.
  • Gli eventi possono avere al massimo 25 proprietà utente.
  • I nomi delle proprietà utente non possono superare i 24 caratteri.
  • I valori delle proprietà utente non possono superare i 36 caratteri.
  • I nomi degli eventi devono avere una lunghezza massima di 40 caratteri, possono contenere solo caratteri alfanumerici e trattini bassi e devono iniziare con un carattere alfabetico.
  • I nomi dei parametri (inclusi i parametri articolo) non devono superare i 40 caratteri, possono contenere solo caratteri alfanumerici e trattini bassi e devono iniziare con un carattere alfabetico.
  • I valori dei parametri (inclusi i valori parametro articolo) non devono superare i 100 caratteri.
  • I parametri degli articoli possono avere al massimo 10 parametri personalizzati.
  • Il corpo del palo deve essere inferiore a 130 kB.