验证匹配 - Measurement Protocol

本文档介绍了如何验证 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 是一个数组,其长度对应于原始请求中发送的匹配数。数组中的每个对象将包含密钥 validhitparserMessage。如果匹配无效,parserMessage 将包含描述验证问题的对象的数组。如果匹配有效,parserMessage 将是一个空数组。

下表介绍了 hitParsingResult 数组中每个项目的属性:

类型 说明
valid Boolean 有效匹配为 true,无效匹配为 false
hit string 包含请求路径及其方法和协议的字符串。
parserMessage Array 解析器消息列表。如果匹配有效,则此数组为空。
parserMessage.messageType string 可能的值是“INFO”、“WARN”和“ERROR”。
parserMessage.description string 解决验证问题的其他详细信息或步骤。
parserMessage.parameter string|undefined 导致验证问题的参数(如果有)。