问题排查

管理转化需要进行复杂的集成，通常涉及多个相互依赖的工具和流程。本指南提供了详细的步骤，可帮助您排查遇到的任何问题，无论是 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。
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 转化客户不同，此错误可能表示上传客户已接受客户数据条款，但投放客户尚未接受。

您可以通过查询 customer 资源并检查 customer.offline_conversion_tracking_info.accepted_customer_data_terms 字段，确定账号是否已接受客户数据条款。

指标存在差异

请注意以下常见问题：

  • 转化可能会因各种原因而被我们的处理流水线舍弃，并且无法恢复。如需了解详情，请参阅成功上传后的数据差异一文。

  • 仔细检查 Google 代码是否已在您的网页上正确设置，并在有潜在客户表单提交时触发。如果您的代码在表单提交时未触发，或者发送的数据不正确，那么您在上传的转化中看到的归因可能很低，甚至没有归因。如需了解如何为增强型潜在客户转化配置 Google 代码和配置 Google 跟踪代码管理器，请参阅我们的帮助中心文章。

  • 如果您在网页上未植入 Google 代码，但使用了增强型潜在客户转化，则必须在导入的转化中包含 GCLID，方法是针对每个转化设置 ClickConversion.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 字段。
上一页
报告