转化操作类别

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

选择合适的转化操作类型

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

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

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

2. 线下转化：

   • 是电话吗？

     • 是： 使用

       来电转化导入 (UPLOAD_CALLS) 来跟踪 来电结果。

   • 是实体店销售吗？

     • 是： 使用

       实体店销售转化 (STORE_SALES)。

   • 是因访问网站而产生的线下销售或潜在客户转化吗？

     • 是： 使用 增强型潜在客户转化 使用 Data Manager API。 （注意：自 2026 年 6 月 15 日起，使用 UPLOAD_CLICKS 或 UploadClickConversion 上传点击转化已遭弃用）。

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 日 起， UploadClickConversion 请求将会失败，如果开发者 令牌之前未发送过上传线下转化或 增强型潜在客户转化的请求。请改用 Data Manager API ；如需了解详情，请参阅功能弃用。

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

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

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

转化操作类型	Google Ads 来源	API 设置指南
UPLOAD_CLICKS	跟踪点击带来的转化和增强型潜在客户转化	使用 Data Manager API
UPLOAD_CALLS	跟踪致电转化	导入来电转化指南
STORE_SALES	跟踪实体店销售转化	如需了解详情，请参阅实体店销售：导入到转化操作并生成 报告

线上（网站）转化

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

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

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

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

A 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 日 起， UploadClickConversion 请求将会失败，如果开发者 令牌之前未发送过上传线下转化或 增强型潜在客户转化的请求。请改用 Data Manager API ；如需了解详情，请参阅功能弃用。

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

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

下表显示了与每个 增强型转化类型等效的 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 媒体资源导入到 Google Ads 账号，方法是将转化的 status 字段从 HIDDEN 修改为 ENABLED。
• 修改其 primary_for_goal 和 category 字段，以 指明其应如何影响 Google Ads 出价和报告。
• 更新转化的 name 或 value_settings。
• 使用 remove 操作从 Google Ads 账号中移除转化。

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

Firebase 和第三方应用分析工具

如需导入 第三方应用分析工具 或 Firebase 转化，请使用 mutate 方法将 ConversionAction 的 status 从 HIDDEN 更改为 ENABLED。ConversionActionService这些转化操作不支持更新 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

实体店销售：导入到转化操作并生成报告

重要提示： 将实体店销售 工作流程升级到 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）提供 完整的结果。