转化操作类别

本指南列出了您可以使用 Google Ads API 创建的不同类型的转化操作，并介绍了这些转化操作与 Google Ads 网页界面的对应关系。

线下转化次数

线下转化有助于您跟踪线下发生的转化事件，例如在您的办公室、营业地点或通过电话发生的转化事件。

下表显示了与 Google Ads 界面中的每个来源等效的 ConversionActionType API 参数，以及指向每种特定转化操作类型文档的链接：

转化操作类型 Google Ads 来源 API 设置指南
UPLOAD_CLICKS 跟踪点击带来的转化和增强型潜在客户转化 管理线下点击转化指南
增强型潜在客户转化指南
UPLOAD_CALLS 跟踪致电后发生的转化 来电转化数据导入指南
STORE_SALES 跟踪实体店销售转化 实体店销售转化数据导入指南

线上（网站）转化

通过网站转化，您可以跟踪网站操作，例如在线销售、链接点击、网页浏览和注册。

如需跟踪网站上的转化，您必须创建一个将 ConversionActionType 设置为 WEBPAGE 的ConversionAction，并将一段称为代码的代码段添加到网站上的转化网页。

ConversionAction 涵盖多种类型的网站转化，这些转化在 API 中通过每个 ConversionAction 的 tag_snippets 字段中列出的 TagSnippet 中的 type 字段来区分。

TagSnippet 提供必须包含在网站中的跟踪代码，以便跟踪转化操作。 网站和电话号码点击转化需要 event_snippet 和 global_site_tag，应该将前者放置在表明完成转化操作的网页（如结算确认页或潜在客户表单提交页）上，同时必须将后者添加到您网站的每个网页上。您可以使用 ConversionActionService 检索这两个属性。如需详细了解如何标记网页，请访问我们的帮助中心。

下表显示了与 Google Ads 界面中的每个来源等效的 API 参数：

跟踪代码类型 Google Ads 来源
WEBPAGE 网站、网站 (Google Analytics (GA4))
WEBPAGE_ONCLICK 网站、网站 (Google Analytics (GA4))
CLICK_TO_CALL 电话号码点击

应用转化次数

应用转化可让您跟踪来自 Google Play 商店的移动应用安装或应用内购买。

下表显示了与 Google Ads 界面中的每个来源等效的 ConversionActionType API 参数：

转化操作类型 Google Ads 来源
GOOGLE_PLAY_DOWNLOAD Google Play > 安装量
GOOGLE_PLAY_IN_APP_PURCHASE Google Play > 应用内购

如需使用 Google Analytics 4 媒体资源或第三方应用分析工具跟踪其他移动应用操作，请参阅其他转化操作类型。

致电转化

借助来电转化跟踪，您可以跟踪通过广告致电的次数、拨打您网站上电话号码的次数，以及在移动网站上点击电话号码的次数。

下表显示了与 Google Ads 界面中的每个来源等效的 ConversionActionType API 参数：

转化操作类型 Google Ads 来源
AD_CALL 从带附加电话信息的广告或来电专用广告中致电
WEBSITE_CALL 用户拨打您网站上的电话号码的次数
CLICK_TO_CALL 点击移动网站上的电话号码

AD_CALL

AD_CALL转化操作在 Google Ads 网页界面中显示为广告带来的来电转化。创建 AD_CALL 转化操作后，在创建 CallAsset 时，请在 call_conversion_action 字段中指定其资源名称。借助电话素材资源，您可以在广告中直接显示电话号码。

如果致电的时长超过指定的持续时间，则该致电将报告为转化。 默认值是 60 秒。

WEBSITE_CALL

WEBSITE_CALL 转化操作在 Google Ads 网页界面中显示为网站来电转化。

与 AD_CALL 不同，此跟踪工具需要将 event_snippet 和 global_site_tag 添加到您的网站，以获取对您网站上列出的号码进行来电跟踪所需的动态 Google 转接电话号码。此外，您必须设置电话素材资源，并在客户、广告系列或广告组层级进行关联。

CLICK_TO_CALL

CLICK_TO_CALL转化操作在 Google Ads 网页界面中显示为点击移动网站上的电话号码转化。

CLICK_TO_CALL 类型与 AD_CALL 类型的区别在于，前者不跟踪实际的来电。而只跟踪移动设备上对电话号码的点击。CLICK_TO_CALL如果无法使用 Google 转接电话号码跟踪来电，这将非常有用。

增强型转化

增强型转化功能可让您通过以下方式提高转化衡量的准确性：使用电子邮件地址、姓名、住址和电话号码等第一方转化数据来补充现有转化跟踪代码。

下表显示了与每种增强型转化类型等效的 API 参数：

转化操作类型 增强型转化类型 API 设置指南
UPLOAD_CLICKS 增强型潜在客户转化
有助于更准确地衡量网站潜在客户或访问者在线下的交易情况 		API 设置指南
WEBPAGE 针对网站的增强型转化
提高线上转化的衡量准确性 		API 设置指南

其他转化操作类型

Google Ads API 会在报告中提供其他类型的转化操作，但可能会限制或禁止创建或修改这些操作。

SKAdNetwork 转化次数

