Проверка обращений: Measurement Protocol

В этом документе описывается проверка обращений протокола передачи статистических данных Google Analytics Measurement Protocol.

Обзор

Google Analytics Measurement Protocol не возвращает кодов ошибок HTTP, даже если обращение содержит ошибки или в нем отсутствуют необходимые параметры. Чтобы убедиться, что обращения имеют правильный формат и содержат все нужные параметры, проверьте их с помощью сервера валидации перед использованием.

В этом руководстве описан процесс отправки обращений на сервер валидации и интерпретация полученных ответов.

Отправка обращений на проверку

Обращения можно отправить на сервер валидации с помощью любого метода, который в настоящее время поддерживается Measurement Protocol. Нужно только заменить URL. Для отправки обращений на проверку в конце URL должно быть /debug/collect вместо /collect. Следующий пример демонстрирует неверное обращение, отправленное на сервер валидации Measurement Protocol:

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

Узнать больше о составлении обращений можно в руководстве по протоколу.

Интерпретация ответов

Сервер валидации Measurement Protocol возвращает ответы в формате JSON. Следующий пример представляет собой ответ на обращение выше:

{
  "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"
        }
      ]
    }
  ]
}

Корень ответа, hitParsingResult, представляет собой массив, длина которого соответствует количеству обращений, отправленных в исходном запросе. Каждый объект в массиве будет содержать ключи valid, hit и parserMessage. Если обращение неверно, parserMessage будет содержать массив объектов, описывающих неполадки. Если обращение верно, parserMessage будет пустым массивом.

В таблице ниже описаны свойства каждого элемента в массиве hitParsingResult.

Ключ Тип Описание
valid Boolean true для верных обращений, false – для неверных.
hit string Строка, содержащая путь к запросу, а также метод и протокол.
parserMessage Array Список сообщений синтаксического анализатора. Если обращение верно, массив будет пустым.
parserMessage.messageType string Допустимые значения: INFO, WARN и ERROR.
parserMessage.description string Дополнительные сведения или инструкции по устранению неполадок.
parserMessage.parameter string|undefined Параметр, вызвавший ошибку при проверке (если есть).