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 天 >= 要求時間減去兩個工作天，且 <= 要求時間
傳送事件或使用者屬性，用於建立目標對象 非必要 網站：<= 最新線上活動時間 + 30 天
應用程式：<= 最新線上活動時間 + 42 天		 >= 要求時間減去兩個工作天，且 <= 要求時間

將 User-ID 指派給事件

使用 Measurement Protocol 為線上或離線事件提供使用者 ID。

以下是將 User-ID 新增至事件的範例用途：

  1. 您的線上評估缺少查詢線上事件 User-ID 所需的資訊，但您有事件處理管道，可建立線上工作階段與 User-ID 之間的關聯。

    在這種情況下，您會使用 Measurement Protocol 提供含有 User-ID 的線上事件。

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

    在這種情況下，您會使用線上事件，透過使用者 ID 提供 Measurement Protocol 事件。

如要將 User-ID 新增至事件，請務必符合下列條件：

  • 在事件的參數清單中加入 session_id。
  • 在同一天傳送 Measurement Protocol 事件，也就是線上工作階段發生的當天。
  • 如果覆寫 timestamp_micros，請將其設為線上工作階段開始和結束時間之間的時間戳記。
  • 如要為線上活動提供 User-ID，請在要求中設定 user_id。
  • 如果您的目標是讓每個 Measurement Protocol 事件都具有對應線上工作階段的 User-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 日，請最晚在 5 月 3 日當天結束前，傳送 Measurement Protocol 事件。

  • 如果覆寫 timestamp_micros，請將其設為過去三個工作天內的任何時間戳記。

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

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

如要傳送事件或使用者屬性，用於建立目標對象，請務必符合下列條件：

  • 最晚須在同一個 client_id的最新線上活動結束後 30 天內，將要求傳送至網站資料串流。

    舉例來說，如果 client_id 的最新線上事件發生於 3 月 1 日，請在 3 月 31 日的營業日結束前，傳送 Measurement Protocol 事件。

  • 請在最新線上事件發生後的 42 天內，將要求傳送至應用程式串流，且不得晚於當天工作時間結束。app_instance_id

    舉例來說，如果 app_instance_id 的最新線上事件發生在 3 月 1 日，請在 4 月 12 日當天結束前傳送 Measurement Protocol 事件。

  • 如果覆寫 timestamp_micros，請將其設為過去 3 個工作天內的時間戳記。