转化操作类别

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

线下转化

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

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

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

线上（网站）转化

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

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

The ConversionAction 包含多种类型的网站转化，这些转化在 API 中通过 type 字段在 TagSnippet 的 tag_snippets 字段中列出的每个 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	电话号码点击

应用转化

应用转化可让您跟踪 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

An 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 网页界面中显示为点击移动网站上的电话号码 转化。

The CLICK_TO_CALL type differs from the AD_CALL type in that it does not track actual phone calls. 相反，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。 展示促成 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

  您还可以从 the 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 方法将 ConversionActionService 的 ConversionAction 从 HIDDEN 更改为 ENABLED。status对于这些 转化操作，不支持更新 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）提供完整的结果。