此页面由 Cloud Translation API 翻译。

监控离线数据诊断信息

使用 Google Ads API 获取线下数据诊断，其中包含有关转化数据上传的整体状况的信息调整流程。

要获取您账号的最新线下数据诊断信息，请使用以下资源之一：

offline_conversion_upload_client_summary 会将上传诊断信息汇总到。
offline_conversion_upload_conversion_action_summary（仅适用于以下国家/地区） v17 或更高版本）汇总了转化操作一级的上传诊断信息。

账号级诊断

如需检索账号级转化数据上传诊断信息，请使用以下代码： GAQL 查询：

SELECT
  customer.id,
  offline_conversion_upload_client_summary.alerts,
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.daily_summaries,
  offline_conversion_upload_client_summary.job_summaries,
  offline_conversion_upload_client_summary.last_upload_date_time,
  offline_conversion_upload_client_summary.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.success_rate,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary

此查询会返回单独的 OfflineConversionUploadClientSummary 行。例如，如果您最近同时使用 Google Ads API 和 Google Ads 界面上传的记录，包含与 GOOGLE_ADS_API 的 client 值和 GOOGLE_ADS_WEB_CLIENT。

转化操作级诊断

要获取转化操作一级的转化数据上传诊断信息，请使用以下 GAQL 查询：

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >

与账号级诊断类似，此查询会返回单独的 OfflineConversionUploadConversionActionSummary 行。例如，如果您最近同时使用 Google Ads API 和 Google Ads 界面上传的记录，包含与 GOOGLE_ADS_API 的 client 值和 GOOGLE_ADS_WEB_CLIENT。

如何解读这些摘要

每OfflineConversionUploadClientSummary或 OfflineConversionUploadConversionActionSummary 包含一个 status 字段，反映总体运行状况 client的上传数量。它还包含以下信息：

收到的事件总数。
已成功处理的事件数。
待处理事件（仍在处理的事件）的数量。
一个 alerts 字段，提供错误摘要，按 OfflineConversionError。

所有这些字段都包含最近一个完整日历日的信息上传数量。您可以使用这些信息来评估上传内容的当前运行状况。

此外，每个 OfflineConversionUploadClientSummary 或 OfflineConversionUploadConversionActionSummary包含两个不同的报告类型：

daily_summaries

successful_count、failed_count 和 pending_count 的上传请求过去 7 天的数据，按上传操作date分组。

job_summaries

7 个最常见地点中的 successful_count、failed_count和pending_count 近期的上传请求，按job_id分组。job_id 是可选字段（共 UploadClickConversionsRequest 行）和 UploadConversionAdjustmentsRequest。您可以将将 job_id 设置为小于 2^31 的非负数，或者让 Google Ads API 指定系统生成的作业 ID。无论您选择哪个选项选择 UploadClickConversionsResponse 或 UploadConversionAdjustmentsResponse 会返回 job_id。

分配自己的 job_id 的一种适用情况是：使用单个作业或流程上传大量转化数据，多个请求如果您将每个请求的 job_id 设置为则可以从检索招聘信息的单个条目。 job_summaries。如果您改为让 Google Ads API 分配系统生成的值添加到每个请求的 job_id 中，那么 job_summaries 会包含一个单独的这样就能分析您网页的整体健康状况工作更具挑战性

如何使用摘要

为确保您的上传流程能够记录转化和改进，定期检索您各个账号的摘要。如果任何摘要的 status 不是 EXCELLENT，请使用下面的错误列表 alerts指导您修改上传流程，以减少或减少消除这些错误

例如：

如果状态为 NEEDS_ATTENTION，则表示您的大部分上传操作失败。查看“alerts”下的错误，并修改您的上传流程以减少或消除这些错误。
如果状态为 NO_RECENT_UPLOADS，则表示 Google Ads 未收到任何近期的为 client 上传的视频。如果这属于意外情况，请审核执行上传操作。

例如，如果 GOOGLE_ADS_API 的 status 为 NO_RECENT_UPLOADS，则可能表示使用 Google Ads API 的上传流程已停止运行。
为了确定是否有某个特定的上传日期或作业发送过大量处理失败的事件数量，请查看successful_count， failed_count，第 pending_count 项，共 daily_summaries 项，共 job_summaries 项。如果活动处于待处理状态，则最多可能需要 24 小时操作完成。

限制

检索上传摘要时，请注意以下几点：

只有在以下情况下，Google Ads API 才会返回线下数据诊断结果： customer_id searchStream 或 search 请求与您近期使用过的客户相同上传转化数据。

例如，使用跨账号转化跟踪的客户账号可能不包含任何诊断信息。不过，您可以发送请求 customer_id 与管理器的 customer_id 匹配账号。
Google Ads 会处理增强型转化导致的 CLICK_NOT_FOUND 错误潜在客户作为警告上传。如如果 alerts 包含此错误的条目，则相应的操作仍会被视为成功，并被 successful_event_count。

转化价值规则

报告