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