排解客戶名單問題

請參閱本指南,瞭解如何排解比對率偏低的問題,以及目標顧客比對整合功能中可能發生的常見錯誤。

驗證媒合率

請先確認上傳作業已完成,再嘗試驗證比對率。

媒合率可能低於預期,原因包括:

  • 上傳前未將資料雜湊處理。

  • 資料在經過雜湊處理前,格式不正確。

  • 您正在與其他系統中的比對率進行比較。

  • 您嘗試將多個使用者 ID 新增至單一UserIdentifier物件。請改為將多個 UserIdentifier 新增至單一 UserData 物件,如這個程式碼範例所示。

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

媒合率和名單大小的差異

請注意,名單大小和媒合率反映不同的值。媒合率會計入所有 Google 帳戶使用者,即使無法透過目標顧客比對名單實際觸及這些使用者,名單人數會計入有效使用者,這些使用者已與 Google 帳戶相符,且可透過 Google Ads 廣告活動的個人化功能觸及。

偵錯常見錯誤

錯誤
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 如果您的開發人員權杖在 2026 年 4 月 1 日前未曾傳送目標顧客比對要求,就會發生這項錯誤。請改用 Data Manager API 進行目標顧客比對工作流程。

其他疑難排解支援

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