排查客户名单问题

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

验证匹配率

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

导致匹配率低于预期的原因有很多，包括：

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

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

• 您要与其他系统中的匹配率进行比较。

• 您尝试向单个 UserIdentifier 对象添加多个用户标识符。而是将多个 UserIdentifier 添加到单个 UserData 对象，如此代码示例所示。

广告客户可以根据其用户在 Google 搜索、Gmail 或 YouTube 上的活跃程度，触达名单中 1% 到 99% 的用户。如需有关排查匹配率偏低问题的更详细指南，请访问帮助中心。

匹配率和名单大小之间的差异

请注意，名单规模和匹配率反映的是不同的值。匹配率会统计所有拥有 Google 账号的用户，即使目标客户匹配名单实际上无法覆盖这些用户也是如此。名单规模是指与 Google 账号匹配且能够被 Google Ads 个性化功能覆盖的活跃用户数。

调试常见错误

错误
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 限制和配额的最佳实践指南。

其他问题排查支持

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