疑難排解

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

沒有活動

如果事件未顯示在 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 可唯一識別網頁用戶端的特定使用者例項。這個值會因應用程式的每位使用者而異。如要瞭解如何擷取這個值，請參閱這些範例。

缺少伺服器端代碼事件

使用 Measurement Protocol 用戶端的伺服器端代碼管理工具安裝程序可讓您以 Measurement Protocol 格式傳送事件至容器。接著，容器會使用與所有其他 SGTM 事件相同的機制，將這些事件傳送至 Google Analytics。

如果您想使用 Measurement Protocol 的所有功能，請直接將事件傳送至 Measurement Protocol，而非容器。