使用 Data Manager API 時,請留意下列最佳做法。
傳送所有使用者 ID
無論是使用 UserData 傳送目標對象成員或事件,請盡可能加入多個 user_identifiers,包括傳送多個相同類型的 ID。
舉例來說,如果使用者有多個電子郵件地址,請為每個電子郵件地址加入個別的 UserIdentifier。同樣地,如果您有使用者的不同類型 ID,例如電子郵件地址、電話號碼和地址,請為每個 ID 分別新增 UserIdentifier,最多可達ID 數量上限。
最佳化要求
為降低超過每日要求上限的可能性,請盡可能在每項要求中批次處理多個項目,最多不超過單次要求限制。
舉例來說,如要將 10,000 名目標對象成員加入目標對象,請在一個 IngestAudienceMembersRequest 的 audience_members 清單中加入所有 10,000 名成員。在單一要求中批次處理所有 10,000 名成員,比為每位目標對象成員分別傳送要求更有效率。
傳送並行要求
如要縮短擷取資料所需的整體時間,請同時傳送並行要求至 IngestionService。建議您同時傳送最多 10 個要求,降低超出每分鐘要求限制的可能性。
即使要求具有相同的 destinations,您也可以傳送並行要求。
使用 validateOnly 檢查快速失敗錯誤
傳送要求時,請將 validateOnly 設為 true,以擷取快速失敗錯誤。Data Manager API 會執行與一般要求相同的驗證檢查,但不會擷取或移除任何資料。
即使僅限驗證要求成功,也不代表處理期間不會發生錯誤,因此傳送一般要求後,請繼續查看診斷資訊。
查看診斷資訊
擷取並收集每個 IngestAudienceMembersResponse 或 IngestEventsResponse 的 request_id,然後使用要求 ID 查看診斷。
監控配額並設定快訊
為避免要求意外遭拒,請在 Google Cloud 控制台中設定配額警告和監控功能。監控配額用量有助於追蹤用量模式,並在應用程式達到每日或每分鐘限制前,最佳化要求批次處理。
部署至正式環境
從本機測試轉換至正式環境工作負載時,請使用應用程式預設憑證,並附加服務帳戶或 Workload Identity Federation,以非互動方式安全地進行驗證。
如要進一步瞭解如何為不同正式環境設定驗證,請參閱「部署至正式環境」。