验证事件

选择平台:

Google Analytics Measurement Protocol 不会返回 HTTP 错误代码,即使事件的格式不正确或缺少必填项 参数。为确保事件有效,您应先通过 Measurement Protocol 验证服务器对其进行测试,然后再将其部署到正式版。在经过验证,确认事件结构正确无误后,您应验证实现,以确保使用的密钥正确无误。

您可以直接调用验证服务器,也可以使用 Google Analytics Event Builder。利用 Google Analytics Event Builder,您可以 构建事件,并使用 Measurement Protocol 验证服务器 验证它们。

本指南介绍了如何将事件发送到适用于 Google Analytics 4 的 Measurement Protocol 验证服务器以及如何解读响应。

发送事件以进行验证

对于发送到 Measurement Protocol 的事件和发送到 Measurement Protocol 验证服务器的事件,两者在请求方面的唯一区别是网址。

服务器 网址
Measurement Protocol /mp/collect
Measurement Protocol 验证服务器 /debug/mp/collect

所有其他请求字段都相同。如需全面了解如何构建有效请求,请参阅 Protocol 参考。

以下代码显示的是发送到 Measurement Protocol 验证服务器的无效事件:

验证响应

以下是验证服务器对上述事件的响应:

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

响应

类型 说明
validationMessages Array<ValidationMessage> 验证消息的数组。

ValidationMessage

类型 说明
fieldPath 字符串 无效字段的路径。
description 字符串 对错误的说明。
validationCode ValidationCode 与错误相对应的 ValidationCode。

ValidationCode

说明
VALUE_INVALID fieldPath 提供的值无效。请参阅限制
VALUE_REQUIRED 没有为 fieldPath 提供必需值。
NAME_INVALID 提供的名称无效。请参阅限制
NAME_RESERVED 提供的名称是预留名称之一。请参阅预留名称
VALUE_OUT_OF_BOUNDS 提供的值过大。请参阅限制
EXCEEDED_MAX_ENTITIES 请求中的参数过多。请参阅限制
NAME_DUPLICATED 同一名称在请求中多次提供。