使用 Data Manager API 傳送 Google Analytics 建議和自訂事件。
詳情請參閱「傳送事件」。
如果您要從 Google Analytics Measurement Protocol 升級，請參閱「從 Measurement Protocol 升級至 Data Manager API」一文的操作說明。
用途
以下是透過 Data Manager API 傳送建議事件和自訂事件的一些用途：
連結線上和離線行為。
評估用戶端和伺服器端的互動。
傳送非標準使用者互動的事件，例如離線轉換。
從不支援自動收集功能的裝置和應用程式 (例如資訊站和手錶) 傳送事件。
使用者提供的資料
您可以在 Event 的 userData 欄位中，傳送第一方顧客數位資料，例如經過雜湊處理的電子郵件地址、電話號碼和實際地址。這有助於提升 Google Analytics 的轉換評估、歸因和目標對象建立成效。
傳送使用者提供的資料時，請注意下列事項：
隨事件傳送：在 Data Manager API 中，使用者提供的資料必須隨
Event一併傳送。系統不支援沒有事件的獨立上傳。格式和雜湊處理：上傳前，必須先正規化個人 ID (例如電子郵件地址、電話號碼、姓名和街道地址)，並使用 SHA-256 雜湊處理。其他欄位 (例如城市、州或省、郵遞區號和國家/地區代碼) 會經過正規化處理，但不會進行雜湊處理。請參閱「設定使用者資料格式」指南，瞭解具體規定。
加密：您可以選擇加密經過雜湊處理的使用者資料。
導入：如需建構要求的操作說明，請參閱「新增使用者提供的資料」。
整合考量
使用 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 使用者介面中設定的規則。