问题排查

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

在 Google Ads 界面中查看指标

Google Ads 界面不会按导入日期整理转化指标，因此使用界面中的广告系列报告来验证导入结果可能会产生误导。如需验证 API 请求级导入运行状况，请先进行线下数据诊断。线下数据诊断不会评估增强型转化的异步代码匹配或用户标识符质量。如需验证匹配健康状况，请查看 Google Ads 界面中增强型潜在客户转化和增强型网站转化的诊断报告。如需了解问题排查步骤，请参阅成功上传 API 后的界面诊断提醒。

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

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

常见错误

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

错误
NO_CONVERSION_ACTION_FOUND

指定的转化操作未启用，或请求的 customer_id 字段中的账号无法访问该转化操作。确认您上传的转化操作已启用，并且其所有者是点击的 Google Ads 转化客户或上传账号的转化跟踪层次结构中的账号。

如果请求中的 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 转化客户不同，此错误可能意味着上传客户已接受客户数据条款，但投放客户未接受。

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

指标差异

请注意以下常见问题：

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

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

  • 如果您在网页上使用增强型潜在客户转化功能，但没有使用 Google 代码，则必须在转化导入中包含 GCLID，方法是为每次转化设置 ClickConversion.gclid 字段。

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

广告系列效果问题

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

增强型网站转化存在问题

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

常见错误

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

错误
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 尚未接受请求的 customer_id 的客户数据条款及条件。如需了解相关说明，请参阅前提条件指南。
CONVERSION_ALREADY_ENHANCED 此转化已收到具有给定 order_id 和 conversion_action 字段的 ENHANCEMENT 调整。请务必为每次转化提供唯一的 order_id 值。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 提供的 conversion_action 无效，无法用于增强型网站转化。在 Google Ads 界面中，请务必在请求中引用的转化操作上勾选启用增强型转化复选框。如需了解相关说明，请访问帮助中心。
INVALID_USER_IDENTIFIER 经过哈希处理的用户标识符字段（hashed_email、hashed_phone_number、hashed_first_name、hashed_last_name 或 hashed_street_address）不是有效的 64 字符十六进制 SHA-256 摘要。在导入用户提供的数据之前，先对其进行规范化和哈希处理。如需查看相关说明，请参阅对用户提供的数据进行标准化和哈希处理。
CONVERSION_NOT_FOUND

Google Ads 找不到与提供的 conversion_action 字段和转化标识符（order_id 或 gclid_date_time_pair）匹配的转化。此错误仅适用于 RESTATEMENT 和 RETRACTION 调整。如需了解详情，请参阅导入转化调整项中的要求。

对于 ENHANCEMENT 调整，API 会接受请求，而不会返回 CONVERSION_NOT_FOUND 错误，并异步评估代码与 API order_id 的匹配情况。如果 order_id 值不匹配率较高，则会在 Google Ads 界面的增强型转化诊断报告中触发订单 ID 不匹配提醒。如需了解问题排查步骤，请参阅成功上传 API 后的界面诊断提醒。

成功通过 API 上传后，界面中会显示诊断提醒

当您使用 ConversionAdjustmentUploadService 服务上传 ENHANCEMENT 调整项时，API 会在提取时验证请求格式，并异步将增强功能与网站代码事件进行匹配。因此，API 请求可能会成功，partial_failure_error 字段中不会出现错误，并且线下数据诊断中会显示 EXCELLENT 状态。同时，Google Ads 界面中的增强型转化诊断报告仍会显示提醒。

