ConversionAction

一种转化操作。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
字段
resourceName

string

不可变。转化操作的资源名称。转化操作资源名称采用以下格式：

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

针对转化事件累计的此转化操作的状态。
type

enum (ConversionActionType)

不可变。此转化操作的类型。
origin

enum (ConversionOrigin)

仅供输出。此转化操作的转化来源。
category

enum (ConversionActionCategory)

针对此转化操作报告的转化类别。
valueSettings

object (ValueSettings)

与此转化操作相关联的转化事件的价值相关的设置。
countingType

enum (ConversionActionCountingType)

如何统计转化操作的转化事件。
attributionModelSettings

object (AttributionModelSettings)

与此转化操作的归因模型相关的设置。
tagSnippets[]

object (TagSnippet)

仅供输出。用于跟踪转化情况的代码段。
mobileAppVendor

enum (MobileAppVendor)

仅供输出。一项应用转化操作的移动应用供应商。
firebaseSettings

object (FirebaseSettings)

仅供输出。Firebase 转化类型的 Firebase 设置。
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

仅供输出。适用于第三方转化类型的第三方应用分析工具设置。
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

仅供输出。适用于 Google Analytics（分析）4 转化类型的 Google Analytics（分析）4 设置。
id

string (int64 format)

仅供输出。转化操作的 ID。
name

string

转化操作的名称。

此字段是必填字段，在创建新的转化操作时不应为空。
primaryForGoal

boolean

如果转化操作的 primaryForGoal 位为 false，则所有广告系列都无法针对该转化操作出价，无论其客户转化目标或广告系列转化目标为何。不过，自定义转化目标不考虑 primaryForGoal ，因此，如果广告系列有一个自定义转化目标，其配置是 primaryForGoal = false 转化操作，则该转化操作仍是可出价的。默认情况下，如果未设置，primaryForGoal 将为 true。在 V9 中，primaryForGoal 只能在创建后通过“更新”操作设置为 false，因为它未声明为可选。
ownerCustomer

string

仅供输出。转化操作所有者客户的资源名称，如果这是系统定义的转化操作，则为 null。
includeInConversionsMetric

boolean

是否应将此转化操作纳入到“转化次数”指标中。
clickThroughLookbackWindowDays

string (int64 format)

互动（例如点击）和转化事件之间可能经过的最长天数。
viewThroughLookbackWindowDays

string (int64 format)

从广告展示到无互动转化之间可能经过的最长天数。
phoneCallDurationSeconds

string (int64 format)

来电时长（以秒为单位），超过此时长后系统应针对此转化操作报告转化。

该值必须介于 0 和 10000 之间（含 0 和 10000）。
appId

string

应用转化操作的应用 ID。

ConversionActionStatus

转化操作的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 系统会记录转化。
REMOVED 系统将不会记录转化。
HIDDEN 系统将不会记录转化次数，并且转化操作也不会显示在界面中。

ConversionActionType

转化操作的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AD_CALL 用户点击广告的附加电话信息后所发生的转化。
CLICK_TO_CALL 在移动设备上用户点击电话号码时发生的转化。
GOOGLE_PLAY_DOWNLOAD 用户从 Google Play 商店下载移动应用时发生的转化。
GOOGLE_PLAY_IN_APP_PURCHASE 用户通过 Android 结算服务在应用内购物时发生的转化。
UPLOAD_CALLS 由广告客户跟踪并上传的致电转化数据。
UPLOAD_CLICKS 由广告客户跟踪且通过归因点击上传的转化。
WEBPAGE 网页上发生的转化。
WEBSITE_CALL 当用户从广告客户的网站拨打动态生成的电话号码时，发生的转化。
STORE_SALES_DIRECT_UPLOAD 基于第一方或第三方商家数据上传的实体店销售转化。只有许可名单中的客户才能使用实体店销售直接上传类型。
STORE_SALES 基于第一方或第三方商家数据上传的实体店销售转化以及/或者使用付款网络的卡片进行的实体店购买。只有许可名单中的客户才能使用实体店销售类型。只读。
FIREBASE_ANDROID_FIRST_OPEN 通过 Firebase 跟踪的 Android 应用首次打开转化次数。
FIREBASE_ANDROID_IN_APP_PURCHASE 通过 Firebase 跟踪的 Android 应用应用内购买转化次数。
FIREBASE_ANDROID_CUSTOM 通过 Firebase 跟踪 Android 应用自定义转化。
FIREBASE_IOS_FIRST_OPEN 通过 Firebase 跟踪的 iOS 应用首次打开转化次数。
FIREBASE_IOS_IN_APP_PURCHASE 通过 Firebase 跟踪的 iOS 应用内购买转化情况。
FIREBASE_IOS_CUSTOM 通过 Firebase 跟踪 iOS 应用自定义转化。
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN 通过第三方应用分析工具跟踪的 Android 应用首次打开转化次数。
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE 通过第三方应用分析工具跟踪的 Android 应用内购买转化情况。
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM 通过第三方应用分析工具跟踪 Android 应用自定义转化。
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN 通过第三方应用分析工具跟踪的 iOS 应用首次打开转化次数。
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE 通过第三方应用分析工具跟踪的 iOS 应用内购买转化情况。
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM 通过第三方应用分析工具跟踪的 iOS 应用自定义转化。
ANDROID_APP_PRE_REGISTRATION 用户通过 Google Play 商店预注册移动应用时发生的转化。只读。
ANDROID_INSTALLS_ALL_OTHER_APPS 跟踪所有未按应用类型跟踪的 Google Play 下载次数的转化。只读。
FLOODLIGHT_ACTION 此 Floodlight 活动用于统计用户在查看或点击广告客户的某个广告后访问特定网页的次数。只读。
FLOODLIGHT_TRANSACTION 用于跟踪完成的销售次数或购买的商品数的 Floodlight 活动。还可以捕获每次销售的总金额。只读。
GOOGLE_HOSTED 用于跟踪用户与广告互动后用户在 Google 产品和服务中完成本地操作的转化。只读。
LEAD_FORM_SUBMIT 当用户提交潜在客户表单时报告的转化次数。只读。
SALESFORCE 来自 Salesforce 的转化。只读。
SEARCH_ADS_360 从 Search Ads 360 Floodlight 数据导入的转化数据。只读。
SMART_CAMPAIGN_AD_CLICKS_TO_CALL 在未设置来电跟踪的情况下，使用智能广告系列自定义条件在智能广告系列中发生的来电转化。只读。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL 用户点击 Google 地图内的通话元素。仅限智能广告系列。只读。
SMART_CAMPAIGN_MAP_DIRECTIONS 用户在 Google 地图中请求前往某个营业地点的路线。仅限智能广告系列。只读。
SMART_CAMPAIGN_TRACKED_CALLS 使用智能广告系列自定义条件，在设置了来电跟踪的智能广告系列中发生的来电转化。只读。
STORE_VISITS 用户访问广告客户的零售店时发生的转化。只读。
WEBPAGE_CODELESS 根据网站事件（例如表单提交或网页加载）创建的转化（未使用单独编码的事件代码段）。只读。
UNIVERSAL_ANALYTICS_GOAL 来自关联的 Universal Analytics 目标的转化。
UNIVERSAL_ANALYTICS_TRANSACTION 来自关联的 Universal Analytics 交易的转化。
GOOGLE_ANALYTICS_4_CUSTOM 来自关联的 Google Analytics（分析）4 自定义事件转化的转化。
GOOGLE_ANALYTICS_4_PURCHASE 关联的 Google Analytics（分析）4 购买转化带来的转化。

