Scegli la tua piattaforma:
Measurement Protocol per Google Analytics 4 non restituisce
codici di errore HTTP
, anche se un evento non è nel formato corretto o se mancano parametri
obbligatori. Per garantire la validità degli eventi, devi testarli rispetto a Measurement Protocol Validation Server prima di eseguirne il deployment in produzione.
Dopo aver verificato che gli eventi siano strutturati correttamente, devi verificare l'implementazione per assicurarti di utilizzare le chiavi corrette.
Puoi chiamare direttamente Validation Server o utilizzare GA4 Event Builder. Il generatore di eventi GA4 consente di creare eventi in modo interattivo e utilizza Measurement Protocol Validation Server per convalidarli.
Questa guida descrive come inviare eventi al server di convalida di Measurement Protocol per Google Analytics 4 e interpretare la risposta.
Invio di eventi per la convalida
L'unica differenza nella richiesta di eventi inviati a Measurement Protocol e al server di convalida di Measurement Protocol è l'URL.
Server | URL |
---|---|
Measurement Protocol | /mp/collect |
Server di convalida del protocollo di misurazione | /debug/mp/collect |
Tutti gli altri campi di richiesta sono uguali. Vedi il riferimento al protocollo per i dettagli completi sulla creazione di una richiesta valida.
Il seguente codice mostra un evento non valido inviato al server di convalida di Measurement Protocol:
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 valore ValidationCode corrispondente all'errore. |
ValidationCode
Valore | Descrizione |
---|---|
VALUE_INVALID |
Il valore fornito per fieldPath non è valido. Consulta le limitazioni.
|
VALUE_REQUIRED |
Non è stato fornito un valore obbligatorio per fieldPath . |
NAME_INVALID |
Il nome fornito non è valido. Consulta le limitazioni. |
NAME_RESERVED |
Il nome fornito era uno dei nomi riservati. Vedi i nomi riservati. |
VALUE_OUT_OF_BOUNDS |
Il valore specificato è troppo grande. Consulta le limitazioni. |
EXCEEDED_MAX_ENTITIES |
La richiesta conteneva troppi parametri. Consulta le limitazioni. |
NAME_DUPLICATED |
Lo stesso nome è stato fornito più volte nella richiesta. |