问题排查

管理转化需要进行复杂的集成，通常涉及多个相互依赖的工具和流程。本指南提供了详细步骤，可帮助您排查遇到的任何问题，无论您是遇到无法理解的 API 错误，还是对界面中显示的指标或诊断信息感到困惑。

重要提示： API 返回的成功导入响应并不一定意味着转化已归因。如需详细了解成功导入后的数据差异，请参阅成功上传后的数据差异。

在 Google Ads 界面中查看指标

Google Ads 界面不会按导入日期整理转化指标，因此使用界面中的报告来验证导入结果可能会产生误导。如需验证导入健康状况，请先查看线下数据诊断。您还可以详细了解 Google Ads 界面中针对增强型潜在客户转化和增强型网站转化的诊断信息。

增强型潜在客户转化存在问题

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

常见错误

以下指南可帮助您诊断和修复增强型潜在客户转化的常见错误。

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

• 对于大多数转化操作，view_through_lookback_window_days 字段的允许范围为 1 到 30 天。对于 AD_CALL 和 WEBSITE_CALL 类型的转化操作，此字段必须不设置。

• 在转化操作中设置或更新 include_in_conversions_metric 字段会导致 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 网址参数的转化设置自定义变量。取消设置转化的 custom_variables 字段。