监控离线数据诊断信息

使用 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 界面进行了导入，则结果会包含 client 值分别为 GOOGLE_ADS_API 和 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 界面进行了导入，则结果会包含 client 值分别为 GOOGLE_ADS_API 和 GOOGLE_ADS_WEB_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 小时才能完成。

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

限制

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

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

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

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

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