本指南列出常見的疑難排解步驟,協助修正常見的導入錯誤。
沒有活動
如果 Google Analytics 未顯示事件,請檢查幾個常見問題。
請先選擇用戶端:
您使用的 api_secret 是否正確?
確認你使用的是正確的
api_secret串流。如果您為多個串流設定評估通訊協定,每個串流都會有自己的密鑰。您的 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。
使用的
firebase_app_id是否正確?請務必使用 Firebase 應用程式的 ID。這個值位於 Firebase 控制台的「專案設定」>「一般」>「您的應用程式」>「應用程式 ID」。
firebase_app_id與app_instance_id不同。使用的
app_instance_id是否正確?請務必使用 Firebase 應用程式安裝專屬的 ID。這個值必須透過 Google Analytics for Firebase SDK 擷取。
- Android - getAppInstanceId()
- Kotlin - getAppInstanceId()
- Swift - appInstanceID()
- Objective-C - appInstanceID
- C++ - GetAnalyticsInstanceId()
- Unity - GetAnalyticsInstanceIdAsync()
app_instance_id與firebase_app_id不同。
ID 無效
由於 Measurement Protocol 支援 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 應用程式的專屬 ID。應用程式的所有使用者都會有相同的firebase_app_id。位於 Firebase 控制台的以下位置:
「專案設定」 >「一般」 >「您的應用程式」 >「應用程式 ID」app_instance_id- 在要求的 POST 內文中加入這個 ID。這個 ID 可做為 Firebase 應用程式特定安裝作業的專屬 ID。應用程式的每次安裝作業都會有不同的值。如要為每個 Firebase 平台要求這個值,請使用下列方法:
請勿使用下列項目:
firebase_instance_id- 您的要求不應包含這個 ID。 這個 ID 用於識別特定應用程式執行個體,但僅適用於 Firebase。這項服務可用於 FCM 訊息等工作。
gtag.js
如果您使用 gtag.js,應該使用的 ID 如下:
measurement_id- 在要求的查詢參數中加入這個 ID。這個 ID 可明確識別資料串流。網站的所有使用者都會有相同的measurement_id。可前往 Google Analytics 使用者介面的以下位置查看:
管理 > 資料串流 > 選擇所需串流 > 評估 IDclient_id- 在要求的 POST 內文中加入這個 ID。這個 ID 可不重複地識別網頁用戶端的特定使用者執行個體。這個值會因應用程式使用者而異。如要瞭解如何擷取這個值,請參閱這些範例。
缺少伺服器端代碼事件
安裝伺服器端代碼管理工具並搭配使用 Measurement Protocol 用戶端,即可將 Measurement Protocol 格式的事件傳送至容器。然後,容器會使用與所有其他 SGTM 事件相同的機制,將這些事件傳送至 Google Analytics。
如要使用 Measurement Protocol 的所有功能,請直接將事件傳送至 Measurement Protocol,而非容器。