Scegli la tua piattaforma:
Measurement Protocol di Google Analytics non restituisce
HTTP
codice di errore, anche se un evento non è nel formato corretto o è obbligatorio mancante
parametri. Per assicurarti che gli eventi siano validi, devi testarli rispetto alla
Measurement Protocol Validation prima di eseguirne il deployment in produzione.
Dopo aver verificato che gli eventi sono strutturati correttamente, devi
verificare l'implementazione per assicurarti di utilizzare le chiavi corrette.
Puoi chiamare direttamente il server di convalida o utilizzare Google Analytics Generatore di eventi. Il generatore di eventi di Google Analytics ti consente di creare eventi e utilizzare Measurement Protocol Validation Server per e convalidarle.
Questa guida descrive come inviare eventi a Measurement Protocol per Google Analytics 4 Validation Server e interpreta la risposta.
Invio di eventi per la convalida
L'unica differenza nella richiesta di eventi inviati a Measurement Protocol e il server di Measurement Protocol Validation è l'URL.
Server | URL |
---|---|
Measurement Protocol | /mp/collect |
Server di Measurement Protocol | /debug/mp/collect |
Tutti gli altri campi di richiesta sono uguali. Per la versione completa, consulta il riferimento al protocollo per creare una richiesta valida.
Il seguente codice mostra un evento non valido inviato a Measurement Protocol Server di convalida:
const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
app_instance_id: 'app_instance_id',
events: [{
// Event names must start with an alphabetic character.
name: '_badEventName',
params: {},
}]
})
});
Risposta di convalida
Ecco la risposta del server di convalida all'evento precedente:
{
"validationMessages": [
{
"fieldPath": "events",
"description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
"validationCode": "NAME_INVALID"
}
]
}
Risposta
Chiave | Tipo | Descrizione |
---|---|---|
validationMessages |
Array<ValidationMessage> | Un array di messaggi di convalida. |
ValidationMessage
Chiave | Tipo | Descrizione |
---|---|---|
fieldPath |
stringa | Il percorso del campo non valido. |
description |
stringa | Una descrizione dell'errore. |
validationCode |
ValidationCode | Un ValidationCode che corrisponde all'errore. |
ValidationCode
Valore | Descrizione |
---|---|
VALUE_INVALID |
Il valore fornito per fieldPath non è valido. Vedi le limitazioni.
|
VALUE_REQUIRED |
Non è stato fornito un valore obbligatorio per fieldPath . |
NAME_INVALID |
Il nome fornito non è valido. Vedi le limitazioni. |
NAME_RESERVED |
Il nome fornito era uno dei nomi riservati. Vedi prenotati personalizzati. |
VALUE_OUT_OF_BOUNDS |
Il valore fornito era troppo elevato. Vedi le limitazioni. |
EXCEEDED_MAX_ENTITIES |
La richiesta conteneva troppi parametri. Vedi le limitazioni. |
NAME_DUPLICATED |
Lo stesso nome è stato indicato più di una volta nella richiesta. |