监控离线数据诊断信息

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

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

账号级诊断

如需检索账号级转化数据上传诊断信息,请使用以下代码: 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_APIclient 值和 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_APIclient 值和 GOOGLE_ADS_WEB_CLIENT

如何解读这些摘要

OfflineConversionUploadClientSummaryOfflineConversionUploadConversionActionSummary 包含一个 status 字段, 反映 总体运行状况 client的上传数量。它还包含以下信息:

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

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

此外,每个 OfflineConversionUploadClientSummaryOfflineConversionUploadConversionActionSummary包含两个不同的 报告类型:

daily_summaries
successful_countfailed_countpending_count 的上传请求 过去 7 天的数据,按上传操作date分组。
job_summaries

7 个最常见地点中的 successful_countfailed_countpending_count 近期的上传请求,按job_id分组。job_id 是可选字段 (共 UploadClickConversionsRequest 行)和 UploadConversionAdjustmentsRequest。您可以将 将 job_id 设置为小于 2^31 的非负数,或者让 Google Ads API 指定 系统生成的作业 ID。无论您选择哪个选项 选择 UploadClickConversionsResponseUploadConversionAdjustmentsResponse 会返回 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_APIstatusNO_RECENT_UPLOADS,则 可能表示使用 Google Ads API 的上传流程已停止运行 。

  • 为了确定是否有某个特定的上传日期或作业发送过大量 处理失败的事件数量,请查看successful_countfailed_count,第 pending_count 项,共 daily_summaries 项,共 job_summaries 项。 如果活动处于待处理状态,则最多可能需要 24 小时 操作完成。

限制

检索上传摘要时,请注意以下几点:

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

    例如,使用跨账号转化跟踪的客户账号可能 不包含任何诊断信息。不过,您可以发送 请求 customer_id 与管理器的 customer_id 匹配 账号。

  • Google Ads 会处理增强型转化导致的 CLICK_NOT_FOUND 错误 潜在客户作为警告上传。如 如果 alerts 包含此错误的条目,则相应的 操作仍会被视为成功,并被 successful_event_count