问题排查

本指南概述了修正常见实现错误时常用的问题排查步骤。

没有事件

如果您的事件未显示在 Google Analytics(分析)中,则应注意以下一些常见问题。

首先,选择您的客户:

  • 您使用的 api_secret 是否正确?

    请检查您使用的是否是正确数据流的 api_secret。如果您为多个数据流设置 Measurement Protocol,则每个数据流都将有自己的密钥。

  • 您的 api_secret 是否仍有效?

    为了帮助打击垃圾内容,您可以撤消 api_secret。请确保您使用的 api_secret 仍然有效。有权访问您的数据流的其他用户可能不小心撤消了对其的访问权限。

  • 您的 api_secret 是否复制正确?

    api_secret 区分大小写。仔细检查 Google Analytics(分析)界面中的 api_secret 是否与在代码中使用的完全相同。

  • 不要使用 advertising_id

    不支持将“advertising_id”用作有效的设备标识符。如果您使用的是 Firebase,请使用 app_instance_id;如果您使用的是 gtag.js,请使用 client_id

ID 无效

由于 Measurement Procotol 支持来自 Google Analytics for Firebase SDK 和 gtag.js 的 ID,因此请确保使用正确的 ID。您应该使用的 ID 取决于您使用的是 Google Analytics for Firebase SDK 还是 gtag.js。下文简要介绍了您应该使用哪些 ID:

Google Analytics for Firebase SDK

如果您使用的是 Google Analytics for Firebase SDK,则应该使用以下 ID:

您不应使用以下 ID:

  • firebase_instance_id - 不应将此 ID 添加到请求中。此 ID 用于标识应用的指定实例,但仅适用于 Firebase。它用于 FCM 消息等任务。

gtag.js

如果您使用的是 gtag.js,则您应该使用的 ID 如下所示:

  • measurement_id - 可将此 ID 添加到请求的查询参数中。此 ID 可唯一标识数据流。您网站的所有用户都具有相同的 measurement_id。此值可在 Google Analytics(分析)界面中的以下位置下找到:
    管理 > 数据流 > 选择您的数据流 > 衡量 ID
  • client_id - 可将此 ID 添加到请求的 POST 正文中。此 ID 可唯一标识 Web 客户端的指定用户实例。此值会因应用的每个用户而异。如需了解如何检索此值,请参阅这些示例