Measurement Protocol 用途

Google Analytics Measurement Protocol 能讓您將離線資料傳送到網站或應用程式串流 以及已使用代碼或 Firebase SDK 收集的資料。

本指南將說明 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. 您的線上成效評估結果缺少查詢 線上事件的 User-ID，但事件處理管道 即可連結線上工作階段和 User-ID。

    在這個情境中，您必須使用 Measurement Protocol 提供 線上事件。

  2. 若是透過 但最好將這些事件與 如果使用者在整個工作階段期間在線上登入，則為 User-ID。

    在這個情境中，您要利用線上活動來提供 含有 User-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 日，請傳送 Measurement Protocol 活動最晚必須在 5 月 3 日工作天結束。

  • 如果覆寫 timestamp_micros，請將其設為小於或等於的時間戳記 傳送至要求時間

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

使用 Measurement Protocol 傳送的事件和使用者屬性都包含在 評估目標對象條件的廣告成效 (如果符合一些規定)。

傳送事件或使用者屬性的相關規定如下 建立：

  • 最晚應在工作天結束前將要求傳送至網站串流 購買相同client_id的最新線上活動後 30 天。

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

  • 最晚應在工作天結束前將要求傳送至應用程式串流 購買相同app_instance_id的最新線上活動後 42 天。

    舉例來說，如果app_instance_id的最新線上活動發生了， 請在 3 月 1 日當天以前傳送 Measurement Protocol 事件 兩個營業日。

  • 如果覆寫 timestamp_micros，請將其設為小於或等於的時間戳記 傳送至要求時間