Tag Assistant 意见征求模式调试

本文面向使用 Google 意见征求模式的网站开发者和管理员(无论是直接使用,还是通过意见征求管理解决方案使用),旨在帮助他们确保意见征求模式正常工作。借助 Tag Assistant,您可以了解使用以下任何一项时用户意见征求状态是否以及如何设置和更新:

Tag Assistant 是一款 Web 应用,具有可选但建议使用的浏览器扩展程序 Tag Assistant Companion。借助 Tag Assistant,您可以检查:

  • 是否在任何代码触发之前,针对适用的用户意见征求类型(例如 ad_storageanalytics_storage)设置了正确的默认用户意见征求状态。适当的默认用户意见征求状态取决于您所在组织的政策。
  • 当访问者表示同意或拒绝同意时,用户意见征求状态是否会正确更新。
  • 每个代码检查的用户意见征求类型。
  • 在每个代码触发时必要的用户意见征求类型是否处于“已授予”状态,以及代码是否通过了任何其他必要的用户意见检查。

要调试用户意见征求配置,请启动 Tag Assistant,使用它打开您网站上的一个网页,并模拟访问者的行为。完成所有可能的访问者用例,单独测试每个用例。例如,全部拒绝同意、全部表示同意以及尝试所有可能的组合。您可能还需要在网页上执行其他操作,以触发包含用户意见检查的所有代码。每次测试后,都切换到 Tag Assistant 窗口。

Tag Assistant 的左侧窗格会显示页面事件,最新的事件显示在最上方。导航方式如下:

  • 选择一个事件,可查看当时的用户意见征求状态和配置。
  • 选择用户意见征求标签页,可查看存储类型的用户意见征求状态。
  • 选择代码标签页(仅限 GTM 容器),可查看代码何时触发以及何时被用户意见征求状态屏蔽。

以下示例展示了对网页进行测试后的 Tag Assistant 窗口。在选择用户意见征求事件的情况下,用户意见征求标签页会显示当前时间点 ad_storageanalytics_storage事件的用户意见征求状态事件的用户意见征求配置状态表格显示在每个事件发生时是否存在用户意见征求“default”和“update”命令。这可用于验证当访问者表示同意或拒绝同意时,用户意见征求状态是否会正确更新。

事件的用户意见征求状态

用户意见征求状态更新后,默认更新的状态会显示为已检测到

更新后的用户意见征求状态

TCF 示例

以下屏幕显示了一条消息:已启用 TCF 兼容。在使用 TCF 设置用户意见征求状态时,这条消息会显示在事件的用户意见征求配置状态表格下方:

已启用 TCF 兼容

如果 Tag Assistant 检测到实现错误,也会在事件的用户意见征求配置状态表格下方显示消息:

TCF 错误

Tag Assistant 会报告用户意见征求配置在排序和时间安排方面的最常见问题:

如果网页上未实现意见征求模式,Tag Assistant 中的用户意见征求标签页将为空。

默认用户意见征求状态在网页上的设置时间应早于任何代码段或其他代码尝试使用或更新同意情况的时间。过晚设置默认用户意见征求状态可能不会产生预期效果。

例如,在以下情形中,广告代码在默认用户意见征求状态设置之前,已读取或写入 Cookie:

  1. 访问者打开网页
  2. 广告代码触发
  3. 默认用户意见征求状态设置为“拒绝”

Tag Assistant 会报告错误:

Tag Assistant 错误

要解决此问题,请根据具体情况执行相应操作:

  • 使用在网页上进行硬编码的 gtag 用户意见征求命令来设置默认用户意见征求状态:将调用 gtag 用户意见征求命令的所有代码移至网页中的靠前位置,放置在可能会使用同意情况的任何代码段或其他代码上方。避免异步设置默认用户意见征求状态。
  • 使用 Google 跟踪代码管理器:如果使用模板代码设置默认用户意见征求状态,请确保用户意见征求撰写模板代码针对用户意见征求初始化触发器进行触发,并且依赖于用户意见征求状态的所有其他代码都针对用户意见征求初始化之后的触发器进行触发。如果您使用 GTM 中的自定义 HTML 标记调用 gtag 用户意见征求命令,应改为采用使用自定义模板 API 的模板代码来设置用户意见征求状态。