- JSON 表示法
- ConversionActionStatus
- ConversionActionType
- ValueSettings
- ConversionActionCountingType
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FirebaseSettings
- ThirdPartyAppAnalyticsSettings
- GoogleAnalytics4Settings
一种转化操作。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resourceName |
不可变。转化操作的资源名称。转化操作资源名称采用以下格式:
|
status |
针对转化事件累计的此转化操作的状态。 |
type |
不可变。此转化操作的类型。 |
origin |
仅供输出。此转化操作的转化来源。 |
category |
为此转化操作报告的转化类别。 |
valueSettings |
与此转化操作相关联的转化事件的价值相关的设置。 |
countingType |
如何统计转化操作的转化事件。 |
attributionModelSettings |
与此转化操作的归因模型相关的设置。 |
tagSnippets[] |
仅供输出。用于跟踪转化情况的代码段。 |
mobileAppVendor |
仅供输出。应用转化操作的移动应用供应商。 |
firebaseSettings |
仅供输出。Firebase 转化类型的 Firebase 设置。 |
thirdPartyAppAnalyticsSettings |
仅供输出。针对第三方转化类型的第三方应用分析工具设置。 |
googleAnalytics4Settings |
仅供输出。适用于 Google Analytics(分析)4 转化类型的 Google Analytics(分析)4 设置。 |
id |
仅供输出。转化操作的 ID。 |
name |
转化操作的名称。 此字段是必填字段,在创建新的转化操作时不应为空。 |
primaryForGoal |
如果转化操作的 primaryForGoal 位为 false,则所有广告系列均无法针对转化操作出价,无论客户转化目标或广告系列转化目标为何。不过,自定义转化目标不会遵循 primaryForGoal 的标准,因此如果广告系列有一个自定义转化目标,该目标配置了 primaryForGoal = false 转化操作,则该转化操作仍然可出价。默认情况下,如果未设置,primaryForGoal 将为 true。在 V9 中, primaryForGoal 只能在创建后通过“update”操作设置为 false,因为它未声明为可选。 |
ownerCustomer |
仅供输出。转化操作所有者客户的资源名称,如果这是系统定义的转化操作,则返回 null。 |
includeInConversionsMetric |
是否应将此转化操作纳入到“转化次数”指标中。 |
clickThroughLookbackWindowDays |
互动(例如点击)和转化事件之间可能经过的最大天数。 |
viewThroughLookbackWindowDays |
从展示到转化(无互动)之间可能经过的最大天数。 |
phoneCallDurationSeconds |
来电时长(以秒为单位),超过此时长后应针对此转化操作报告转化。 该值必须介于 0 和 10000 之间(含 0 和 10000)。 |
appId |
应用转化操作的应用 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 |
当发送此转化操作的转化事件时包含无效、不允许使用或缺失的转化价值,或者此转化操作配置为始终使用默认值时,应使用此值。 |
defaultCurrencyCode |
在以下情况下使用的货币代码:此转化操作的转化事件在发送时货币代码无效或缺失,或此转化操作配置为始终使用默认值。 |
alwaysUseDefaultValue |
控制是否使用默认价值和默认货币代码来代替相应转化操作的转化事件中指定的价值和货币代码。 |
ConversionActionCountingType
指明如何统计此操作的转化。有关详情,请参阅 https://support.google.com/google-ads/answer/3438531。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ONE_PER_CLICK |
对每次点击仅统计一次转化。 |
MANY_PER_CLICK |
统计每次点击的所有转化。 |
AttributionModelSettings
与此转化操作的归因模型相关的设置。
JSON 表示法 |
---|
{ "attributionModel": enum ( |
字段 | |
---|---|
attributionModel |
此转化操作的归因模型类型。 |
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 |
仅供输出。转化的 Google Analytics(分析)媒体资源 ID。 |
propertyName |
仅供输出。转化的 GA 媒体资源名称。 |
eventName |
仅供输出。Firebase 转化的事件名称。 |
projectId |
仅供输出。转化的 Firebase 项目 ID。 |
ThirdPartyAppAnalyticsSettings
与第三方应用分析转化操作相关的设置。
JSON 表示法 |
---|
{ "providerName": string, "eventName": string } |
字段 | |
---|---|
providerName |
仅供输出。第三方应用分析工具的名称。 |
eventName |
仅供输出。第三方应用分析工具转化的事件名称。 |
GoogleAnalytics4Settings
与 Google Analytics(分析)4 转化操作相关的设置。
JSON 表示法 |
---|
{ "eventName": string, "propertyName": string, "propertyId": string } |
字段 | |
---|---|
eventName |
仅供输出。GA4 事件的名称。 |
propertyName |
仅供输出。GA4 媒体资源的名称。 |
propertyId |
仅供输出。GA4 媒体资源的 ID。 |