问题排查

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

在 Google Ads 界面中读取指标

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

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

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

常见错误

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

错误
NO_CONVERSION_ACTION_FOUND	指定的转化操作要么未启用，要么无法由请求中 customer_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	找不到与提供的用户标识符匹配的点击。 如果转化遇到此警告，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 代码，那么您必须 在转化导入中添加 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 到 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 组合的转化。如果您要重试上传，并且此 转化之前已成功，请忽略此错误。如果您想在之前上传的转化之外再添加一个转化，请调整conversion_date_time的ClickConversion，以避免重复之前上传的转化。
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	检查 location 的 GoogleAdsError，以确定导致错误的以下哪个问题。 ClickConversion 为 gclid 以及 gbraid 或 wbraid 中的至少一个设置了值。请更新 转化，使其仅使用一个点击 ID 或网址参数，并确保 您没有将多个点击合并到同一转化中。每个点击 只有一个点击 ID 或网址参数。 ClickConversion 为 gbraid 或 wbraid 设置了值，并且为 custom_variables 设置了值。Google Ads 不支持具有 gbraid 或 wbraid 网址参数的转化的自定义变量。请取消设置转化的 custom_variables 字段。