转化操作类别

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

选择合适的转化操作类型

为了帮助您为集成选择正确的转化操作类型和设置指南，请使用以下决策路径：

  1. 转化事件发生在何处？

    • 在线下 （例如在您的办公室、营业 地点或通过电话）：请前往第 2 步 。
    • 直接在您的网站上 （例如网站购买、注册或表单提交）：请前往第 3 步。
    • 在移动应用内：请前往第 4 步。
    • 通过直接从您的广告拨出的电话：使用来自 广告的致电 (AD_CALL) （使用CallAsset）。

  2. 线下转化：

    • 是电话吗？
    • 是实体店销售吗？
    • 是因访问网站而促成的线下销售或潜在客户转化吗？
      • 是： 使用 增强型潜在客户转化 使用 Data Manager API。 （注意：自 2026 年 6 月 15 日起，系统已弃用使用 UPLOAD_CLICKS 或 UploadClickConversion 上传点击转化数据的功能）。

  3. 线上（网站）转化：

    • 您想跟踪网页加载（购买、收据）还是用户点击？
      • 是： 使用网站转化 ，并将代码段设置 为 WEBPAGE 或 WEBPAGE_ONCLICK。
    • 您想跟踪由网站上列出的电话号码促成的来电吗？

  4. 移动应用转化：

    • 跟踪 Google Play 商店中的安装或购买是否足够？
      • 是： 使用应用转化 （GOOGLE_PLAY_DOWNLOAD 或 GOOGLE_PLAY_IN_APP_PURCHASE）。
    • 您是否使用 Google Analytics (GA4) 或第三方应用分析工具跟踪应用操作？

线下转化

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

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

转化操作类型 Google Ads 来源 API 设置指南
UPLOAD_CLICKS 跟踪点击带来的转化和增强型潜在客户转化 使用 Data Manager API
UPLOAD_CALLS 跟踪致电带来的转化 导入来电转化数据指南
STORE_SALES 跟踪实体店销售转化 导入实体店销售转化数据指南

线上（网站）转化

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

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

ConversionAction 包含多种类型的网站转化，这些转化在 API 中通过每个 TagSnippet 的 type 字段进行区分，这些 TagSnippet 列在 ConversionAction 的 tag_snippets 字段中。

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

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

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

CLICK_TO_CALL

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

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

增强型转化

增强型转化有助于您通过使用第一方 转化数据（例如电子邮件地址、姓名、住址和电话号码）补充现有转化代码，从而提高转化 衡量的准确性。

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

转化操作类型 增强型转化类型 API 设置指南
UPLOAD_CLICKS 增强型潜在客户转化
有助于更好地衡量网站潜在客户或 访问者在线下的交易情况 		使用 Data Manager API
WEBPAGE 增强型网站转化
有助于更好地衡量线上转化 		API 设置指南

其他转化操作类型

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

SKAdNetwork 转化

如果您投放 iOS 应用广告系列 并已实现 SKAdNetwork，则可以使用以下资源访问在 Customer 和 Campaign 级提供给 Google 的 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 Ad Network 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）提供完整的结果。

上一页
概览
下一页
开始使用转化