监控离线数据诊断信息

使用 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_APIGOOGLE_ADS_WEB_CLIENTclient 值条目。

转化操作级诊断

如需在转化操作一级检索转化上传诊断信息,请使用以下 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_APIGOOGLE_ADS_WEB_CLIENTclient 值条目。

如何解读这些摘要

每个 OfflineConversionUploadClientSummaryOfflineConversionUploadConversionActionSummary 都有一个 status 字段,该字段反映了 client 上传内容的整体健康状况。其中还包含以下信息:

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

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

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

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

最近 7 次上传请求的 successful_countfailed_countpending_count,按 job_id 分组。job_idUploadClickConversionsRequestUploadConversionAdjustmentsRequest 的可选字段。您可以将 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 的上传流程最近已停止运行。

  • 如需确定是否有特定的上传日期或作业发送了大量未能处理的事件,请检查 daily_summariesjob_summariessuccessful_countfailed_countpending_count。处于待处理状态的任何事件最长可能需要 24 小时才能完成。

限制

检索上传摘要时,请注意以下事项:

  • 仅当 searchStreamsearch 请求的 customer_id 就是您最近用来上传转化数据的客户时,Google Ads API 才会返回线下数据诊断信息。

    例如,使用跨账号转化跟踪的客户账号可能不包含任何诊断信息。不过,您可以发送请求来检索诊断信息,其中 customer_id 与您在上传内容时使用的经理账号的 customer_id 相匹配。

  • Google Ads 会将潜在客户增强型转化上传过程中出现的 CLICK_NOT_FOUND 错误视为警告。因此,如果 alerts 包含此错误的条目,相应的操作仍会被视为成功,并包含在 successful_event_count 中。