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