转化报告

您可以通过检索有关特定转化操作的数据,或检索其他资源(例如广告系列、广告组和广告)的转化指标,在 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_view和ad_group)时,您可以按conversion_action进行细分,并检索转化指标(例如 conversions和all_conversions)。

例如,以下查询会检索过去 30 天内广告系列的 conversions 和 conversions_value 指标, 并按 conversion_action 进行细分:

SELECT
  campaign.name,
  segments.conversion_action,
  metrics.conversions,
  metrics.conversions_value
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

某些与转化相关的字段(例如 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_from_interactions_rate
所有转化次数价值 / 费用 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.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