請參閱本指南，排解目標顧客比對整合功能中比對率偏低和常見錯誤的問題。
驗證媒合率
請先確認上傳工作已完成，再嘗試驗證比對率。
媒合率可能低於預期，原因包括：
- 上傳前未經過雜湊處理。
- 資料在經過雜湊處理前，格式不正確。
- 您正在與其他系統中的比對率進行比較。
- 您嘗試將多個使用者 ID 新增至單一
UserIdentifier物件。請改為將多個UserIdentifier物件新增至單一UserData物件，如這個程式碼範例所示。
廣告主可觸及的名單使用者比例介於 1% 到 99% 之間，取決於使用者在 Google 搜尋、Gmail 或 YouTube 上的活躍程度。如需詳細的媒合率偏低問題排解指南，請造訪說明中心。
比對率和名單大小的差異
名單大小和比對率反映不同的值。比對率會計入所有擁有 Google 帳戶的使用者，即使目標顧客比對名單實際上無法觸及這些使用者，名單人數會計算符合 Google 帳戶且可透過廣告個人化功能觸及的活躍使用者。
排解常見錯誤
| 錯誤 | |
|---|---|
USER_PERMISSION_DENIED
|
如果您嘗試修改其他帳戶建立的清單，可能會發生權限錯誤。你只能編輯自己帳戶建立的清單。 |
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
如果嘗試使用相同的
external_id 建立多個工作，就會發生這個錯誤。 |
CONFLICTING_OPERATION
|
如果單一工作中混合使用 remove 和 create 作業，就可能發生這項錯誤。 |
TOO_MANY_USER_IDENTIFIERS
|
單一工作中的 create 作業總數超過 10 萬個
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 進行目標顧客比對工作流程。 |
其他疑難排解支援
如果問題仍無法解決，請透過目標顧客比對疑難排解工具與我們聯絡。