Measurement Protocol 用途

除了透過代碼或 Firebase SDK 收集的資料外，您也可以使用 Google Analytics Measurement Protocol，將離線資料傳送至網站或應用程式串流。

本指南說明 Google Analytics Measurement Protocol 的常見用途和相關規定。

規定摘要

下方一覽表列出各種用途需求，方便您對照參考。請注意下列最佳做法：

  1. 事件和使用者屬性的 timestamp_micros 預設為要求時間。如果傳送發生於過去時間的事件或使用者屬性變更，則會覆寫傳送事件指南和使用者屬性指南中所述的時間戳記。

  2. 為確保獲得準確的即時報表和參與度指標，請加入 engagement_time_msec 事件參數，並設為前述事件後經歷的毫秒數。

用途 工作階段 ID 要求時間的需求條件 timestamp_micros 需求條件
將 User-ID 指派給事件 必填 <= 工作階段開始工作天的結束時間 >= 工作階段開始和 <= 工作階段結束
工作階段歸因 必填 <= 工作階段開始 + 24 小時 >= 工作階段開始和 <= 工作階段結束
將事件匯入廣告平台 非必要 <= 最後一個工作階段日期 + 63 天 >= 要求時間減去 72 小時，且 <= 要求時間
傳送事件或使用者屬性，用於建立目標對象 Not required 網站：<= 最新線上事件的時間 + 30 天
應用程式：<= 最新線上事件的時間 + 42 天		 >= 要求時間減去 72 小時，且 <= 要求時間

將 User-ID 指派給事件

使用 Measurement Protocol 提供線上或離線事件，並附上使用者 ID。

以下舉例說明在事件中加入 User-ID 的用途：

  1. 線上評估功能缺少查詢線上事件 User-ID 所需的資訊，但您有事件處理管道，可連結線上工作階段和 User-ID。

    在這個情境中，您會使用 Measurement Protocol 提供線上事件和 User-ID。

  2. 您沒有透過 Measurement Protocol 傳送的事件 User-ID，但希望在使用者於工作階段期間登入線上帳戶時，將這些事件與 User-ID 建立關聯。

    在這個情境中，您會使用線上事件，為 Measurement Protocol 事件提供 User-ID。

在事件中加入 User-ID 的規定如下：

  • 在事件的參數清單中加入 session_id。
  • 在線上工作階段的同一工作天傳送 Measurement Protocol 事件。
  • 如果覆寫 timestamp_micros，請將其設為線上工作階段開始和結束時間之間的時間戳記。
  • 如果您的目標是為線上事件提供 User-ID，請在要求中設定 user_id。
  • 如果您的目標是讓每個 Measurement Protocol 事件都具有對應線上工作階段的使用者 ID，則不需要設定 user_id。

工作階段歸因

符合特定規定的 Measurement Protocol 事件，會與同一工作階段的線上事件，一併顯示在報表中，且兩者具有相同的工作階段屬性 (例如地理資訊、來源、媒介和廣告活動)。

工作階段屬性的需求條件如下：

  • 在事件的參數清單中加入 session_id。

  • 請在線上工作階段開始後 24 小時內傳送要求。

    舉例來說，如果工作階段在資源時區的週一上午 11:15 開始，請在週二上午 11:15 前傳送要求。

  • 如果覆寫 timestamp_micros，請將其設為線上工作階段開始和結束時間之間的時間戳記。

將事件匯入廣告平台

Google Analytics 會將您使用 Measurement Protocol 傳送的事件，一併匯出至連結的廣告產品，例如 Google Ads 或 Campaign Manager 360。

以下是幾個常見的實用情境：

  • 貴商家有離線事件，您希望將這些事件納入廣告歸因和報表。
  • 您在不支援代碼或 Firebase SDK 的系統中還有其他事件，但仍想將這些事件納入已連結的產品。

將事件匯出至廣告平台時，須符合下列規定：

  • 即使重要事件的歸因期超過 63 天，也請在最新線上事件發生後 63 天內傳送要求。此外，事件也必須在重要事件的歸屬期內發生。瞭解如何調整歸屬期設定。

    舉例來說，如果 client_id 或 app_instance_id 的最新線上事件發生在 3 月 1 日，則 Measurement Protocol 事件最晚應在 5 月 3 日傳送。

  • 如要覆寫 timestamp_micros，請將其設為過去 72 小時內的時間戳記。

傳送事件或使用者屬性，用於建立目標對象

只要符合幾項規定，系統就會將使用 Measurement Protocol 傳送的事件和使用者屬性，納入目標對象條件評估。

以下是傳送事件或使用者屬性，用於建立目標對象的規定：

  • 在同一 client_id 的最新線上事件發生後 30 天內，將要求傳送至網站串流。

    舉例來說，如果 client_id 的最新線上事件發生在 3 月 1 日，則 Measurement Protocol 事件最晚應於 3 月 31 日傳送。

  • 在同一個 app_instance_id 的最新線上事件發生後 42 天內，將要求傳送至應用程式串流。

    舉例來說，如果 app_instance_id 的最新線上事件發生在 3 月 1 日，則 Measurement Protocol 事件最晚應於 4 月 12 日傳送。

  • 如要覆寫 timestamp_micros，請將其設為過去 72 小時內的時間戳記。