本指南可帮助您排查目标客户匹配集成中可能出现的匹配率低和常见错误。
验证匹配率
在尝试验证匹配率之前，请确保上传作业已完成。
匹配率低于预期可能有多种原因，包括：
- 数据在上传前未经过哈希处理。
- 数据在经过哈希处理之前未正确设置格式。
- 您在与另一个系统中的匹配率进行比较。
- 您正尝试向单个
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 操作总共包含超过 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 来执行目标客户匹配工作流程。 |
其他问题排查支持
如果您仍遇到问题，请通过目标客户匹配问题排查工具与我们联系。