Convalida degli eventi

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:

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.