Validación de hits: Protocolo de medición

En este documento, se describe cómo validar los hits del Protocolo de medición de Google Analytics.

Descripción general

El Protocolo de medición de Google Analytics no muestra códigos de error de HTTP, incluso si un hit tiene un formato incorrecto o faltan parámetros obligatorios. Para asegurarte de que tus hits tengan el formato correcto y contengan todos los parámetros obligatorios, puedes probarlos en el servidor de validación antes de implementarlos en producción.

En esta guía, se describe el proceso para enviar hits al servidor de validación del Protocolo de medición y se explica cómo interpretar la respuesta.

Envío de hits para la validación

Los hits se pueden enviar al servidor de validación del Protocolo de medición a través de cualquier método que este admita actualmente. La única diferencia es la URL. Para enviar hits al servidor de validación del Protocolo de medición, usa el extremo /debug/collect en lugar de /collect. En el siguiente ejemplo, se muestra un hit no válido enviado al servidor de validación del Protocolo de medición:

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

Para obtener más detalles sobre cómo crear un hit del Protocolo de medición, consulta la referencia del protocolo.

Interpretación de la respuesta

Las respuestas del servidor de validación del Protocolo de medición estarán en formato JSON. En el siguiente ejemplo, se muestra la respuesta para el hit que se mostró anteriormente:

{
  "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 raíz de respuesta, hitParsingResult, es un array cuya longitud corresponderá a la cantidad de hits enviados en la solicitud original. Cada objeto del array contendrá las claves valid, hit y parserMessage. Si un hit no es válido, parserMessage contendrá un array de objetos que describen los problemas de validación. Si un hit es válido, parserMessage será un array vacío.

En la siguiente tabla, se describen las propiedades de cada elemento del array hitParsingResult:

Clave	Tipo	Descripción
`valid`	`Boolean`	`true` para hits válidos, `false` para hits no válidos.
`hit`	`string`	Es una string que contiene la ruta de la solicitud, así como su método y protocolo.
`parserMessage`	`Array`	Una lista de mensajes del analizador. Si el hit es válido, este array estará vacío.
`parserMessage.messageType`	`string`	Los valores posibles son “INFO”, “WARN” y “ERROR”.
`parserMessage.description`	`string`	Detalles o pasos adicionales para corregir el problema de validación.
`parserMessage.parameter`	`string\|undefined`	Indica el parámetro (si corresponde) que causa el problema de validación.