排查客户名单问题

本指南可帮助您排查目标客户匹配集成中可能出现的匹配率偏低问题和常见错误。

验证匹配率

请确保上传作业已完成，然后再尝试验证匹配率。

匹配率可能因多种原因而低于预期，包括：

  • 数据在上传之前未经过哈希处理。

  • 数据在经过哈希处理之前未正确设置格式。

  • 您正在与另一个系统中的匹配率进行比较。

  • 您正在尝试向单个 UserIdentifier 对象添加多个用户标识符。请改为向单个 UserData 对象添加多个 UserIdentifier，如此代码示例所示。

广告客户可以触达其名单中 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 限制和配额的最佳实践指南。

其他问题排查支持

如果您仍遇到问题，请通过目标客户匹配问题排查工具与我们联系。