排解客戶名單問題

請參閱本指南,瞭解如何排解目標顧客比對整合時,可能發生的媒合率偏低和常見錯誤。

驗證媒合率

請確認上傳工作已完成,再嘗試驗證媒合率。

媒合率低於預期的原因有很多,包括:

  • 資料在上傳前未經過雜湊處理。
  • 資料在雜湊處理前未正確設定格式。
  • 您正在與其他系統的媒合率進行比較。
  • 您嘗試在單一 UserIdentifier 物件中新增多個使用者 ID。請改為將多個 UserIdentifier 物件新增至單一 UserData 物件,如這個程式碼範例所示。

視使用者在 Google 搜尋、Gmail 或 YouTube 上的活躍程度而定,廣告主可能觸及名單上 1% 到 99% 的使用者。如需更詳細的媒合率偏低疑難排解指南,請前往說明中心。

媒合率和名單大小的差異

名單大小和媒合率反映的值不同。媒合率會計入所有擁有 Google 帳戶的使用者,即使他們實際上無法透過目標顧客比對名單觸及。名單人數是指與 Google 帳戶相符,且可透過廣告個人化功能觸及的活躍使用者人數。

排解常見錯誤

錯誤
USER_PERMISSION_DENIED 如果您嘗試修改其他帳戶建立的清單,可能會發生權限錯誤。您只能編輯自己帳戶建立的名單。
EXTERNAL_UPDATE_ID_ALREADY_EXISTS 如果嘗試使用相同的 external_id 建立多個工作,就可能發生這項錯誤。
CONFLICTING_OPERATION 如果單一工作中混合了 remove 作業和 create 作業,就可能發生這項錯誤。
TOO_MANY_USER_IDENTIFIERS 單一工作中的 create 作業總共包含超過 100,000 個 user_identifiers。請將要求分割成多個不超過上限的要求。
CONCURRENT_MODIFICATION 如果嘗試同時對同一份清單執行操作,就可能發生這個錯誤。
RESOURCE_EXHAUSTED 如果嘗試傳送過多要求,就可能發生這項錯誤。如要降低這類情形,請按照建議的 使用流程批次處理作業。您也可以參閱 API 限制和配額的最佳做法指南。
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 如果您的 Google Cloud 專案 (或舊版開發人員權杖,將於 2026 年 9 月 9 日淘汰) 在 2025 年 10 月 1 日至 2026 年 3 月 31 日期間,沒有任何目標顧客比對要求,就會發生這項錯誤。您必須改用 Data Manager API 進行目標顧客比對工作流程。

其他疑難排解支援

如果問題仍無法解決,請透過目標顧客比對疑難排解工具與我們聯絡。