转化报告

您可以通过检索有关特定转化操作的数据,或检索其他资源(例如广告系列、广告组和广告)的转化指标,在 Google Ads API 中生成转化报告。本指南介绍了如何检索该信息,以及 Google Ads 界面指标如何映射到 Google Ads API 指标

检索有关特定转化操作的数据

您可以使用 conversion_action 资源检索现有转化操作的详细信息。

例如,以下查询会检索所有转化操作的名称、类型和状态:

SELECT
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.status
FROM conversion_action

查看conversion_action资源中可用的所有字段,或使用 Google Ads 查询构建器开始构建自己的查询。

检索其他资源的转化指标

在查询其他资源(如 keyword_viewad_group)时,您可以按 conversion_action 进行细分并检索转化指标,如 conversionsall_conversions

例如,以下查询会检索广告系列的 conversionsconversions_value 指标,并按 conversion_action 进行细分:

SELECT
  campaign.name,
  segments.conversion_action,
  metrics.conversions,
  metrics.conversions_value
FROM campaign

请注意,某些与转化相关的字段(例如 segments.conversion_or_adjustment_lag_bucket 和其他指标字段)可能不会出现在所有报告中。如需查看兼容字段的完整列表,请查看相应的资源页面。

常见问题

我的数据不是最新的。
查看转化数据时请注意,效果数据并非实时提供。如需了解转化数据新鲜度,请参阅 Google Ads 数据新鲜度指南。
我的报告是空的。
不会返回指标均为零的报告中的行(例如对于新的转化操作)。
我无法通过 Google Ads API 访问自定义列。
Google Ads API 不支持自定义列,因此无法在报告中检索。

映射界面指标

使用 Google Ads 界面查看广告系列时,您可能会看到大量列,这些列对应于 Google Ads API 中的指标。下表汇总了界面中的与 API 中的等效指标之间的映射。

界面 API
所有转化次数 metrics.all_conversions
所有转化次数(按转化时间) metrics.all_conversions_by_conversion_date
所有转化率 metrics.all_conversions_value
所有转化价值/费用 metrics.all_conversions_value_per_cost
所有转化价值(按转化时间) metrics.all_conversions_value_by_conversion_date
转化次数 metrics.conversions
转化次数(按转化时间) metrics.conversions_by_conversion_date
转化次数(当前模型) metrics.current_model_attributed_conversions
转化率 metrics.conversions_from_interactions_rate
转化率(当前模型) metrics.current_model_attributed_conversions_from_interactions_rate
转化价值 metrics.conversions_value
转化价值(按转化时间) metrics.conversions_value_by_conversion_date
转化价值(当前模型) metrics.current_model_attributed_conversions_value
转化价值/费用 metrics.conversions_value_per_cost
转化价值/费用(当前模型) metrics.current_model_attributed_conversions_value_per_cost
每次点击的转化价值 metrics.all_conversions_from_interactions_value_per_interaction
每次点击的转化价值(当前模型) metrics.current_model_attributed_conversions_from_interactions_value_per_interaction
费用/所有转化次数 metrics.cost_per_all_conversions
每次转化费用 metrics.cost_per_conversion
每次转化费用(当前模型) metrics.cost_per_current_model_attributed_conversion
跨设备转化次数 metrics.cross_device_conversions
SKAdNetwork 安装次数 metrics.sk_ad_network_installs
SKAdNetwork 总转化次数 metrics.sk_ad_network_total_conversions
实体店光顾 metrics.all_conversions_from_store_visit
价值/所有转化次数 metrics.value_per_all_conversions
价值/所有转化次数(按转化时间) metrics.value_per_all_conversions_by_conversion_date
每次转化价值 metrics.value_per_conversion
每次转化价值(按转化时间) metrics.value_per_conversions_by_conversion_date
每次转化价值(当前模型) metrics.value_per_current_model_attributed_conversion
浏览型转化次数 metrics.view_through_conversions