ValueSettings

与此转化操作相关联的转化事件的价值相关的设置。

JSON 表示法 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
字段
defaultValue

number

当发送此转化操作的转化事件时包含无效、不允许使用或缺失的值时，或者此转化操作被配置为始终使用默认值时，要使用的值。
defaultCurrencyCode

string

当发送此转化操作的转化事件但货币代码无效或缺失时，或此转化操作被配置为始终使用默认价值时，要使用的货币代码。
alwaysUseDefaultValue

boolean

控制是否使用默认价值和默认货币代码来代替转化操作的转化事件中指定的价值和货币代码。

ConversionActionCountingType

指明如何统计此操作的转化。有关详情，请参阅 https://support.google.com/google-ads/answer/3438531。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ONE_PER_CLICK 每次点击只计为一次转化。
MANY_PER_CLICK 计算每次点击的所有转化次数。

AttributionModelSettings

与此转化操作的归因模型相关的设置。

JSON 表示法 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
字段
attributionModel

enum (AttributionModel)

此转化操作的归因模型类型。
dataDrivenModelStatus

enum (DataDrivenModelStatus)

仅供输出。转化操作的以数据为依据的归因模型的状态。

AttributionModel

此归因模型描述如何在之前可能发生的多次互动之间分配特定转化的功劳。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EXTERNAL 使用外部归因模型。
GOOGLE_ADS_LAST_CLICK 将转化功劳全部归于其最终点击。
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK 使用 Google 搜索归因模型，将转化功劳全部归于首次点击。
GOOGLE_SEARCH_ATTRIBUTION_LINEAR 使用 Google 搜索归因，将转化功劳平均分配给其所有点击。
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY 利用 Google 搜索归因模型，可将转化功劳成倍地分配给最近的点击（半衰期为 1 周）。
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 将转化功劳的 40% 分配给首次点击和最终点击。将剩余的 20% 平均分配给其他所有点击。为此，我们需要使用 Google 搜索归因模型。
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN 一种灵活的模型，采用 Google 搜索归因模型，利用机器学习技术，确定在点击之间合理分配功劳。

DataDrivenModelStatus

枚举数据驱动型模型的状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AVAILABLE 可以使用以数据为依据的归因模型。
STALE 以数据为依据的模型已过时。至少有 7 天未更新。它仍在使用，但如果在 30 天内未更新，就会过期。
EXPIRED 这个以数据为依据的模型已过期。至少有 30 天未更新，因此无法使用。最常见的原因是最近 30 天内未达到所需的事件数量。
NEVER_GENERATED 系统从未生成过以数据为依据的模型。最常见的原因是，在任何 30 天内都从未获得过所需的事件数量。

FirebaseSettings

与 Firebase 转化操作相关的设置。

JSON 表示法 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
字段
propertyId

string (int64 format)

仅供输出。转化的 Google Analytics（分析）媒体资源 ID。
propertyName

string

仅供输出。转化的 GA 媒体资源名称。
eventName

string

仅供输出。Firebase 转化的事件名称。
projectId

string

仅供输出。转化的 Firebase 项目 ID。

ThirdPartyAppAnalyticsSettings

与第三方应用分析工具转化操作相关的设置。

JSON 表示法 
{
  "providerName": string,
  "eventName": string
}
字段
providerName

string

仅供输出。第三方应用分析工具提供商的名称。
eventName

string

仅供输出。第三方应用分析工具转化的事件名称。

GoogleAnalytics4Settings

与 Google Analytics（分析）4 转化操作相关的设置。

JSON 表示法 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
字段
eventName

string

仅供输出。GA4 事件的名称。
propertyName

string

仅供输出。GA4 媒体资源的名称。
propertyId

string (int64 format)

仅供输出。GA4 媒体资源的 ID。