使用 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
的上传内容的总体运行状况。还包含收到的事件总数、已成功处理的事件数,以及提供错误摘要的 alerts
字段(按 OfflineConversionError
分组)。所有这些字段都包含最近一个完整日历日的上传信息。您可以使用这些信息来评估上传内容的当前运行状况。
此外,每个 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
中。