Convalida degli hit - Measurement Protocol

Questo documento descrive come convalidare gli hit di Measurement Protocol di Google Analytics.

Panoramica

Measurement Protocol di Google Analytics non restituisce codici di errore HTTP, anche se un hit di Measurement Protocol non è valido o mancano parametri obbligatori. Per assicurarti che gli hit siano formattati correttamente e contengano tutti i parametri richiesti, puoi testarli con il server di convalida prima di eseguirne il deployment in produzione.

Questa guida descrive il processo per inviare hit al server di convalida del protocollo di misurazione e spiega come interpretare la risposta.

Invio degli hit per la convalida

Gli hit possono essere inviati al server di convalida di Measurement Protocol tramite qualsiasi metodo attualmente supportato da Measurement Protocol. L'unica differenza è l'URL. Per inviare hit al server di convalida di Measurement Protocol utilizza l'endpoint /debug/collect anziché /collect. L'esempio seguente mostra un hit non valido inviato a Measurement Protocol Validation Server:

https://www.google-analytics.com/debug/collect?tid=fake&v=1

Per ulteriori dettagli sulla creazione di un hit di Measurement Protocol, consulta la documentazione di riferimento sul protocollo.

Interpretazione della risposta

Le risposte del server di convalida del protocollo di misurazione saranno in formato JSON. L'esempio seguente mostra la risposta all'hit sopra indicato:

{
  "hitParsingResult": [
    {
      "valid": false,
      "hit": "GET /debug/collect?tid=fake\u0026v=1 HTTP/1.1",
      "parserMessage": [
        {
          "messageType": "ERROR",
          "description": "The value provided for parameter 'tid' is invalid. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        },
        {
          "messageType": "ERROR",
          "description": "Tracking Id is a required field for this hit. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        }
      ]
    }
  ]
}

La radice della risposta, hitParsingResult, è un array la cui lunghezza corrisponderà al numero di hit inviati nella richiesta originale. Ogni oggetto dell'array conterrà le chiavi valid, hit e parserMessage. Se un hit non è valido, parserMessage conterrà un array di oggetti che descrivono i problemi di convalida. Se un hit è valido, parserMessage sarà un array vuoto.

La seguente tabella descrive le proprietà di ogni elemento nell'array hitParsingResult:

Chiave	Tipo	Descrizione
`valid`	`Boolean`	`true` per gli hit validi, `false` per gli hit non validi.
`hit`	`string`	Una stringa contenente il percorso della richiesta, nonché il relativo metodo e protocollo.
`parserMessage`	`Array`	Un elenco di messaggi del parser. Se l'hit è valido, questo array sarà vuoto.
`parserMessage.messageType`	`string`	I valori possibili sono "INFO", "WARN" e "ERROR".
`parserMessage.description`	`string`	Ulteriori dettagli o passaggi per risolvere il problema di convalida.
`parserMessage.parameter`	`string\|undefined`	Il parametro (se applicabile) che causa il problema di convalida.