如果 API 上传成功后出现界面诊断提醒，请检查以下原因：

  • 缺少必填地址字段：address_info 字段中的 OfflineUserAddressInfo 对象要求在同一条目中包含四个字段：hashed_first_name、hashed_last_name、country_code 和 postal_code。 hashed_street_address、city 和 state 字段是可选的（如果您填充 hashed_street_address 字段，它仍必须是有效的 64 字符 SHA-256 十六进制摘要）。该 API 接受非空的部分 address_info 对象（例如仅包含名字和姓氏），而不会在 partial_failure_error 字段中返回错误。不过，下游匹配会舍弃不完整的地址，并针对缺失的地址字段触发提醒。如果四个必填字段中有任何一个不可用，请省略 address_info 字段的 UserIdentifier 对象。

  • 网站代码事件中缺少交易 ID：在 API 中，如果从 ENHANCEMENT 调整中省略 order_id 字段，则会返回同步 FieldError.REQUIRED 错误。如果您的 API 请求包含 order_id 字段，则界面中关于转化事件缺少交易 ID 的提醒是指您的网站代码。如果包含有效交易 ID 的网站转化跟踪代码事件少于 90%（或者代码发送了占位符字符串，例如 "undefined" 或 "null"），就会显示此提醒。请配置网站转化跟踪代码，以便为每个转化事件发送唯一的交易 ID。

  • 代码和 API 发送的订单 ID 不一致或上传延迟：对于 ENHANCEMENT 调整，API 在上传时不会返回 CONVERSION_NOT_FOUND 或 CONVERSION_EXPIRED 错误。相反，不匹配的 order_id 值会在界面中触发订单 ID 不匹配提醒，而在转化发生 24 小时后上传的增强功能会触发延迟上传提醒。将 API order_id 字段与网站转化跟踪代码发送的确切交易 ID 字符串进行匹配，并在转化事件发生后的 24 小时内上传增强型转化数据。

  • 在上传前对未标准化的用户数据进行哈希处理：对未标准化的值（例如大写字母、前导或尾随空格，或不符合 E.164 格式的电话号码）进行哈希处理，仍会生成有效的 64 字符 SHA-256 十六进制摘要。API 会接受上传，而不会返回 INVALID_USER_IDENTIFIER 错误，但下游匹配会失败，并报告格式设置错误或低匹配率提醒。遵循对用户提供的数据进行标准化和哈希处理中的标准化规则。

  • API 增强量相对于网站代码量较低：界面诊断会将包含用户标识符的去重 API 增强事件与去重且已征得用户同意的网站代码事件进行比较：

    • 意见征求模式配置：当 Google 代码上的意见征求模式发出 ad_storage='denied' 设置信号时，界面诊断会从比较中排除未同意的网站代码事件，因此从 API 上传中省略这些事件不会触发数据量过低提醒。不过，网站代码与后端触发器之间的意见征求处理方式不一致会触发以下提醒：

      • 代码缺少 ad_storage='denied'，后端跳过上传：界面诊断会将代码事件计为已征得用户同意，并报告覆盖率低提醒。
      • 代码信号 ad_storage='denied'，后端上传增强功能：上传的增强信息缺少匹配的已征得用户同意的代码事件，并导致订单 ID 不匹配提醒。

      对网站代码和 API 增强型上传应用相同的同意情况。

    • 匿名网站事件：请勿针对漏斗上端转化操作（例如网页浏览或商品浏览）启用增强型转化，因为网站代码会针对匿名访问者触发这些操作。如果您的服务器仅针对已登录且详细联系信息已知的用户发送 API 增强功能，则不匹配的匿名代码事件会触发低覆盖率提醒。仅针对持续提供用户提供的数据的转化操作启用增强型转化。

一般转化管理问题

请注意以下常见问题：

  • 尝试将任何枚举字段设置为 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 字段中的账号无法访问该转化操作。 检索有关转化跟踪设置的信息，以确认转化操作已启用。转化操作所有者必须是点击的 Google Ads 转化客户，或上传账号的转化跟踪层次结构中的账号。 例如，如果转化操作属于在点击后解除关联的前经理账号，则会发生此错误。
TOO_RECENT_CONVERSION_ACTION 转化操作是新创建的。在创建操作后，请至少等待 6 小时，然后再重试失败的转化。
INVALID_CUSTOMER_FOR_CLICK 请求中的 customer_id 字段与点击时的 Google Ads 转化客户不匹配。如果上传账号也缺少对转化操作的跨账号访问权限，就会发生此错误。将请求的 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，以免与之前上传的转化重复。
EXPIRED_EVENT 导入的点击发生在 click_through_lookback_window_days 字段中指定的时间范围之前。对 click_through_lookback_window_days 的更改只会影响更改后记录的点击，因此更改回溯期无法解决特定点击的此错误。如果合适，请将 conversion_action 更改为具有更长回溯期的其他操作。
CONVERSION_PRECEDES_EVENT conversion_date_time 早于点击的日期和时间。将 conversion_date_time 更新为更晚的值。
VALUE_MUST_BE_UNSET

ClickConversion 为 gbraid 或 wbraid（不含 gclid）设置了值，并且为 custom_variables 或 cart_data 设置了值，而 Google Ads 不支持将 gbraid 或 wbraid 与这些值搭配使用。取消设置冲突字段。
上一页
报告