本文档介绍了如何验证 Google Analytics(分析)Measurement Protocol 匹配。
概览
即使 Measurement Protocol 匹配格式错误或缺少必需参数,Google Analytics(分析)Measurement Protocol 也不会返回 HTTP 错误代码。为确保您的匹配格式正确并包含所有必需参数,在将其部署到正式版之前可以通过验证服务器进行测试。
本指南介绍了向 Measurement Protocol 验证服务器发送匹配的流程并说明了如何解读响应。
发送匹配以进行验证
可以通过 Measurement Protocol 当前支持的任何方法将匹配发送到 Measurement Protocol 验证服务器。唯一的区别是网址。要将匹配发送到 Measurement Protocol 验证服务器,请使用端点 /debug/collect
而不是 /collect
。以下示例显示的是发送到 Measurement Protocol 验证服务器的无效匹配:
https://www.google-analytics.com/debug/collect?tid=fake&v=1
有关如何构建 Measurement Protocol 匹配的更多详情,请参阅协议参考。
解读响应
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 |
导致验证问题的参数(如果有)。 |