排查增强型潜在客户转化问题

您可以使用本指南来排查增强型潜在客户转化集成方面的问题。

解决上传内容中存在的差异

导致增强型潜在客户转化数据上传失败或未按预期显示在 Google Ads 界面中的原因有很多。如需有关可能导致报告差异或上传的转化未显示在 Google Ads 界面中的常见设置问题的指导，请访问帮助中心。

调试常见错误

错误
NO_CONVERSION_ACTION_FOUND	指定的转化操作未启用，或者无法由请求中的 `client_id` 字段指定的客户账号访问。确保您上传内容中的转化操作已启用，并且归发送上传请求的客户所有。 如果请求中的 GCLID 属于不具有对请求中指定的转化操作的访问权限的客户账号，也可能会发生此错误。您可以使用 click_view 资源验证 GCLID 是否属于客户账号，方法是提交按 click_view.gclid 和 segments.date 过滤的查询，其中日期是点击发生的日期。
INVALID_CONVERSION_ACTION_TYPE	指定的转化操作的类型不适用于增强型潜在客户转化。请确保上传请求中指定的 ConversionAction 的类型为 UPLOAD_CLICKS。
CLICK_CONVERSION_ALREADY_EXISTS	此点击已有具有此 conversion_date_time 的转化。请确保每个事件的 conversion_date_time 都是唯一的，然后重试。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	请确保您已在转化设置中启用增强型潜在客户转化。如需了解相关说明，请参阅前提条件指南。
DUPLICATE_ORDER_ID	导入的事件包含多个具有相同订单 ID 的转化，因而未能得到处理。 请确保订单 ID 是唯一的，然后重试。
CLICK_NOT_FOUND	未找到与所提供的用户标识符匹配的点击。只有当 UploadClickConversionsRequest 上的 debug_enabled 为 true 时，Google Ads API 才会返回此错误。 注意：除非大多数转化都出现此错误，否则请将其视为警告。 如果某个转化遇到此警告，Google Ads API 会将其包含在线下数据诊断的 successful_event_count 中。Google Ads API 在 alerts 集合中包含 CLICK_NOT_FOUND 条目，以便您监控此警告的频率。 如果点击不是由 Google Ads 广告系列带来的，则会出现此错误。例如，它可能来自 SA360 或 DV360。其他可能的原因如下： 上传客户不同于 Google Ads 转化客户。 您的潜在客户表单的代码植入配置不正确。 上传的数据未正确 归一化和哈希处理。 在极少数情况下，上传客户与 Google Ads 转化客户不同，此错误可能表示上传客户已接受客户数据条款，但投放客户尚未接受。 您可以通过查询 customer 资源并检查 customer.offline_conversion_tracking_info.accepted_customer_data_terms 字段，确定账号是否已接受客户数据条款。

其他问题排查支持

如果您遇到的问题未涵盖在此处，请通过 Google Ads API 技术支持表单与我们联系，并务必附上 Google Ads API 请求和响应日志，以及您已尝试的所有问题排查步骤。