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

將 User-ID 指派給事件

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

以下列舉幾個在事件中加入 User-ID 的應用實例：

  1. 您的線上評估缺少必要資訊，無法查詢線上事件的使用者 ID，但您有事件處理管道，可建立線上工作階段與使用者 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，請將其設為過去 72 小時內的時間戳記。

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

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

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

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

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

  • 請在相同 app_instance_id 的最新線上活動結束後 42 天內，將要求傳送至應用程式串流。

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

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