疑難排解

本指南將概述常見的疑難排解步驟，協助您修正常見的實作錯誤。

沒有活動

如果您的事件沒有顯示在 Google Analytics (分析) 中，請留意以下幾個常見問題。

請先選擇您的客戶：

Firebase gtag.js

• 您使用的 api_secret 是否正確？

  請檢查你用於正確串流的 api_secret。如果為多個串流設定 Measurement Protocol，每個串流都會有自己的密鑰。

• 您的 api_secret 是否仍然有效？

  您可以選擇撤銷 api_secret，協助防範垃圾內容。確認您使用的 api_secret 仍然有效。有權存取您串流的其他使用者可能已因誤判而撤銷存取權。

• 是否已正確複製 api_secret？

  api_secret 區分大小寫。仔細確認 Google Analytics (分析) 使用者介面中的 api_secret 與您在程式碼中使用 完全相同。

• 不要使用 advertising_id，

  「advertising_id」並非有效的裝置 ID。如果您使用 Firebase ，請使用 app_instance_id；如果您使用 gtag.js，請使用 client_id。

ID 無效

由於 Measurement Procotol 支援來自 Google Analytics for Firebase SDK 和 gtag.js 的 ID，請務必使用正確的 ID。視您使用的是 Google Analytics for Firebase SDK 還是 gtag.js 而定，應使用的 ID 會有所不同。以下簡單說明您應該使用哪些 ID：

Google Analytics for Firebase SDK

如果您使用 Google Analytics for Firebase SDK，應使用下列 ID：

• firebase_app_id：在要求的查詢參數中加入這個 ID。這組 ID 可明確識別您的 Firebase 應用程式。應用程式的所有使用者都會有相同的 firebase_app_id。在 Firebase 控制台的下方，依序點選「Project Settings」 >「General」 >「Your Apps」 >「App 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 是用來識別資料串流的專屬 ID。您網站的所有使用者都會使用相同的 measurement_id。在 Google Analytics (分析) UI 中，位於
  「管理」 >「資料串流」 >「選擇串流」 >「評估 ID」
• client_id：在要求的 POST 主體中加入這個 ID。這個 ID 是用來識別網路用戶端的指定使用者執行個體。每位應用程式使用者的這個值都不同。如要瞭解如何擷取這個值，請參閱這些範例。