监控离线数据诊断信息

使用 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 中。

上一页
转化价值规则
下一页
报告