使用 Google Ads API 检索线下数据诊断,其中包含有关转化数据上传和调整流程整体运行状况的信息。
如需检索您账号的最新线下数据诊断信息,请使用以下资源之一:
offline_conversion_upload_client_summary
在账号一级汇总上传诊断信息。offline_conversion_upload_conversion_action_summary
(仅适用于 v17 或更高版本)汇总了转化操作一级的上传诊断信息。
账号级诊断
如需检索账号级转化上传诊断信息,请使用以下 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
中。