Google Analytics 建議和自訂事件

使用 Data Manager API 傳送 Google Analytics 建議和自訂事件。

傳送建議和自訂事件

如果您是從 Google Analytics Measurement Protocol 升級，請參閱「從 Measurement Protocol 升級至 Data Manager API」的操作說明。

工作流程總覽

如要使用 Data Manager API 傳送事件資料，請完成下列步驟：

  1. 準備目的地：定義擷取要求 destinations 欄位的 Destination 物件，指定目標帳戶和轉換或事件目的地。詳情請參閱「準備目的地」。

  2. 準備事件資料和 ID：在 Event 欄位中填入事件詳細資料和必要 ID (例如廣告點擊、用戶端或應用程式執行個體 ID)。如果您在 userData 中加入使用者聯絡資訊，請根據格式規範，將 ID 正規化並使用 SHA-256 雜湊處理，並視需要加密。詳情請參閱「準備事件資料」。

  3. 建構及傳送擷取要求：提交包含 destinations、Event 記錄和 encryptionInfo 的 events.ingest 要求 (如果已加密 userData)。傳送正式資料前，請使用 validateOnly: true 測試酬載，檢查是否有快速失敗錯誤。如需欄位規定和程式碼範例，請參閱「傳送事件」。

  4. 檢查診斷資訊：擷取非同步處理診斷資訊，並使用 requestStatus.retrieve 驗證擷取狀態。

用途

以下列舉幾個使用 Data Manager API 傳送建議和自訂事件的用途：

  • 連結線上和離線行為。

  • 評估用戶端和伺服器端的互動。

  • 傳送非標準使用者互動的事件，例如離線轉換。

  • 從不支援自動收集功能的裝置和應用程式 (例如資訊站和手錶) 傳送事件。

使用者提供的資料

您可以在 Event 的 userData 欄位中，傳送第一方顧客數位資料，例如經雜湊處理的電子郵件地址、電話號碼和實際地址。這有助於提升 Google Analytics 的轉換評估、歸因和目標對象建立成效。

傳送使用者提供的資料時，請注意下列事項：

  • 與事件一併傳送：在 Data Manager API 中，使用者提供的資料必須做為 Event 的一部分傳送。不支援上傳不含事件的獨立資料。

  • 格式設定和雜湊處理：個人 ID (例如電子郵件地址、電話號碼、姓名和街道地址) 必須先正規化，並使用 SHA-256 雜湊處理，才能上傳。其他欄位 (例如城市、州或省、郵遞區號和國家/地區代碼) 則會經過正規化，但不會雜湊處理。請參閱「設定使用者資料格式」指南，瞭解具體規定。

  • 加密：您可以選擇加密經過雜湊處理的使用者資料。

  • User-ID：只要有固定不變的使用者 ID，建議您一併提供 userId 和 userData。

  • 導入：如需建構要求的操作說明，請參閱「新增使用者提供的資料」。

整合考量

使用 Data Manager API 時，請注意下列事項。

再行銷

啟用 Google 信號後，Google Analytics 支援同裝置再行銷。如要使用跨裝置再行銷，請務必userId。

此外，您也可以傳送使用者提供的資料，啟用第一方目標對象比對功能。

廣告 ID

Google Analytics 會使用 clientId 或 appInstanceId，自動將線上互動期間收集的廣告 ID (例如 GBRAID 或 WBRAID)，與 Data Manager API 事件彙整。

隱私權設定

Google Analytics 會使用 clientId 或 appInstanceId，將 Data Manager API 事件與線上互動彙整，以採用「非個人化廣告」和「限制廣告追蹤」等使用者隱私權設定。

您也可以使用 consent 物件，直接在每個事件上指定使用者同意聲明設定。

地理位置和裝置資訊

Google Analytics 會使用 clientId 或 appInstanceId，自動將代碼中的最新地理位置和裝置資訊與 Data Manager API 事件合併。這樣一來，包含地理位置和裝置維度的報表就會反映 Data Manager API 事件。

如果您希望 Data Manager API 事件反映「特定」工作階段的地理和裝置資訊，而非 clientId 或 appInstanceId 的最新資訊，請在 additionalEventParameters 中加入一筆項目，將 parameterName 設為 session_id，並將 value 設為特定工作階段的 ID，然後在工作階段開始後 24 小時內傳送事件。

您可以使用 Data Manager API，為事件提供地理資訊和裝置資訊。

完整伺服器對伺服器

雖然可以只使用 Data Manager API 將事件傳送至 Google Analytics，但可能只能取得部分報表。Data Manager API 的用途是擴充透過 gtag、代碼管理工具或 Firebase 收集的現有事件。部分事件和參數名稱保留供自動收集使用，無法透過 Data Manager API 傳送。

產生或重新命名事件

透過 Data Manager API 傳送的事件，不會觸發產生或重新命名事件的規則。應用程式應導入邏輯，透過 Data Manager API 傳送自訂事件，類似於 Google Analytics 使用者介面中設定的規則。

下一頁
傳送事件