- JSON 表示法
- CampaignPrimaryStatus
- CampaignPrimaryStatusReason
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- LocalServicesCampaignSettings
- CategoryBid
- TravelCampaignSettings
- DiscoveryCampaignSettings
- RealTimeBiddingSetting
- NetworkSettings
- HotelSettingInfo
- DynamicSearchAdsSetting
- ShoppingSetting
- AudienceSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- LocalCampaignSetting
- LocationSourceType
- AppCampaignSetting
- AppCampaignBiddingStrategyGoalType
- AppCampaignAppStore
- CampaignExperimentType
- FrequencyCapEntry
- FrequencyCapKey
- FrequencyCapLevel
- FrequencyCapEventType
- VanityPharma
- VanityPharmaDisplayUrlMode
- VanityPharmaText
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- PaymentMode
- PerformanceMaxUpgrade
- PerformanceMaxUpgradeStatus
- ListingType
- AssetAutomationSetting
- AssetAutomationType
- AssetAutomationStatus
- 佣金
- ManualCpa
- ManualCpc
- ManualCpm
- ManualCpv
- PercentCpc
- TargetCpm
- TargetCpmTargetFrequencyGoal
广告系列。
JSON 表示法 |
---|
{ "resourceName": string, "primaryStatus": enum ( |
字段 | |
---|---|
resourceName |
不可变。广告系列的资源名称。广告系列资源名称采用以下格式:
|
primaryStatus |
仅限输出。广告系列的主要状态。 让您深入了解广告系列未能投放或未实现最佳投放的原因。对广告系列及其相关实体所做的修改可能需要一段时间才能反映在此状态中。 |
primaryStatusReasons[] |
仅限输出。广告系列的主要状态原因。 让您深入了解广告系列未能投放或未实现最佳投放的原因。系统将对这些原因进行汇总,以确定整体的 CampaignPrimaryStatus。 |
status |
广告系列的状态。 添加新的广告系列时,状态默认为 ENABLED。 |
servingStatus |
仅限输出。广告系列的广告投放状态。 |
biddingStrategySystemStatus |
仅限输出。广告系列出价策略的系统状态。 |
adServingOptimizationStatus |
广告系列的广告投放优化状态。 |
advertisingChannelType |
不可变。广告系列中广告的主要投放目标。可以在 此字段是必填字段,在制作新的广告系列时不应为空。 只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
advertisingChannelSubType |
不可变。(可选)优化 只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
urlCustomParameters[] |
用于替换 |
localServicesCampaignSettings |
与本地生活服务广告系列相关的设置。 |
travelCampaignSettings |
旅行广告系列的设置。 |
discoveryCampaignSettings |
发现广告系列的设置。 |
realTimeBiddingSetting |
实时出价设置,这项功能仅适用于定位到 Ad Exchange 广告网络的广告系列。 |
networkSettings |
广告系列的投放网络设置。 |
hotelSetting |
不可变。广告系列的酒店设置。 |
dynamicSearchAdsSetting |
用于控制动态搜索广告 (DSA) 的设置。 |
shoppingSetting |
用于控制购物广告系列的设置。 |
targetingSetting |
用于定位相关功能的设置。 |
geoTargetTypeSetting |
广告地理位置定位设置。 |
localCampaignSetting |
本地广告系列的设置。 |
appCampaignSetting |
与应用广告系列相关的设置。 |
labels[] |
仅限输出。此广告系列所附标签的资源名称。 |
experimentType |
仅限输出。广告系列的类型:正常、草稿或实验。 |
biddingStrategyType |
仅限输出。出价策略的类型。 如需创建出价策略,请设置出价策略以创建标准出价策略,或设置 此字段为只读字段。 |
accessibleBiddingStrategy |
仅限输出。AccessibleBiddingStrategy 的资源名称,只读视图,包含由“biddingStrategy”标识的附加组合出价策略的不受限制属性。如果广告系列未使用组合策略,则为空。不受限制的策略属性可供共享策略的所有客户使用,并且可从 AccessibleBiddingStrategy 资源中读取。相比之下,受限属性仅适用于策略的所有者客户及其管理员。受限属性只能从 BiddingStrategy 资源中读取。 |
frequencyCaps[] |
一个列表,用于限制每个用户看到此广告系列中的广告的频率。 |
videoBrandSafetySuitability |
仅限输出。单个广告系列一级的品牌保障设置。允许选择广告资源类型,以在适合您品牌的内容中展示您的广告。请参阅 https://support.google.com/google-ads/answer/7515513。 |
vanityPharma |
描述非品牌医药广告的显示方式。 |
selectiveOptimization |
此广告系列的选择性优化设置,其中包括一组作为此广告系列优化目标的转化操作。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType 并将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。 |
optimizationGoalSetting |
此广告系列的优化目标设置,其中包括一组优化目标类型。 |
trackingSetting |
仅限输出。与跟踪信息相关的广告系列级设置。 |
paymentMode |
广告系列的付款方式。 |
excludedParentAssetFieldTypes[] |
应从此广告系列中排除的素材资源字段类型。此广告系列不会从较高级别沿用具有这些字段类型的素材资源链接。 |
excludedParentAssetSetTypes[] |
应从此广告系列中排除的素材资源集类型。此广告系列不会从较高级别沿用这些类型的素材资源集链接。营业地点组类型(GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP 和 STATIC_LOCATION_GROUP)是 LOCATION_SYNC 的子级类型。因此,如果为此字段设置了 LOCATION_SYNC,则所有营业地点组素材资源组均不能关联到此广告系列,并且此广告系列下将不会投放任何附加地址信息 (LE) 和附加关联商户地址信息 (ALE)。目前仅支持 LOCATION_SYNC。 |
performanceMaxUpgrade |
仅限输出。即将升级为效果最大化广告系列的广告系列的相关信息。 |
assetAutomationSettings[] |
包含每个 AssetAutomationType 的选择启用/停用状态。如需了解默认选择启用/停用行为,请参阅每种素材资源自动化类型枚举的文档。 |
id |
仅限输出。广告系列的 ID。 |
name |
广告系列的名称。 此字段是必填字段,在制作新的广告系列时不应为空。 并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
audienceSetting |
不可变。受众群体相关功能的设置。 |
baseCampaign |
仅限输出。广告系列草稿或实验广告系列的基准广告系列资源名称。对于基本广告系列,此值等于 此字段为只读字段。 |
campaignBudget |
广告系列的预算。 |
startDate |
广告系列在提供服务的客户所在时区开始运行的日期(采用 YYYY-MM-DD 格式)。 |
campaignGroup |
此广告系列所属的广告系列组。 |
endDate |
广告系列在提供服务的客户所在时区运行的最后一天(采用 YYYY-MM-DD 格式)。创建时,默认值为 2037-12-30,表示该广告系列将无限期投放下去。要将现有的广告系列设置为无限期投放,请将此字段设置为 2037-12-30。 |
finalUrlSuffix |
用于将查询参数附加到使用并行跟踪投放的着陆页的后缀。 |
optimizationScore |
仅限输出。广告系列的优化得分。 优化得分是一个估算的分值,反映了广告系列在设置方面的优化程度。优化得分的分值范围为 0% (0.0) 到 100% (1.0),100% 表示广告系列已充分发挥潜力。对于未评分的广告系列,此字段为 null。 请参阅“优化得分简介”,请访问 https://support.google.com/google-ads/answer/9061546。 此字段为只读字段。 |
urlExpansionOptOut |
表示选择停用指向更有针对性的网址的网址扩展功能。如果选择停用 (true),系统仅会定位到素材资源组中的最终到达网址或广告客户的 Google Merchant Center Feed 或商家数据 Feed 中指定的网址。如果选择启用 (false),则将定位到整个网域。只能为效果最大化广告系列设置此字段,默认值为 false。 |
hotelPropertyAssetSet |
不可变。用于指定旅行目标的效果最大化广告系列的一组酒店房源。 |
listingType |
不可变。为此广告系列投放的广告的信息类型。此字段仅限用于效果最大化广告系列。 |
联合字段 必须是嵌入到广告系列中的组合出价策略(通过 BiddingStrategy 服务创建)或标准格式。 |
|
biddingStrategy |
广告系列使用的组合出价策略。 |
commission |
“佣金”是一种自动出价策略,在这种策略中,广告客户支付一定比例的转化价值。 |
manualCpa |
标准的每次转化费用人工出价策略。一种人工出价策略,可让广告客户按广告客户指定的操作设置出价。仅适用于本地生活服务广告系列。 |
manualCpc |
标准的“每次点击费用人工出价”策略。基于点击的人工出价,此类出价中用户按点击次数付费。 |
manualCpm |
标准的每千次展示费用人工出价策略。基于展示次数的人工出价,此类出价中用户按每千次展示付费。 |
manualCpv |
一种出价策略,为每次视频观看支付可配置的金额。 |
maximizeConversions |
标准的“尽可能提高转化次数”出价策略,可在您的预算范围内自动争取尽可能多的转化次数。 |
maximizeConversionValue |
标准的“尽可能提高转化价值”出价策略,可在您的预算范围内自动设置出价,从而最大限度地提高收入。 |
targetCpa |
标准的“目标每次转化费用”出价策略,可自动设置出价,在将每次转化费用 (CPA) 控制在您设定的目标水平的前提下,帮助您争取尽可能多的转化。 |
targetImpressionShare |
“目标展示次数份额”出价策略。一种自动出价策略,可设置合适的出价来实现指定百分比的展示次数。 |
targetRoas |
一种标准“目标广告支出回报率”出价策略,可自动最大限度提高收入,同时确保平均达到特定目标广告支出回报率 (ROAS)。 |
targetSpend |
“标准目标支出”出价策略,它会自动为您设置适当的出价,帮助您在不超出预算的前提下为您争取尽可能多的点击。 |
percentCpc |
标准百分比形式的每次点击费用出价策略,这种出价策略的出价是某些商品或服务所宣传价格的一小部分。 |
targetCpm |
一种自动优化每千次展示费用的出价策略。 |
CampaignPrimaryStatus
描述可能的广告系列主要状态的枚举。让您深入了解广告系列未能投放或未实现最佳投放的原因。对广告系列及其相关实体所做的修改可能需要一段时间才能反映在此状态中。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ELIGIBLE |
广告系列符合投放条件。 |
PAUSED |
用户指定的广告系列状态为“已暂停”。 |
REMOVED |
系统会移除用户指定的广告系列状态。 |
ENDED |
用户指定的此广告系列的结束时间已过。 |
PENDING |
该广告系列将来可能会投放。 |
MISCONFIGURED |
广告系列或其关联的实体使用了错误的用户指定设置。 |
LIMITED |
广告系列或其关联实体受到用户指定设置的限制。 |
LEARNING |
自动出价系统将根据用户对广告系列或关联实体指定的更改进行调整。 |
NOT_ELIGIBLE |
此广告系列不符合投放条件。 |
CampaignPrimaryStatusReason
描述可能的广告系列主要状态原因的枚举。让您深入了解广告系列未能投放或未实现最佳投放的原因。我们会汇总这些原因,以确定广告系列的整体主要状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
CAMPAIGN_REMOVED |
系统会移除用户指定的广告系列状态。 |
CAMPAIGN_PAUSED |
用户指定的广告系列状态为“已暂停”。 |
CAMPAIGN_PENDING |
用户指定的此广告系列的开始时间是将来的时间。 |
CAMPAIGN_ENDED |
用户指定的此广告系列的结束时间已过。 |
CAMPAIGN_DRAFT |
该广告系列处于草稿状态。 |
BIDDING_STRATEGY_MISCONFIGURED |
该出价策略包含错误的用户指定设置。 |
BIDDING_STRATEGY_LIMITED |
出价策略受到用户指定设置(例如缺少数据或类似设置)的限制。 |
BIDDING_STRATEGY_LEARNING |
自动出价系统会根据用户指定的出价策略更改进行调整。 |
BIDDING_STRATEGY_CONSTRAINED |
广告系列可通过调整每次转化费用/广告支出回报率目标值获得更高的转化价值。 |
BUDGET_CONSTRAINED |
预算限制了广告系列的投放能力。 |
BUDGET_MISCONFIGURED |
预算中用户指定的设置不正确。 |
SEARCH_VOLUME_LIMITED |
广告系列未定位到所有相关查询。 |
AD_GROUPS_PAUSED |
用户指定的广告组状态均为已暂停。 |
NO_AD_GROUPS |
此广告系列中没有符合条件的广告组。 |
KEYWORDS_PAUSED |
用户指定的关键字均处于暂停状态。 |
NO_KEYWORDS |
此广告系列中没有符合条件的关键字。 |
AD_GROUP_ADS_PAUSED |
用户指定的广告组广告状态均为已暂停。 |
NO_AD_GROUP_ADS |
此广告系列中没有符合条件的广告组广告。 |
HAS_ADS_LIMITED_BY_POLICY |
此广告系列中至少有一个广告受到政策的限制。 |
HAS_ADS_DISAPPROVED |
此广告系列中至少有一个广告被拒登。 |
MOST_ADS_UNDER_REVIEW |
此广告系列中的大多数广告正在等待审核。 |
MISSING_LEAD_FORM_EXTENSION |
该广告系列设有潜在客户表单目标,但缺少附加潜在客户表单。 |
MISSING_CALL_EXTENSION |
该广告系列设有来电目标,但缺少附加电话信息。 |
LEAD_FORM_EXTENSION_UNDER_REVIEW |
附加潜在客户表单正在接受审核。 |
LEAD_FORM_EXTENSION_DISAPPROVED |
此附加潜在客户表单已被拒登。 |
CALL_EXTENSION_UNDER_REVIEW |
附加电话信息正在接受审核。 |
CALL_EXTENSION_DISAPPROVED |
附加电话信息已被拒登。 |
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA |
此广告系列中没有符合条件的移动应用广告组条件。 |
CAMPAIGN_GROUP_PAUSED |
用户指定的广告系列组状态为“已暂停”。 |
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED |
与父级广告系列组相关联的所有组预算的用户指定时间已过。 |
APP_NOT_RELEASED |
与此 ACi 广告系列相关联的应用未在该广告系列的目标国家/地区发布。 |
APP_PARTIALLY_RELEASED |
与此 ACi 广告系列相关联的应用已在该广告系列的目标国家/地区部分发布。 |
HAS_ASSET_GROUPS_DISAPPROVED |
此广告系列中至少有一个素材资源组被拒登。 |
HAS_ASSET_GROUPS_LIMITED_BY_POLICY |
此广告系列中至少有一个素材资源组受到政策限制。 |
MOST_ASSET_GROUPS_UNDER_REVIEW |
此广告系列中的大多数素材资源组正在等待审核。 |
NO_ASSET_GROUPS |
此广告系列中没有符合条件的素材资源组。 |
ASSET_GROUPS_PAUSED |
此广告系列中的所有素材资源组均已暂停。 |
CampaignStatus
广告系列的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ENABLED |
广告系列处于有效状态,可以展示广告。 |
PAUSED |
用户已暂停广告系列。 |
REMOVED |
广告系列已移除。 |
CampaignServingStatus
广告系列的可能投放状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知的值。 这是一个仅用于响应的值。 |
SERVING |
正在投放。 |
NONE |
无。 |
ENDED |
已结束。 |
PENDING |
Pending. |
SUSPENDED |
已暂停。 |
BiddingStrategySystemStatus
BidStrategy 的可能系统状态。
枚举 | |
---|---|
UNSPECIFIED |
表示发生了意外错误,例如未找到出价策略类型,或未找到状态信息。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ENABLED |
该出价策略有效,AdWords没有发现该策略存在任何问题。 |
LEARNING_NEW |
该出价策略正在学习,因为它是最近才创建或最近重新启用的。 |
LEARNING_SETTING_CHANGE |
由于近期设置发生更改,该出价策略正在学习。 |
LEARNING_BUDGET_CHANGE |
由于近期的预算更改,该出价策略正在学习。 |
LEARNING_COMPOSITION_CHANGE |
该出价策略正在学习,因为与其关联的广告系列、广告组或关键字的数量最近发生了变化。 |
LEARNING_CONVERSION_TYPE_CHANGE |
出价策略的依据是转化报告以及客户最近修改过的与出价策略相关的转化类型。 |
LEARNING_CONVERSION_SETTING_CHANGE |
出价策略需要使用转化报告,并且客户最近更改了转化设置。 |
LIMITED_BY_CPC_BID_CEILING |
该出价策略受到其出价上限的限制。 |
LIMITED_BY_CPC_BID_FLOOR |
该出价策略受到其出价下限的限制。 |
LIMITED_BY_DATA |
该出价策略受到限制,因为在过去几周没有足够的转化流量。 |
LIMITED_BY_BUDGET |
此出价策略中有很大一部分关键字受到预算的限制。 |
LIMITED_BY_LOW_PRIORITY_SPEND |
该出价策略无法达到其目标支出,因为其支出已降低优先级。 |
LIMITED_BY_LOW_QUALITY |
此出价策略中有很大一部分关键字的质量得分较低。 |
LIMITED_BY_INVENTORY |
由于定位范围较小,该出价策略无法用尽其预算。 |
MISCONFIGURED_ZERO_ELIGIBILITY |
缺少转化跟踪(没有 ping)和/或智能购物广告系列的再营销名单。 |
MISCONFIGURED_CONVERSION_TYPES |
出价策略依赖于转化报表,而客户缺少可能会根据此策略进行报告的转化类型。 |
MISCONFIGURED_CONVERSION_SETTINGS |
出价策略依赖于转化报告,而客户的转化设置配置有误。 |
MISCONFIGURED_SHARED_BUDGET |
出价策略之外的一些广告系列与该策略中包含的广告系列共享预算。 |
MISCONFIGURED_STRATEGY_TYPE |
该广告系列的策略类型无效,未投放。 |
PAUSED |
该出价策略无效。没有任何有效的广告系列、广告组或关键字附加到出价策略。或者,此出价策略未关联任何有效预算。 |
UNAVAILABLE |
此出价策略目前不支持状态报告。 |
MULTIPLE_LEARNING |
在相关时间段内,此出价策略存在多种 LEARNING_* 系统状态。 |
MULTIPLE_LIMITED |
在相关时间段内,此出价策略存在多个 LIMITED_* 系统状态。 |
MULTIPLE_MISCONFIGURED |
在相关时间段内,此出价策略存在多个 MISCONFIGURED_* 系统状态。 |
MULTIPLE |
在相关时间段内,此出价策略存在多种系统状态。 |
AdServingOptimizationStatus
描述可能的服务状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
此版本中未知的值。 这是一个仅用于响应的值。 |
OPTIMIZE |
已根据广告系列的点击率优化广告投放。 |
CONVERSION_OPTIMIZE |
系统会根据广告系列的点击率 * 转化次数来优化广告投放。如果广告系列未采用转化优化工具出价策略,则默认为“优化”。 |
ROTATE |
广告会在 90 天内均匀轮播,然后针对点击进行优化。 |
ROTATE_INDEFINITELY |
更均匀地展示效果欠佳的广告和效果较好的广告,不进行优化。 |
UNAVAILABLE |
广告投放优化状态未知。 |
LocalServicesCampaignSettings
LocalServicesCampaign 子资源的设置。
JSON 表示法 |
---|
{
"categoryBids": [
{
object ( |
字段 | |
---|---|
categoryBids[] |
与“MANUAL_CPA”出价策略相关联的分类级出价。 |
CategoryBid
LocalServicesReportingCampaignSettings 中的类别出价。
JSON 表示法 |
---|
{ "categoryId": string, "manualCpaBidMicros": string } |
字段 | |
---|---|
categoryId |
与出价相关联的类别。例如,xcat:service_area_business_plumber。 |
manualCpaBidMicros |
相应类别的每次转化费用人工出价。出价必须高于该类别的预订价格。值以微单位和广告客户的货币为单位。 |
TravelCampaignSettings
旅行广告系列的设置。
JSON 表示法 |
---|
{ "travelAccountId": string } |
字段 | |
---|---|
travelAccountId |
不可变。与旅行广告系列相关联的旅行帐号 ID。 |
DiscoveryCampaignSettings
发现广告系列的设置。
JSON 表示法 |
---|
{ "upgradedTargeting": boolean } |
字段 | |
---|---|
upgradedTargeting |
不可变。指定此广告系列是否使用升级版定位选项。当此字段设为 |
RealTimeBiddingSetting
实时出价设置,这项功能仅适用于定位到 Ad Exchange 广告网络的广告系列。
JSON 表示法 |
---|
{ "optIn": boolean } |
字段 | |
---|---|
optIn |
广告系列是否启用了实时出价。 |
NetworkSettings
广告系列的投放网络设置。
JSON 表示法 |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean, "targetYoutube": boolean, "targetGoogleTvNetwork": boolean } |
字段 | |
---|---|
targetGoogleSearch |
广告是否会随 google.com 搜索结果一起投放。 |
targetSearchNetwork |
广告是否会在 Google 搜索网络的合作伙伴网站上投放( |
targetContentNetwork |
广告是否将在 Google 展示广告网络中的指定展示位置投放。展示位置是使用“展示位置”条件指定的。 |
targetPartnerSearchNetwork |
广告是否将在 Google 合作伙伴网络中投放。这仅可用于部分 Google 合作伙伴账号。 |
targetYoutube |
广告是否会在 YouTube 上投放。 |
targetGoogleTvNetwork |
广告是否会在 Google TV 网络中投放。 |
HotelSettingInfo
酒店广告的广告系列级设置。
JSON 表示法 |
---|
{ "hotelCenterId": string } |
字段 | |
---|---|
hotelCenterId |
不可变。关联的 Hotel Center 帐号。 |
DynamicSearchAdsSetting
用于控制动态搜索广告 (DSA) 的设置。
JSON 表示法 |
---|
{ "domainName": string, "languageCode": string, "feeds": [ string ], "useSuppliedUrlsOnly": boolean } |
字段 | |
---|---|
domainName |
必需。此设置所代表的互联网域名,例如“google.com”或“www.google.com”。 |
languageCode |
必需。用于指定网域语言的语言代码,例如“en”。 |
feeds[] |
与广告系列相关联的页面 Feed 的列表。 |
useSuppliedUrlsOnly |
广告系列是否仅使用广告客户提供的网址。 |
ShoppingSetting
购物广告系列的设置。定义此广告系列可以宣传的产品,以及此广告系列与其他购物广告系列互动的方式。
JSON 表示法 |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "advertisingPartnerIds": [ string ], "merchantId": string, "campaignPriority": integer, "enableLocal": boolean, "disableProductFeed": boolean } |
字段 | |
---|---|
feedLabel |
要添加到广告系列中的产品的 Feed 标签。只能设置 feedLabel 和 salesCountry 中的一个。如果使用 feedLabel 字段替代 salesCountry,则 FeedLabel 字段接受相同格式的国家/地区代码,例如“XX”。否则,该值可以是用于 Google Merchant Center 中 Feed 标签的任何字符串。 |
useVehicleInventory |
不可变。是否定位到车辆详情广告资源。只有智能购物广告系列支持此字段。如需在效果最大化广告系列中设置车辆详情广告资源,请改用 |
advertisingPartnerIds[] |
不可变。广告系列中合作的广告合作伙伴的广告账号 ID。 |
merchantId |
Merchant Center 帐号的 ID。对于创建操作,此字段是必填字段。对于购物广告系列,此字段不可更改。 |
campaignPriority |
广告系列的优先级。数值较高的广告系列的优先级高于优先级较低的广告系列。此字段是购物广告系列的必填字段,值介于 0 和 2 之间(含 0 和 2)。此字段对于智能购物广告系列是选填字段,但如果设置,则必须等于 3。 |
enableLocal |
是否添加本地商品。 |
disableProductFeed |
停用可选商品 Feed。目前只有需求开发广告系列支持此字段。如需详细了解此功能,请参阅 https://support.google.com/google-ads/answer/13721750。 |
AudienceSetting
受众群体定位的设置。
JSON 表示法 |
---|
{ "useAudienceGrouped": boolean } |
字段 | |
---|---|
useAudienceGrouped |
不可变。如果为 true,则此广告系列会使用受众群体资源进行受众群体定位。如果为 false,此广告系列可能会改用细分受众群条件。 |
GeoTargetTypeSetting
表示与广告地理位置定位相关的设置的集合。
JSON 表示法 |
---|
{ "positiveGeoTargetType": enum ( |
字段 | |
---|---|
positiveGeoTargetType |
用于在此特定广告系列中进行肯定地理位置定位的设置。 |
negativeGeoTargetType |
用于在此特定广告系列中进行排除性地理位置定位的设置。 |
PositiveGeoTargetType
可能的正地理位置定位类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
在此版本中,此值未知。 |
PRESENCE_OR_INTEREST |
指定当用户位于广告客户定位到的地理位置或对其表现出兴趣时,即会触发广告。 |
SEARCH_INTEREST |
指定在用户搜索广告客户定位到的地理位置时触发广告。只能用于搜索广告系列和标准购物广告系列。 |
PRESENCE |
指定当用户位于或经常位于广告客户的定位到的地理位置时触发广告。 |
NegativeGeoTargetType
可能的排除地理位置定位类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
在此版本中,此值未知。 |
PRESENCE_OR_INTEREST |
指定在用户位于广告客户排除的地理位置或对其表现出兴趣时,不向其展示广告。 |
PRESENCE |
指定在用户位于广告客户排除的地理位置时,无法看到广告。 |
LocalCampaignSetting
本地广告系列的广告系列设置。
JSON 表示法 |
---|
{
"locationSourceType": enum ( |
字段 | |
---|---|
locationSourceType |
此本地广告系列的地理位置来源类型。 |
LocationSourceType
位置信息来源的可能类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
GOOGLE_MY_BUSINESS |
与客户关联的商家资料相关联的营业地点。 |
AFFILIATE |
联属营销(连锁)商店位置。例如,Best Buy 商店位置。 |
AppCampaignSetting
应用广告系列的广告系列级设置。
JSON 表示法 |
---|
{ "biddingStrategyGoalType": enum ( |
字段 | |
---|---|
biddingStrategyGoalType |
表示此应用广告系列的出价策略应针对的目标进行优化。 |
appStore |
不可变。分发此特定应用的应用商店。 |
appId |
不可变。一个唯一标识移动应用的字符串。 |
AppCampaignBiddingStrategyGoalType
应用广告系列出价策略的目标类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST |
力求最大限度提高应用安装次数。每次转化费用出价是指目标每次安装费用。 |
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST |
力求最大限度提高从应用安装促成的选定应用内转化的长期数量。每次转化费用出价是指目标每次安装费用。 |
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST |
力求最大限度提高从应用安装促成的选定应用内转化的长期数量。每次转化费用出价是目标每次应用内转化费用。请注意,刚开始时,实际每次转化费用可能会高于目标每次转化费用,因为长期转化还没有发生。 |
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND |
力求尽可能提高所有转化的价值(例如安装 + 选定的应用内转化),同时达到或超出目标广告支出回报率。 |
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME |
旨在尽可能增加应用的预注册量。 |
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST |
力求在没有目标每次安装费用的情况下尽可能提高应用安装量。 |
AppCampaignAppStore
描述应用广告系列应用商店的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
APPLE_APP_STORE |
Apple App Store。 |
GOOGLE_APP_STORE |
Google Play。 |
CampaignExperimentType
指明此广告系列是常规广告系列、广告系列草稿还是实验广告系列。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
BASE |
这是一个常规广告系列。 |
DRAFT |
这是广告系列的草稿版本。它与基本广告系列进行了一些修改,但没有投放或产生指标。 |
EXPERIMENT |
这是广告系列的实验版本。它在基本广告系列中进行了一些修改,并且有一定比例的流量正在从基准广告系列转移到此实验广告系列。 |
FrequencyCapEntry
一条规则,用于指定一个广告(或某组广告)在特定时间段内可以向用户展示的最大次数。
JSON 表示法 |
---|
{
"key": {
object ( |
字段 | |
---|---|
key |
特定频次上限的键。最多只能有一个频次上限。 |
cap |
在相应时间范围内允许此上限的事件数上限。 |
FrequencyCapKey
用作频次上限的键的一组字段。最多只能有一个频次上限。
JSON 表示法 |
---|
{ "level": enum ( |
字段 | |
---|---|
level |
上限所应用的级别(例如,广告组广告、广告组)。该上限应用于该级别的所有实体。 |
eventType |
该上限所适用的事件类型(例如展示)。 |
timeUnit |
定义上限所用的时间单位(例如日、周)。 |
timeLength |
该上限持续的时间单位数。 |
FrequencyCapLevel
上限所应用的级别(例如广告组广告、广告组)。上限应用于此级别的所有资源。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
AD_GROUP_AD |
该上限在广告组广告级别应用。 |
AD_GROUP |
该上限在广告组一级应用。 |
CAMPAIGN |
该上限在广告系列一级应用。 |
FrequencyCapEventType
该上限所适用的事件类型(例如展示)。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
IMPRESSION |
该上限适用于广告展示次数。 |
VIDEO_VIEW |
该上限适用于视频广告观看次数。 |
VanityPharma
描述非品牌医药广告的显示方式。
JSON 表示法 |
---|
{ "vanityPharmaDisplayUrlMode": enum ( |
字段 | |
---|---|
vanityPharmaDisplayUrlMode |
个性化药店网址的显示模式。 |
vanityPharmaText |
当个性化药店网址选择显示模式“网站说明”时,文字广告的显示网址中将会展示的文字。 |
VanityPharmaDisplayUrlMode
描述个性化药店网址的可能显示模式的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
MANUFACTURER_WEBSITE_URL |
将个性化药店网址替换为制造商网站网址。 |
WEBSITE_DESCRIPTION |
将个性化药店网址替换为网站说明。 |
VanityPharmaText
描述可能的文本的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PRESCRIPTION_TREATMENT_WEBSITE_EN |
处方治疗网站,网站内容以英语显示。 |
PRESCRIPTION_TREATMENT_WEBSITE_ES |
处方治疗网站,网站内容采用西班牙语 (Sitio de tratamientos con receta)。 |
PRESCRIPTION_DEVICE_WEBSITE_EN |
处方器械网站,网站内容以英语显示。 |
PRESCRIPTION_DEVICE_WEBSITE_ES |
处方器械网站,网站内容以西班牙语显示 (Sitio de dispositivos con receta)。 |
MEDICAL_DEVICE_WEBSITE_EN |
医疗器械网站,网站内容的英文版本。 |
MEDICAL_DEVICE_WEBSITE_ES |
网站内容为西班牙语的医疗器械网站 (Sitio de dispositivos médicos)。 |
PREVENTATIVE_TREATMENT_WEBSITE_EN |
预防性治疗网站,网站内容为英文。 |
PREVENTATIVE_TREATMENT_WEBSITE_ES |
预防性治疗网站,网站内容采用西班牙语 (Sitio de tratamientos preventivos)。 |
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN |
处方避孕网站,网站内容为英文。 |
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES |
处方避孕网站,网站内容为西班牙语 (Sitio de anticonceptivos con receta)。 |
PRESCRIPTION_VACCINE_WEBSITE_EN |
处方疫苗网站,网站内容以英语显示。 |
PRESCRIPTION_VACCINE_WEBSITE_ES |
处方疫苗网站,网站内容采用西班牙语 (Sitio de vacunas con receta)。 |
SelectiveOptimization
此广告系列的选择性优化设置,其中包括一组作为此广告系列优化目标的转化操作。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType 并将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。
JSON 表示法 |
---|
{ "conversionActions": [ string ] } |
字段 | |
---|---|
conversionActions[] |
用于优化此广告系列的一组选定的转化操作。 |
OptimizationGoalSetting
此广告系列的优化目标设置,其中包括一组优化目标类型。
JSON 表示法 |
---|
{
"optimizationGoalTypes": [
enum ( |
字段 | |
---|---|
optimizationGoalTypes[] |
优化目标类型的列表。 |
OptimizationGoalType
优化目标的类型
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用作返回值。表示此版本中的未知值。 |
CALL_CLICKS |
针对点击致电进行优化。致电点击转化是指用户在浏览广告后选择“致电”联系商店的次数。 |
DRIVING_DIRECTIONS |
针对行车路线进行优化。查询行车路线转化次数是指用户在浏览广告后选择“查询路线”导航到相应商店的次数。 |
APP_PRE_REGISTRATION |
针对预注册进行优化。预注册转化次数是指当应用发布时用户收到通知的预注册用户数量。 |
TrackingSetting
与跟踪信息相关的广告系列级设置。
JSON 表示法 |
---|
{ "trackingUrl": string } |
字段 | |
---|---|
trackingUrl |
仅限输出。用于动态跟踪的网址。 |
PaymentMode
描述可能的付款方式的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
CLICKS |
按互动付费。 |
CONVERSION_VALUE |
按转化价值付费。只有具有 AdvertisingChannelType.HOTEL、BiddingStrategyType.COMMISSION 和 BudgetType.STANDARD 的广告系列支持此模式。 |
CONVERSIONS |
按转化次数付费。只有具有 AdvertisingChannelType.DISPLAY(不包括 AdvertisingChannelSubType.DISPLAY_Gmail)、BiddingStrategyType.TARGET_CPA 和 BudgetType.FIXED_CPA 的广告系列支持此模式。此外,客户还必须符合使用此模式的条件。如需了解详情,请参阅 Customer.eligibility_failure_reasons。 |
GUEST_STAY |
按房客入住价值付费。只有具有 AdvertisingChannelType.HOTEL、BiddingStrategyType.COMMISSION 和 BudgetType.STANDARD 的广告系列支持此模式。 |
PerformanceMaxUpgrade
即将升级为效果最大化广告系列的广告系列的相关信息。
JSON 表示法 |
---|
{
"performanceMaxCampaign": string,
"preUpgradeCampaign": string,
"status": enum ( |
字段 | |
---|---|
performanceMaxCampaign |
仅限输出。指明广告系列升级到的效果最大化广告系列。 |
preUpgradeCampaign |
仅限输出。表示旧版广告系列已升级为效果最大化广告系列。 |
status |
仅限输出。某个广告系列的升级状态请求升级为效果最大化广告系列。 |
PerformanceMaxUpgradeStatus
广告系列的效果最大化广告系列升级状态枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
UPGRADE_IN_PROGRESS |
正在升级为效果最大化广告系列。 |
UPGRADE_COMPLETE |
效果最大化广告系列的升级已完成。 |
UPGRADE_FAILED |
未能升级为效果最大化广告系列。广告系列仍会像尝试升级之前一样投放。 |
UPGRADE_ELIGIBLE |
广告系列符合升级为效果最大化广告系列的条件。 |
ListingType
可能的商品详情类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
VEHICLES |
此广告系列将投放车辆广告。 |
AssetAutomationSetting
素材资源自动化设置包含 AssetAutomationType 对和素材资源自动化功能的启用/停用状态
JSON 表示法 |
---|
{ "assetAutomationType": enum ( |
字段 | |
---|---|
assetAutomationType |
广告客户希望启用/停用的素材资源自动化类型。 |
assetAutomationStatus |
素材资源自动化类型的选择启用/停用状态。 |
AssetAutomationType
素材资源自动化的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用作返回值。表示此版本中的未知值。 |
TEXT_ASSET_AUTOMATION |
文字素材资源自动化功能包括标题和广告内容描述。默认情况下,广告客户会在投放效果最大化广告系列时选择停用效果最大化广告系列,而在搜索网络上停用该功能。 |
AssetAutomationStatus
素材资源自动化的状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用作返回值。表示此版本中的未知值。 |
OPTED_IN |
选择启用后,系统将会生成和投放一种素材资源自动化类型。 |
OPTED_OUT |
若选择停用,系统将停止生成和投放某种类型的素材资源。 |
佣金
“佣金”是一种自动出价策略,在这种策略中,广告客户支付一定比例的转化价值。
JSON 表示法 |
---|
{ "commissionRateMicros": string } |
字段 | |
---|---|
commissionRateMicros |
佣金率决定了在转化价值中,广告客户需要支付的那部分费用。佣金率 x 应以 (x * 1,000,000) 的格式传入此字段。例如,106,000 表示佣金率为 0.106 (10.6%)。 |
ManualCpa
此类型没有任何字段。
一种人工出价策略,可让广告客户按广告客户指定的操作设置出价。
ManualCpc
基于点击的人工出价,此类出价中用户按点击次数付费。
JSON 表示法 |
---|
{ "enhancedCpcEnabled": boolean } |
字段 | |
---|---|
enhancedCpcEnabled |
是否根据转化优化工具数据增强出价。 |
ManualCpm
此类型没有任何字段。
基于展示次数的人工出价,此类出价中用户按每千次展示付费。
ManualCpv
此类型没有任何字段。
基于观看的出价,用户每次观看视频时都需要付费。
PercentCpc
一种出价策略。采用这种出价策略时,出价为某些商品或服务所宣传价格的一小部分。
JSON 表示法 |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
字段 | |
---|---|
cpcBidCeilingMicros |
可通过出价策略设置的出价上限。此字段由广告客户输入,以本地货币微单位指定。注意:零值的解释方式与未定义 bid_曲目相同。 |
enhancedCpcEnabled |
根据发生转化的可能性上下调整每次竞价的出价。各个出价可以超过 cpcBidCeilingMicros,但广告系列的平均出价金额不应超过 cpcBidCeilingMicros。 |
TargetCpm
目标每千次展示费用是一种自动出价策略,它会根据您设置的目标每千次展示费用来设置出价,以优化广告效果。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 goal 。与出价目标有关的其他信息。goal 只能是下列其中一项: |
|
targetFrequencyGoal |
“目标频次”出价目标的相关详情。 |
TargetCpmTargetFrequencyGoal
“目标频次”出价目标的相关详情。
JSON 表示法 |
---|
{
"targetCount": string,
"timeUnit": enum ( |
字段 | |
---|---|
targetCount |
“目标频次”计数,表示您希望覆盖单个用户的次数。 |
timeUnit |
表示您希望在这段时间内达到指定 targetCount 的时间段。 |