监控离线数据诊断信息

使用 Google Ads API 检索离线数据诊断，其中包含有关转化数据上传和调整过程的整体运行状况的信息。

如需检索您帐号的最新离线数据诊断信息，请使用 GoogleAdsService 发送针对 offline_conversion_upload_client_summary 资源的以下查询：

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.resource_name,
  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 分别对应的条目。

每个 OfflineConversionUploadClientSummary 都有一个 status 字段，反映 client 的上传整体运行状况。它还包含收到的事件总数、成功处理的事件数，以及提供错误摘要（按 OfflineConversionError 分组）的 alerts 字段。所有这些字段都包含来自最近一个完整日历日的上传信息。您可以利用这些信息来评估上传内容的当前状况。

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

daily_summaries
过去 7 天内的上传请求的 successful_count 和 failed_count，按上传请求 date 分组。
job_summaries

最近的 7 个上传请求中的 successful_count 和 failed_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，以确定是否有某个特定的上传日期或作业发送了大量未成功处理的事件。

限制

检索上传摘要时，请注意以下几点：

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

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

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

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