Validar 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 devuelve códigos de error HTTP, incluso si un hit de dicho protocolo tiene un formato incorrecto o faltan los parámetros obligatorios. Para garantizar que los hits tienen un formato correcto y contienen todos los parámetros necesarios, puedes probarla con 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.

Enviar hits para la validación

Los hits se pueden enviar al servidor de validación del protocolo de medición mediante cualquier método que admita actualmente el protocolo de medición. La única diferencia está en la URL. Para enviar hits al servidor de validación del protocolo de medición utiliza el extremo /debug/collect en vez de /collect. En el siguiente ejemplo se muestra un hit no válido que se ha 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 construir un hit del protocolo de medición, consulta la referencia del protocolo.

Interpretar la respuesta

Las respuestas del servidor de validación del protocolo de medición tienen formato JSON. En el siguiente ejemplos se presenta la respuesta del hit mostrado más arriba:

{
  "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 la respuesta, hitParsingResult, es una matriz cuya longitud corresponde al número de hits que se han enviado a la solicitud original. Cada objeto de la matriz contendrá las claves valid, hit y parserMessage. Si un hit no es válido, parserMessage contendrá una matriz de objetos que describen los problemas de validación. Si un hit es válido, parserMessage será una matriz vacía.

En la siguiente tabla se describen las propiedades de cada elemento de la matriz hitParsingResult:

Clave Tipo Descripción
valid Boolean true para los hits válidos y false para los que no son válidos.
hit string Cadena que contiene la ruta de la solicitud, así como su método y protocolo.
parserMessage Array Lista de mensajes del analizador. Si el hit es válido, la matriz estará vacía.
parserMessage.messageType string Los valores posibles son: "INFO", "WARN" y "ERROR".
parserMessage.description string Información o pasos adicionales para corregir el problema de validación.
parserMessage.parameter string|undefined Parámetro (si corresponde) que provoca el problema de validación.