疑難排解

本指南將概述常見的疑難排解步驟，以修正常見的導入錯誤。

沒有活動

如果事件未顯示在 Google Analytics 中，請檢查幾個常見問題。

首先選擇客戶：

• 您是否使用正確的 api_secret？

  請確認您使用 api_secret 的串流正確無誤。如果您為多個串流設定評估通訊協定，每個串流都會有專屬的密鑰。

• 你的 api_secret 是否仍有效？

  為了對抗垃圾內容，您可以撤銷 api_secret。請確保您使用的 api_secret 仍然有效。有時具有串流存取權的其他使用者可能已因誤判而撤銷了您串流的存取權。

• 是否正確複製 api_secret？

  api_secret 須區分大小寫。請仔細檢查 Google Analytics UI 中的 api_secret 是否「完全」與程式碼中使用的 api_secret 相同。

• 請勿使用 advertising_id。

  系統不支援使用 advertising_id 做為有效的裝置 ID。如果使用 Firebase，請使用 app_instance_id；如果使用 gtag.js，請使用 client_id。

ID 無效

由於評估通訊協定支援 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 如下：

• firebase_app_id：在要求的查詢參數中加入此 ID。這個 ID 可明確識別您的 Firebase 應用程式。您應用程式的所有使用者都會有相同的 firebase_app_id。在 Firebase 控制台的以下位置：
  專案設定 > 一般 > 您的應用程式 > 應用程式 ID

• app_instance_id：在要求的 POST 主體中加入這個 ID。這個 ID 會明確識別特定 Firebase 應用程式安裝作業。每個應用程式安裝作業的這個值都會不同。針對各 Firebase 平台要求這個值的方法如下：

  • Android - getAppInstanceId()
  • Kotlin - getAppInstanceId()
  • Swift - appInstanceID()
  • Objective-C - appInstanceID
  • C++ - GetAnalyticsInstanceId()
  • Unity - GetAnalyticsInstanceIdAsync()

請不使用以下內容：

• firebase_instance_id - 這項 ID「不應」包含在要求中。這個 ID 可用來識別應用程式的特定例項，但僅適用於 Firebase。這項權限用於 FCM 訊息等工作。

gtag.js

如果您使用 gtag.js，應使用的 ID 如下：

• measurement_id：在要求的查詢參數中加入此 ID。這個 ID 可用於唯一識別資料串流。您的網站所有使用者都會擁有相同的 measurement_id。在 Google Analytics 使用者介面中，依序點選下列項目：
  「管理」 >「資料串流」 >「選擇所需串流」 >「評估 ID」
• client_id：在要求的 POST 主體中加入這個 ID。這個 ID 可用於識別網路用戶端的特定使用者執行個體。這個值會因應用程式的每位使用者而異。如要瞭解如何擷取這個值，請參閱這些範例。