Measurement Protocol 用途

除了透過標記或 Firebase SDK 收集的資料外，Google Analytics 評估規則還可讓您將離線資料傳送至網頁或應用程式串流。

本指南說明 Google Analytics Measurement Protocol 的常見用途及其相關需求。

規定摘要

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

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

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

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

將 User-ID 指派給事件

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

以下是一些範例用途，說明如何在事件中加入 User-ID：

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

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

  2. 您沒有透過評估資料協定傳送事件的 User-ID，但如果使用者在工作階段期間登入線上，您希望這些事件與 User-ID 建立關聯。

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

以下是將 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 事件。

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

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

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