В этом документе описывается проверка обращений протокола передачи статистических данных 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 |
Параметр, вызвавший ошибку при проверке (если есть). |