转化操作类别

本指南列出了您可以使用 Google Ads API 创建的不同类型的转化操作，并介绍了这些操作如何映射到 Google Ads 网页界面。

选择合适的转化操作类型

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

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

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

2. 线下转化：

   • 是电话吗？

     • 是：使用

       来电转化数据导入 (UPLOAD_CALLS)，用于跟踪来电结果。

   • 是实体店销售吗？

     • 是：使用

       实体店销售转化 (STORE_SALES)。

   • 是网站访问促成的线下销售或潜在客户进展吗？

     • 是：使用 Data Manager API 启用增强型潜在客户转化（推荐），或参阅管理线下点击转化，了解现有的 Google Ads API 集成。（注意：自 2026 年 6 月 15 日起，只有之前上传过线下点击转化数据的开发者令牌才能使用 UploadClickConversions 上传点击转化数据）。

3. 线上（网站）转化：

   • 您想跟踪网页加载（购买、收据）还是用户点击？
     • 是：使用网站转化，并将代码段设置为 WEBPAGE 或 WEBPAGE_ONCLICK。

   • 您是否想跟踪用户拨打您网站上列出的电话号码的次数？

     • 跟踪实际通话时长？

       • 是：使用

         网站来电 (WEBSITE_CALL)，使用动态 Google 转接电话号码和代码事件代码段。

       • 否（仅跟踪移动网站上的按钮/链接点击次数）？使用

         点击您的手机号码 (CLICK_TO_CALL)。

4. 移动应用转化：

   • 仅跟踪来自 Google Play 商店的安装或购买是否足够？
     • 是：使用应用转化（GOOGLE_PLAY_DOWNLOAD 或 GOOGLE_PLAY_IN_APP_PURCHASE）。

   • 您是否使用 Google Analytics (GA4) 或第三方应用 分析工具跟踪应用操作？

     • 是：使用

       Firebase 和第三方应用分析工具（通过启用 FIREBASE_* 或 THIRD_PARTY_* 转化操作）。

线下转化次数

警告： 自 2026 年 6 月 15 日起，如果开发者令牌之前未发送过上传线下转化数据或增强型潜在客户转化数据的请求，UploadClickConversions 请求将会失败。请改用 Data Manager API；如需了解详情，请参阅弃用的功能。

注意： 开发者令牌已被弃用，取而代之的是 Google Cloud 项目，但此历史访问权限限制仍然有效。

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

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

转化操作类型	Google Ads 来源	API 设置指南
UPLOAD_CLICKS	跟踪点击带来的转化和增强型潜在客户转化	使用 Data Manager API（推荐），或参阅管理线下点击转化，了解现有的 Google Ads API 集成
UPLOAD_CALLS	跟踪致电后发生的转化	导入来电转化数据指南
STORE_SALES	跟踪实体店销售转化	如需了解详情，请参阅实体店销售：导入到具有报告功能的转化操作

线上（网站）转化

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

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

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	电话号码点击

注意： WEBPAGE 和 WEBPAGE_ONCLICK 与网站具有相同的来源。区别在于网页界面中的事件代码段选项。WEBPAGE 对应于此选项的网页加载，而 WEBPAGE_ONCLICK 对应于点击。如需了解详情，请参阅这篇帮助中心文章。

应用转化次数

通过应用转化，您可以跟踪来自 Google Play 商店的移动应用安装或应用内购。

下表显示了 Google Ads 网页界面中每个来源对应的 ConversionActionType API 参数：

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

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

注意： 如果您还要指定 category 字段，请仅在转化类型为 GOOGLE_PLAY_DOWNLOAD 时将其设置为 DOWNLOAD。

致电转化

来电转化跟踪可让您跟踪直接从广告中拨打的来电、通过网站上的电话号码来电以及在移动网站上点击电话号码。

下表显示了 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 转接电话号码跟踪来电时，此功能非常有用。

增强型转化

警告： 自 2026 年 6 月 15 日起，如果开发者令牌之前未发送过上传线下转化数据或增强型潜在客户转化数据的请求，UploadClickConversions 请求将会失败。请改用 Data Manager API；如需了解详情，请参阅弃用的功能。

注意： 开发者令牌已被弃用，取而代之的是 Google Cloud 项目，但此历史访问权限限制仍然有效。

增强型转化功能可利用邮箱、姓名、住址和电话号码等第一方转化数据来补充现有转化跟踪代码，从而提高转化衡量的准确性。

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

转化操作类型	增强型转化类型	API 设置指南
UPLOAD_CLICKS	增强型潜在客户转化 提高来自网站潜在客户或访问者的线下交易的衡量准确性	使用 Data Manager API（推荐），或参阅管理线下点击转化，了解现有的 Google Ads API 集成
WEBPAGE	增强型网站转化 提高线上转化的衡量准确性	API 设置指南

其他转化操作类型

Google Ads API 会在报告中提供其他类型的转化操作，但可能会限制或禁止创建或修改这些操作。您可以使用 GoogleAdsService 查询转化操作及其类型：

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

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 广告联盟 安装的广告是在对应的应用 ID 中展示的。
segments.sk_ad_network_source_domain	促成 iOS Store Kit 广告联盟安装的广告是在哪个网站上展示的。null 值表示此细分不适用（例如，非 iOS 广告系列），或者未出现在 Apple 发送的任何回传中。
segments.sk_ad_network_source_type	促成 iOS Store Kit 广告联盟安装的广告是在哪种类型的来源中展示的。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 媒体资源转化进行以下更改：

• 通过将转化操作的 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_APP_AD_IMPRESSION
• FIREBASE_ANDROID_FIRST_OPEN
• FIREBASE_ANDROID_IN_APP_PURCHASE
• FIREBASE_ANDROID_CUSTOM
• FIREBASE_IOS_APP_AD_IMPRESSION
• 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

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

重要提示： 将实体店销售工作流程升级到 Data Manager API，可获享更好的开发者体验并使用更多功能。我们不建议使用 Google Ads API 实现新的实体店销售工作流程。

虽然您无法使用 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 等关键转化指标提供完整的结果。