Panoramica
L'invio di dati a Google Analytics utilizzando il modulo di Protocollo:
- Il trasporto: dove e come invii i dati
- 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:
- Parametri di query
- Un corpo
JSON
POST
parametri di query
Nome parametro | Descrizione |
---|---|
|
Obbligatorio. Un elemento
Per creare un nuovo secret, vai nell'interfaccia utente di Google Analytics per:
Ti consigliamo di mantenerli privati per la tua organizzazione. Se
di eseguire il deployment di Measurement Protocol lato client,
ruotano regolarmente |
Corpo del post JSON
Chiave | Tipo | Descrizione |
---|---|---|
|
string |
(Facoltativo) Un identificatore univoco per un utente. Consulta User-ID per analisi multipiattaforma per ulteriori informazioni su questo identificatore. |
|
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
|
|
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. |
|
boolean |
(Facoltativo) Imposta true per indicare che i dati dell'utente non devono
per gli annunci personalizzati.
|
|
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. |
|
string |
Obbligatorio. Il nome dell'evento. Vedi gli eventi riferimento per tutte le opzioni. |
|
object |
(Facoltativo) I parametri dell'evento. Vedi eventi per i parametri suggeriti per ogni evento. |
Consenso
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 |
---|---|---|
|
string |
Facoltativo. Imposta il consenso per l'invio dei dati utente dal eventi e proprietà utente a Google per scopi pubblicitari. Deve essere |
|
string |
Facoltativo. Imposta il consenso per la pubblicità personalizzata dell'utente. Deve essere |
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.
Valori consigliati per determinati eventi
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_