В этом документе описывается, как проверять попадания в протокол измерений Google Analytics.
Обзор
Протокол измерений Google Analytics не возвращает коды ошибок HTTP, даже если обращение протокола измерений имеет неверный формат или отсутствуют обязательные параметры. Чтобы убедиться, что ваши обращения имеют правильный формат и содержат все необходимые параметры, вы можете протестировать их на сервере проверки перед развертыванием в рабочей среде.
В этом руководстве описывается процесс отправки обращений на сервер проверки протокола измерений и объясняется, как интерпретировать ответ.
Отправка обращений на проверку
Обращения могут быть отправлены на сервер проверки протокола измерений любым методом, который в настоящее время поддерживается протоколом измерений. Единственная разница — это URL-адрес. Чтобы отправить попадания на сервер проверки протокола измерений, используйте конечную точку /debug/collect
вместо /collect
. В следующем примере показано недопустимое попадание, отправленное на сервер проверки протокола измерения:
https://www.google-analytics.com/debug/collect?tid=fake&v=1
Дополнительные сведения о том, как создать попадание в протокол измерения, см. в справочнике по протоколу .
Интерпретация ответа
Ответы от сервера проверки протокола измерений будут в формате 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 | Возможные значения: «ИНФОРМАЦИЯ», «ПРЕДУПРЕЖДЕНИЕ» и «ОШИБКА». |
parserMessage.description | string | Дополнительные сведения или действия по устранению проблемы с проверкой. |
parserMessage.parameter | string|undefined | Параметр (если применимо), вызывающий проблему проверки. |