监控离线数据诊断信息

使用 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_API 和 GOOGLE_ADS_WEB_CLIENT 的 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 和 GOOGLE_ADS_WEB_CLIENT 的 client 值的单独条目。

如何解读这些摘要

每个 OfflineConversionUploadClientSummary 或 OfflineConversionUploadConversionActionSummary 都有一个 status 字段，用于反映 client 的导入总体健康状况。它还包含以下信息：

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

所有这些字段都包含最近一个完整日历天的导入信息。您可以使用这些信息来评估导入的当前运行状况。

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

daily_summaries
过去 7 天的导入请求的successful_count、failed_count 和 pending_count，按导入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 的导入流程最近停止运行。

  • 如需确定是否有特定导入日期或作业发送了大量无法处理的事件，请检查 daily_summaries 和 job_summaries 的 successful_count、failed_count 和 pending_count。 处于待处理状态的任何事件可能需要长达 24 小时才能完成。

如需详细了解如何改进线下数据诊断，请访问帮助中心。

限制

在检索导入摘要时，请注意以下事项：

  • 只有当 searchStream 或 search 请求的 customer_id 与您最近用于导入转化的客户相同时，Google Ads API 才会返回线下数据诊断信息。

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

  • Google Ads 会将增强型潜在客户转化数据导入中的 CLICK_NOT_FOUND 错误视为警告。因此，如果 alerts 包含此错误的条目，相应操作仍会被视为成功，并包含在 successful_event_count 中。

上一页
自定义转化变量
下一页
报告