Convalida eventi

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.