Riferimento Measurement Protocol

Panoramica

L'invio di dati a Google Analytics utilizzando il modulo di Protocollo:

  1. Il trasporto: dove e come invii i dati
  2. Il payload: i dati che invii

Questo documento descrive la formattazione del trasporto e del payload.

Trasporto

Endpoint URL

Per inviare i dati utilizzando Measurement Protocol, esegui richieste POST HTTP alla il seguente endpoint:

https://www.google-analytics.com/mp/collect

Per inviare un evento, invia la seguente richiesta di POST:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
  • Il BODY della richiesta. Vedi Payload.

Codici di risposta

Measurement Protocol restituisce sempre il codice di stato 2xx se HTTP è stata ricevuta. Measurement Protocol non restituisce un codice di errore se i dati del payload non erano corretti o i dati al suo interno non erano corretti non è stato elaborato da Google Analytics.

Payload

I dati vengono inviati a Google Analytics utilizzando i dati di Measurement Protocol in due parti:

  1. Parametri di query
  2. Un corpo JSON POST

parametri di query

Nome parametro Descrizione

api_secret

Obbligatorio. Un elemento API Secret generato tramite l'interfaccia utente di Google Analytics.

Per creare un nuovo secret, vai nell'interfaccia utente di Google Analytics per:
Amministrazione > Stream di dati > scegli il tuo stream &gt; Measurement Protocol > Crea

Ti consigliamo di mantenerli privati per la tua organizzazione. Se di eseguire il deployment di Measurement Protocol lato client, ruotano regolarmente api_secret per evitare SPAM eccessivo.

Corpo del post JSON

Chiave Tipo Descrizione

user_id

string

(Facoltativo) Un identificatore univoco per un utente. Consulta User-ID per analisi multipiattaforma per ulteriori informazioni su questo identificatore.

timestamp_micros

number

(Facoltativo) Un timestamp Unix (in microsecondi) per il tempo da associare con l'evento. Deve essere impostato solo per registrare gli eventi che si sono verificati in passato. Questo valore può essere sostituito tramite user_property o timestamp degli eventi. Gli eventi possono essere retrodatati fino a tre giorni di calendario in base al fuso orario della proprietà.

user_properties

object (Facoltativo) Le proprietà utente per la misurazione. Consulta la sezione proprietà per ulteriori informazioni.
object (Facoltativo) Configura le impostazioni relative al consenso per la richiesta. Per saperne di più, consulta la sezione relativa al consenso.

non_personalized_ads

boolean (Facoltativo) Imposta true per indicare che i dati dell'utente non devono per gli annunci personalizzati.

events[]

array Obbligatorio. Un array di elementi evento. È possibile inviare fino a 25 eventi per richiesta. Vedi gli eventi di riferimento per tutti gli eventi validi.

events[].name

string Obbligatorio. Il nome dell'evento. Vedi gli eventi riferimento per tutte le opzioni.

events[].params

object (Facoltativo) I parametri dell'evento. Vedi eventi per i parametri suggeriti per ogni evento.

L'attributo consent configura i tipi e gli stati del consenso. Se non specifichi consent, Google Analytics utilizzerà il consenso le impostazioni delle interazioni online corrispondenti per l'istanza del client o dell'app.

Chiave Tipo Descrizione

ad_user_data

string

Facoltativo. Imposta il consenso per l'invio dei dati utente dal eventi e proprietà utente a Google per scopi pubblicitari.

Deve essere GRANTED o DENIED.

ad_personalization

string

Facoltativo. Imposta il consenso per la pubblicità personalizzata dell'utente.

Deve essere GRANTED o DENIED.

Parametri personalizzati

Oltre ai parametri prescritti, puoi includere personalizzate basate sugli utenti, sugli eventi e sugli articoli parametri all'interno di un payload di Measurement Protocol.

  • I parametri personalizzati basati sugli utenti possono essere inclusi nell'oggetto user_properties del payload.
  • I parametri personalizzati basati sugli eventi possono essere inclusi in events[].params l'oggetto del payload.
  • I parametri personalizzati basati sugli articoli possono essere inclusi nel Array items per ogni evento.

Alcuni eventi hanno parametri consigliati. Vedi gli eventi per conoscere i suggerimenti per tutti gli eventi supportati.

Nomi riservati

Nomi di eventi riservati

I seguenti nomi di eventi sono riservati e non possono essere utilizzati:

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_query
  • ad_reward
  • adunit_exposure
  • app_clear_data
  • app_exception
  • app_install
  • app_remove
  • app_store_refund
  • app_update
  • app_upgrade
  • dynamic_link_app_open
  • dynamic_link_app_update
  • dynamic_link_first_open
  • error
  • firebase_campaign
  • firebase_in_app_message_action
  • firebase_in_app_message_dismiss
  • firebase_in_app_message_impression
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • session_start
  • user_engagement

Nomi riservati dei parametri

I seguenti nomi di parametri sono riservati e non possono essere utilizzati:

  • firebase_conversion

Inoltre, i nomi dei parametri non possono iniziare con:

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Nomi di proprietà utente riservati

I seguenti nomi di proprietà utente sono riservati e non possono essere utilizzati:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Inoltre, i nomi delle proprietà utente non possono iniziare con:

  • _ (underscore)
  • firebase_
  • ga_
  • google_