如果您投放 iOS 应用广告系列并已实现 SKAdNetwork，则可以使用以下资源访问 Google 收到的 Customer 和 Campaign 级 SKAdNetwork 数据：

报告字段 说明
metrics.sk_ad_network_installs Apple 报告的安装次数。此指标只能按 segments.sk_ad_network_conversion_value 和与日期相关的细分受众群的任意组合进行细分。
metrics.sk_ad_network_total_conversions 转化总次数，包括 Apple 报告的安装次数和其他类型的转化次数。此指标只能按与 SKAdNetwork 相关的细分和与日期相关的细分进行细分。
segments.sk_ad_network_ad_event_type 特定转化发生的事件类型。
segments.sk_ad_network_attribution_credit 特定转化的归因功劳。
segments.sk_ad_network_fine_conversion_value

Apple 报告的转化价值。此细分无法应用于 metrics.sk_ad_network_installs 和 metrics.sk_ad_network_total_conversions 以外的任何指标，并且只能与日期相关的细分结合使用。

如果 Apple 报告的值为 0，则返回 0；否则不返回值。检查 字段是否存在，以区分这两种情况。
segments.sk_ad_network_coarse_conversion_value 单次转化的粗略价值。
segments.sk_ad_network_postback_sequence_index 特定转化的回发在序列中的位置。
segments.sk_ad_network_source_app.sk_ad_network_source_app_id 促成 iOS Store Kit Ad Network 安装的广告所展示的应用 ID。
segments.sk_ad_network_source_domain 促成 iOS Store Kit Ad Network 安装的广告所展示的网站。null 值表示相应细分不适用（例如，非 iOS 广告系列），或者 Apple 发送的任何回发中都不存在相应细分。
segments.sk_ad_network_source_type 促成 iOS Store Kit Ad Network 安装的广告的展示来源类型。null 值表示相应细分不适用（例如，非 iOS 广告系列），或者 Apple 发送的任何回发中均未包含来源网域或来源应用。
segments.sk_ad_network_user_type 促成特定转化的用户类型。
segments.sk_ad_network_redistributed_fine_conversion_value 此细分中的转化价值包括重新分配给转化价值的 null 值。此细分表示 Apple 返回的观测到的精细转化价值与 Google 根据模型估算的 null 值之和。
segments.sk_ad_network_version 所使用的 iOS Store Kit 广告网络 API 版本。

Google Analytics

来自关联的 Google Analytics 媒体资源的转化具有以下 type 值之一：

  • GA4 媒体资源转化：

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

    您还可以从 google_analytics_4_settings 字段中检索 GA4 媒体资源 ID、媒体资源名称和事件名称。

您可以对 GA4 媒体资源转化进行以下更改：

  • 通过将 GA4 媒体资源的 status 字段从 HIDDEN 修改为 ENABLED，将转化数据从 GA4 媒体资源导入到 Google Ads 账号中。
  • 修改其 primary_for_goal 和 category 字段，以指明该转化应如何影响 Google Ads 出价和报告。
  • 更新其 name 或 value_settings。
  • 使用 remove 操作从 Google Ads 账号中移除相应转化。

尝试修改导入的 GA4 转化或导入的 Universal Analytics 转化的任何其他属性都会导致 MUTATE_NOT_ALLOWED 错误。您只能使用 Google Ads 界面进行这些更改。

Firebase 和第三方应用分析工具

若要导入第三方应用分析工具或 Firebase 转化数据，请使用 ConversionActionService 的 mutate 方法将 ConversionAction 的 status 从 HIDDEN 更改为 ENABLED。对于这些转化操作，不支持更新 app_id。

  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • FIREBASE_IOS_FIRST_OPEN
  • FIREBASE_IOS_IN_APP_PURCHASE
  • FIREBASE_IOS_CUSTOM
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
  • THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
  • THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
  • THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

实体店销售：导入到具有报告功能的转化操作

虽然您无法使用 Google Ads API 创建 STORE_SALES 或 STORE_SALES_DIRECT_UPLOAD 转化操作，但该 API 支持导入实体店销售交易数据。

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

只读转化操作类型

以下转化操作类型在 Google Ads API 中为只读，仅用于报告。

  • ANDROID_APP_PRE_REGISTRATION
  • ANDROID_INSTALLS_ALL_OTHER_APPS
  • FLOODLIGHT_ACTION
  • FLOODLIGHT_TRANSACTION
  • GOOGLE_HOSTED
  • LEAD_FORM_SUBMIT
  • SALESFORCE
  • SEARCH_ADS_360
  • SMART_CAMPAIGN_AD_CLICKS_TO_CALL
  • SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
  • SMART_CAMPAIGN_MAP_DIRECTIONS
  • SMART_CAMPAIGN_TRACKED_CALLS
  • STORE_VISITS
  • WEBPAGE_CODELESS

未知

如果您的 Google Ads 账号包含其他类型的转化操作，您可能会发现查询和报告返回的转化操作的 ConversionAction.type 为 UNKNOWN。 该 API 不支持管理这些转化操作，但会在报告中返回这些转化操作，以便为关键转化指标（例如 metrics.conversions 和 metrics.conversions_value）提供完整的结果。

上一页
概览
下一页
使用入门