疑難排解

本指南列出常見的疑難排解步驟,協助修正常見的導入錯誤。

沒有活動

如果 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

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_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,而非容器。