Convalida degli eventi

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Panoramica

Measurement Protocol per Google Analytics 4 non restituisce codici di errore HTTP, anche se un evento è in un formato non corretto o mancano parametri obbligatori. Per assicurarti che gli eventi siano validi, devi testarli con il server di convalida di Measurement Protocol prima di eseguirne il deployment in produzione. Dopo aver verificato che i tuoi eventi sono strutturati correttamente, devi verificare l'implementazione per assicurarti di utilizzare le chiavi corrette.

Puoi chiamare il server di convalida direttamente o utilizzare lo Strumento di creazione eventi GA4. Lo strumento per la creazione degli eventi GA4 ti consente di creare eventi in modo interattivo e utilizza il server di convalida di Measurement Protocol per convalidarli.

Questa guida descrive come inviare eventi al Measurement Protocol per Google Analytics 4 Validation Server e interpretare la risposta.

Inviare 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 di Measurement Protocol /debug/mp/collect

Tutti gli altri campi della richiesta sono uguali. Consulta il riferimento per il protocollo per i dettagli completi sulla creazione di una richiesta valida.

Il codice seguente mostra un evento non valido inviato al server di convalida di Measurement Protocol:

Risposta di convalida

Di seguito è riportata 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.

Messaggio di convalida

Chiave Tipo Descrizione
fieldPath string Percorso del campo non valido.
description string Una descrizione dell'errore.
validationCode ValidationCode Un codice di convalida che corrisponde all'errore.

Codice di convalida

Valore Descrizione
VALUE_INVALID Il valore fornito per un elemento fieldPath non è valido. Consulta le limitazioni.
VALUE_REQUIRED Non è stato fornito un valore obbligatorio per fieldPath.
NAME_INVALID Il nome fornito non era valido. Consulta le limitazioni.
NAME_RESERVED Il nome fornito era uno dei nomi riservati. Consulta i nomi riservati.
VALUE_OUT_OF_BOUNDS Il valore fornito era troppo grande. Consulta le limitazioni.
EXCEEDED_MAX_ENTITIES La richiesta contiene troppi parametri. Consulta le limitazioni.
NAME_DUPLICATED Lo stesso nome è stato fornito più di una volta nella richiesta.