问题排查

管理转化需要复杂的集成，通常涉及多个相互依赖的工具和流程。本指南详细介绍了您可以采取哪些步骤来排查遇到的任何问题，无论您是遇到不了解的 API 错误，还是对界面中看到的指标或诊断信息感到困惑，都可以参考本指南。

在 Google Ads 界面中解读指标

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 类型。
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 代码是否已在网页上正确设置，以及是否会在提交潜在客户表单时触发。如果您的代码在提交表单时未触发，或者发送的数据不正确，那么您上传的转化数据中可能只会显示很少或根本没有归因信息。请查看我们的帮助中心文章，了解如何配置 Google 代码和配置 Google 跟踪代码管理器以实现增强型潜在客户转化。

• 如果您在网页上使用增强型潜在客户转化而不使用 Google 代码，则必须通过在每次转化中设置 ClickConversion.gclid 字段，在转化导入中包含 GCLID。

• 检查您是否在上传内容中正确指定了意见征求。为此，您可以为账号设置默认的意见征求设置（在 Google Ads 界面中，依次点击工具 -> 数据管理器 -> 意见征求设置），也可以为每次上传的转化设置 ClickConversion.consent 字段。

广告系列效果方面的问题

如果您在上传转化时未遇到任何技术问题，并且对显示的指标感到满意，但在为潜在客户实现增强型转化后，未看到预期的广告系列效果提升，请与 Google Ads 产品支持团队联系以寻求帮助。

增强型网站转化方面的问题

本部分重点介绍如何解决导入增强型网站转化数据时遇到的常见问题。

常见错误

错误
CONVERSION_NOT_FOUND	找不到所提供的转化操作和转化标识符对或 order_id 对应的转化。验证相应转化是否为请求的 customer_id 中指定的 Google Ads 转化客户的 Google Ads 转化。 此外，请验证转化是否不是针对填充了 gbraid 或 wbraid 而不是 gclid 的点击发生的。 Google Ads 不支持针对这些转化的增强型网站转化。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	尚未接受相应请求的 customer_id 的客户数据条款及条件。您可以在前提条件指南中找到相关说明。
CONVERSION_ALREADY_ENHANCED	相应转化已收到具有指定 order_id 和 conversion_action 的调整。请务必为每次转化提供唯一的 order_id。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	所提供的 conversion_action 不符合使用增强型网站转化的条件。在 Google Ads 界面中，请务必选中您的请求中引用的转化操作对应的启用增强型转化复选框。如需了解相关说明，请访问帮助中心。

一般转化管理问题

请注意以下常见问题：

• 尝试将任何枚举字段设置为 UNKNOWN 都会导致 RequestError.INVALID_ENUM_VALUE 错误。如果广告客户可能不知道用户是否已同意，但在指定 consent 时，这是一个常见问题。如果 consent 的状态未知，则应将其设置为 DENIED。

• 为应用转化或 Firebase 和第三方应用分析工具创建转化操作时，您只能在创建时更改 app_id 字段，转化操作创建完毕后，此字段便无法更改。

• 创建转化操作时，您只能将 ConversionAction.attribution_model_settings.attribution_model 字段设置为 GOOGLE_ADS_LAST_CLICK 或 GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN。任何其他选项都会导致 CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS 错误。我们的博文中宣布了弃用其他归因模型，其中包含更多详细信息。

• 对于类型为 AD_CALL 和 WEBSITE_CALL 的转化操作，click_through_lookback_window_days 字段的允许范围为 [1, 60]。对于大多数其他转化操作，允许的范围为 [1, 30]。

• 对于大多数转化操作，view_through_lookback_window_days 字段的允许范围为 [1, 30]。对于类型为 AD_CALL 和 WEBSITE_CALL 的转化操作，此字段必须处于未设置状态。

• 在转化操作中设置或更新 include_in_conversion_metrics 字段会导致 FieldError.IMMUTABLE_FIELD 错误。请改为设置 primary_for_goal 字段，如转化目标指南中所述。

• 创建类型为 WEBSITE_CALL 或 AD_CALL 的转化操作时，必须将 value_settings.always_use_default_value 设置为 true。指定值 false 将导致 INVALID_VALUE 错误。

常见错误

错误
INVALID_CONVERSION_ACTION_TYPE	指定转化操作的类型对于上传点击转化无效。确保上传请求中指定的 ConversionAction 具有 UPLOAD_CLICKS 类型。
NO_CONVERSION_ACTION_FOUND	指定的转化操作未启用或在上传的 customer_id 中找不到。检索有关转化设置的信息，确保上传中的转化操作已启用，并且归上传请求的 customer_id 所有。
TOO_RECENT_CONVERSION_ACTION	相应转化操作是新创建的。在创建操作后，请至少等待 6 小时，然后再重试失败的转化。
INVALID_CUSTOMER_FOR_CLICK	请求的 customer_id 与点击时作为 Google Ads API 转化账号的客户 ID 不同。将请求的 customer_id 更新为正确的客户。
EVENT_NOT_FOUND	Google Ads 找不到点击 ID 和 customer_id 的组合。查看 customer_id 的要求，并确认您使用的是正确的 Google Ads 账号进行上传。
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	请求中的多项转化具有相同的点击 ID、conversion_date_time 和 conversion_action 组合。从您的请求中移除重复的转化。
CLICK_CONVERSION_ALREADY_EXISTS	之前已上传点击 ID、conversion_date_time 和 conversion_action 的组合相同的转化。如果您之前重试上传并成功完成此转换，请忽略此错误。如果您想在之前上传的转化基础上再添加其他转化，请调整 ClickConversion 的 conversion_date_time，以免重复上传之前上传的转化。
EVENT_NOT_FOUND	Google Ads 找不到点击 ID 和 customer_id 的组合。查看 customer_id 的要求，并确认您使用的是正确的 Google Ads 账号进行上传。
EXPIRED_EVENT	导入的点击发生在 click_through_lookback_window_days 字段中指定的时间范围之前。对 click_through_lookback_window_days 的更改只会影响在更改后记录的点击，因此更改回溯期不会解决特定点击的此错误。如果合适，请将 conversion_action 更改为具有更长回溯期的其他操作。
CONVERSION_PRECEDES_EVENT	conversion_date_time 早于点击的日期和时间。将 conversion_date_time 更新为较晚的值。
GBRAID_WBRAID_BOTH_SET	ClickConversion 为 gbraid 和 wbraid 都设置了值。更新转化，使其仅使用一个点击 ID，并确保您不会将多次点击合并到同一转化中。每次点击只有一个点击 ID。
VALUE_MUST_BE_UNSET	检查 GoogleAdsError 的 location，确定以下哪个问题导致了该错误。 ClickConversion 的值设置为 gclid，并且至少包含 gbraid 或 wbraid。更新转化，使其仅使用一个点击 ID，并确保您不会将多次点击合并到同一转化中。每次点击只有一个点击 ID。 ClickConversion 已针对 gbraid 或 wbraid 设置值，并且具有 custom_variables 的值。Google Ads 不支持使用 gbraid 或 wbraid 点击 ID 的转化的自定义变量。取消设置相应转化的 custom_variables 字段。