Campaign

广告系列。

JSON 表示法 
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "discoveryCampaignSettings": {
    object (DiscoveryCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
字段
resourceName

string

不可变。广告系列的资源名称。广告系列资源名称采用以下格式：

customers/{customerId}/campaigns/{campaignId}
primaryStatus

enum (CampaignPrimaryStatus)

仅限输出。广告系列的主要状态。

让您深入了解广告系列未能投放或未实现最佳投放的原因。对广告系列及其相关实体所做的修改可能需要一段时间才能反映在此状态中。
primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

仅限输出。广告系列的主要状态原因。

让您深入了解广告系列未能投放或未实现最佳投放的原因。系统将对这些原因进行汇总，以确定整体的 CampaignPrimaryStatus。
status

enum (CampaignStatus)

广告系列的状态。

添加新的广告系列时，状态默认为 ENABLED。
servingStatus

enum (CampaignServingStatus)

仅限输出。广告系列的广告投放状态。
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

仅限输出。广告系列出价策略的系统状态。
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

广告系列的广告投放优化状态。
advertisingChannelType

enum (AdvertisingChannelType)

不可变。广告系列中广告的主要投放目标。可以在networkSettings中优化定位选项。

此字段是必填字段，在制作新的广告系列时不应为空。

只能在创建广告系列时设置。创建广告系列后，此字段便无法更改。
advertisingChannelSubType

enum (AdvertisingChannelSubType)

不可变。（可选）优化 advertisingChannelType。必须是父渠道类型的有效子类型。

只能在创建广告系列时设置。创建广告系列后，此字段便无法更改。
urlCustomParameters[]

object (CustomParameter)

用于替换 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中的自定义参数标记的映射列表。
localServicesCampaignSettings

object (LocalServicesCampaignSettings)

与本地生活服务广告系列相关的设置。
travelCampaignSettings

object (TravelCampaignSettings)

旅行广告系列的设置。
discoveryCampaignSettings

object (DiscoveryCampaignSettings)

发现广告系列的设置。
realTimeBiddingSetting

object (RealTimeBiddingSetting)

实时出价设置，这项功能仅适用于定位到 Ad Exchange 广告网络的广告系列。
networkSettings

object (NetworkSettings)

广告系列的投放网络设置。
hotelSetting

object (HotelSettingInfo)

不可变。广告系列的酒店设置。
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

用于控制动态搜索广告 (DSA) 的设置。
shoppingSetting

object (ShoppingSetting)

用于控制购物广告系列的设置。
targetingSetting

object (TargetingSetting)

用于定位相关功能的设置。
geoTargetTypeSetting

object (GeoTargetTypeSetting)

广告地理位置定位设置。
localCampaignSetting

object (LocalCampaignSetting)

本地广告系列的设置。
appCampaignSetting

object (AppCampaignSetting)

与应用广告系列相关的设置。
labels[]

string

仅限输出。此广告系列所附标签的资源名称。
experimentType

enum (CampaignExperimentType)

仅限输出。广告系列的类型：正常、草稿或实验。
biddingStrategyType

enum (BiddingStrategyType)

仅限输出。出价策略的类型。

如需创建出价策略，请设置出价策略以创建标准出价策略，或设置 biddingStrategy 字段以创建组合出价策略。

此字段为只读字段。
accessibleBiddingStrategy

string

仅限输出。AccessibleBiddingStrategy 的资源名称，只读视图，包含由“biddingStrategy”标识的附加组合出价策略的不受限制属性。如果广告系列未使用组合策略，则为空。不受限制的策略属性可供共享策略的所有客户使用，并且可从 AccessibleBiddingStrategy 资源中读取。相比之下，受限属性仅适用于策略的所有者客户及其管理员。受限属性只能从 BiddingStrategy 资源中读取。
frequencyCaps[]

object (FrequencyCapEntry)

一个列表，用于限制每个用户看到此广告系列中的广告的频率。
videoBrandSafetySuitability

enum (BrandSafetySuitability)

仅限输出。单个广告系列一级的品牌保障设置。允许选择广告资源类型，以在适合您品牌的内容中展示您的广告。请参阅 https://support.google.com/google-ads/answer/7515513。
vanityPharma

object (VanityPharma)

描述非品牌医药广告的显示方式。
selectiveOptimization

object (SelectiveOptimization)

此广告系列的选择性优化设置，其中包括一组作为此广告系列优化目标的转化操作。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType 并将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。
optimizationGoalSetting

object (OptimizationGoalSetting)

此广告系列的优化目标设置，其中包括一组优化目标类型。
trackingSetting

object (TrackingSetting)

仅限输出。与跟踪信息相关的广告系列级设置。
paymentMode

enum (PaymentMode)

广告系列的付款方式。
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

应从此广告系列中排除的素材资源字段类型。此广告系列不会从较高级别沿用具有这些字段类型的素材资源链接。
excludedParentAssetSetTypes[]

enum (AssetSetType)

应从此广告系列中排除的素材资源集类型。此广告系列不会从较高级别沿用这些类型的素材资源集链接。营业地点组类型（GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP 和 STATIC_LOCATION_GROUP）是 LOCATION_SYNC 的子级类型。因此，如果为此字段设置了 LOCATION_SYNC，则所有营业地点组素材资源组均不能关联到此广告系列，并且此广告系列下将不会投放任何附加地址信息 (LE) 和附加关联商户地址信息 (ALE)。目前仅支持 LOCATION_SYNC。
performanceMaxUpgrade

object (PerformanceMaxUpgrade)

仅限输出。即将升级为效果最大化广告系列的广告系列的相关信息。
id

string (int64 format)

仅限输出。广告系列的 ID。
name

string

广告系列的名称。

此字段是必填字段，在制作新的广告系列时不应为空。

并且不得包含任何 null（码位 0x0）、NL 换行符（码位 0xA）或回车符（码位 0xD）。
trackingUrlTemplate

string

用于构建跟踪网址的网址模板。
audienceSetting

object (AudienceSetting)

不可变。受众群体相关功能的设置。
baseCampaign

string

仅限输出。广告系列草稿或实验广告系列的基准广告系列资源名称。对于基本广告系列，此值等于 resourceName。

此字段为只读字段。
campaignBudget

string

广告系列的预算。
startDate

string

广告系列在提供服务的客户所在时区开始运行的日期（采用 YYYY-MM-DD 格式）。
campaignGroup

string

此广告系列所属的广告系列组。
endDate

string

广告系列在提供服务的客户所在时区运行的最后一天（采用 YYYY-MM-DD 格式）。创建时，默认值为 2037-12-30，表示该广告系列将无限期投放下去。要将现有的广告系列设置为无限期投放，请将此字段设置为 2037-12-30。
finalUrlSuffix

string

用于将查询参数附加到使用并行跟踪投放的着陆页的后缀。
optimizationScore

number

仅限输出。广告系列的优化得分。

优化得分是一个估算的分值，反映了广告系列在设置方面的优化程度。优化得分的分值范围为 0% (0.0) 到 100% (1.0)，100% 表示广告系列已充分发挥潜力。对于未评分的广告系列，此字段为 null。

请参阅“优化得分简介”，请访问 https://support.google.com/google-ads/answer/9061546。

此字段为只读字段。
urlExpansionOptOut

boolean

表示选择停用指向更有针对性的网址的网址扩展功能。如果选择停用 (true)，系统仅会定位到素材资源组中的最终到达网址或广告客户的 Google Merchant Center Feed 或商家数据 Feed 中指定的网址。如果选择启用 (false)，则将定位到整个网域。只能为效果最大化广告系列设置此字段，默认值为 false。
hotelPropertyAssetSet

string

不可变。用于指定旅行目标的效果最大化广告系列的一组酒店房源。
listingType

enum (ListingType)

不可变。为此广告系列投放的广告的信息类型。此字段仅限用于效果最大化广告系列。

联合字段 campaign_bidding_strategy。广告系列的出价策略。

必须是嵌入到广告系列中的组合出价策略（通过 BiddingStrategy 服务创建）或标准格式。campaign_bidding_strategy 只能是下列其中一项：
biddingStrategy

string

广告系列使用的组合出价策略。
commission

object (Commission)

“佣金”是一种自动出价策略，在这种策略中，广告客户支付一定比例的转化价值。
manualCpa

object (ManualCpa)

标准的每次转化费用人工出价策略。一种人工出价策略，可让广告客户按广告客户指定的操作设置出价。仅适用于本地生活服务广告系列。
manualCpc

object (ManualCpc)

标准的“每次点击费用人工出价”策略。基于点击的人工出价，此类出价中用户按点击次数付费。
manualCpm

object (ManualCpm)

标准的每千次展示费用人工出价策略。基于展示次数的人工出价，此类出价中用户按每千次展示付费。
manualCpv

object (ManualCpv)

一种出价策略，为每次视频观看支付可配置的金额。
maximizeConversions

object (MaximizeConversions)

标准的“尽可能提高转化次数”出价策略，可在您的预算范围内自动争取尽可能多的转化次数。
maximizeConversionValue

object (MaximizeConversionValue)

标准的“尽可能提高转化价值”出价策略，可在您的预算范围内自动设置出价，从而最大限度地提高收入。
targetCpa

object (TargetCpa)

标准的“目标每次转化费用”出价策略，可自动设置出价，在将每次转化费用 (CPA) 控制在您设定的目标水平的前提下，帮助您争取尽可能多的转化。
targetImpressionShare

object (TargetImpressionShare)

“目标展示次数份额”出价策略。一种自动出价策略，可设置合适的出价来实现指定百分比的展示次数。
targetRoas

object (TargetRoas)

一种标准“目标广告支出回报率”出价策略，可自动最大限度提高收入，同时确保平均达到特定目标广告支出回报率 (ROAS)。
targetSpend

object (TargetSpend)

“标准目标支出”出价策略，它会自动为您设置适当的出价，帮助您在不超出预算的前提下为您争取尽可能多的点击。
percentCpc

object (PercentCpc)

标准百分比形式的每次点击费用出价策略，这种出价策略的出价是某些商品或服务所宣传价格的一小部分。
targetCpm

object (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 此广告系列中的大多数素材资源组正在等待审核。

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 (CategoryBid)
    }
  ]
}
字段
categoryBids[]

object (CategoryBid)

与“MANUAL_CPA”出价策略相关联的分类级出价。

CategoryBid

LocalServicesReportingCampaignSettings 中的类别出价。

JSON 表示法 
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
字段
categoryId

string

与出价相关联的类别。例如，xcat:service_area_business_plumber。
manualCpaBidMicros

string (int64 format)

相应类别的每次转化费用人工出价。出价必须高于该类别的预订价格。值以微单位和广告客户的货币为单位。

TravelCampaignSettings

旅行广告系列的设置。

JSON 表示法 
{
  "travelAccountId": string
}
字段
travelAccountId

string (int64 format)

不可变。与旅行广告系列相关联的旅行帐号 ID。

DiscoveryCampaignSettings

发现广告系列的设置。

JSON 表示法 
{
  "upgradedTargeting": boolean
}
字段
upgradedTargeting

boolean

不可变。指定此广告系列是否使用升级版定位选项。当此字段设为true时，您可以在广告组一级使用地理位置和语言定位，而不是在广告系列一级使用标准定位。此字段默认为 false，且只能在制作广告系列时设置。

RealTimeBiddingSetting

实时出价设置，这项功能仅适用于定位到 Ad Exchange 广告网络的广告系列。

JSON 表示法 
{
  "optIn": boolean
}
字段
optIn

boolean

广告系列是否启用了实时出价。

NetworkSettings

广告系列的投放网络设置。

JSON 表示法 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
字段
targetSearchNetwork

boolean

广告是否会在 Google 搜索网络的合作伙伴网站上投放（targetGoogleSearch 必须为 true）。
targetContentNetwork

boolean

广告是否将在 Google 展示广告网络中的指定展示位置投放。展示位置是使用“展示位置”条件指定的。
targetPartnerSearchNetwork

boolean

广告是否将在 Google 合作伙伴网络中投放。这仅可用于部分 Google 合作伙伴账号。

HotelSettingInfo

酒店广告的广告系列级设置。

JSON 表示法 
{
  "hotelCenterId": string
}
字段
hotelCenterId

string (int64 format)

不可变。关联的 Hotel Center 帐号。

DynamicSearchAdsSetting

用于控制动态搜索广告 (DSA) 的设置。

JSON 表示法 
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
字段
domainName

string

必需。此设置所代表的互联网域名，例如“google.com”或“www.google.com”。
languageCode

string

必需。用于指定网域语言的语言代码，例如“en”。
feeds[]

string

与广告系列相关联的页面 Feed 的列表。
useSuppliedUrlsOnly

boolean

广告系列是否仅使用广告客户提供的网址。

ShoppingSetting

购物广告系列的设置。定义此广告系列可以宣传的产品，以及此广告系列与其他购物广告系列互动的方式。

JSON 表示法 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
字段
feedLabel

string

要添加到广告系列中的产品的 Feed 标签。只能设置 feedLabel 和 salesCountry 中的一个。如果使用 feedLabel 字段替代 salesCountry，则 FeedLabel 字段接受相同格式的国家/地区代码，例如“XX”。否则，该值可以是用于 Google Merchant Center 中 Feed 标签的任何字符串。
useVehicleInventory

boolean

不可变。是否定位到车辆详情广告资源。只有智能购物广告系列支持此字段。如需在效果最大化广告系列中设置车辆详情广告资源，请改用 listingType。
advertisingPartnerIds[]

string (int64 format)

不可变。广告系列中合作的广告合作伙伴的广告账号 ID。
merchantId

string (int64 format)

不可变。Merchant Center 帐号的 ID。对于创建操作，此字段是必填字段。对于购物广告系列，此字段不可更改。
salesCountry

string

要添加到广告系列中的产品的目标销售国家/地区。只能设置 feedLabel 和 salesCountry 中的一个。除清除外，字段不可更改。清除此字段后，如果您要设置目标销售国家/地区，则必须使用 feedLabel。
campaignPriority

integer

广告系列的优先级。数值较高的广告系列的优先级高于优先级较低的广告系列。此字段是购物广告系列的必填字段，值介于 0 和 2 之间（含 0 和 2）。此字段对于智能购物广告系列是选填字段，但如果设置，则必须等于 3。
enableLocal

boolean

是否添加本地商品。

AudienceSetting

受众群体定位的设置。

JSON 表示法 
{
  "useAudienceGrouped": boolean
}
字段
useAudienceGrouped

boolean

不可变。如果为 true，则此广告系列会使用受众群体资源进行受众群体定位。如果为 false，此广告系列可能会改用细分受众群条件。

GeoTargetTypeSetting

表示与广告地理位置定位相关的设置的集合。

JSON 表示法 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
字段
positiveGeoTargetType

enum (PositiveGeoTargetType)

用于在此特定广告系列中进行肯定地理位置定位的设置。
negativeGeoTargetType

enum (NegativeGeoTargetType)

用于在此特定广告系列中进行排除性地理位置定位的设置。

PositiveGeoTargetType

可能的正地理位置定位类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
PRESENCE_OR_INTEREST 指定当用户位于广告客户定位到的地理位置或对其表现出兴趣时，即会触发广告。
SEARCH_INTEREST 指定在用户搜索广告客户定位到的地理位置时触发广告。只能用于搜索广告系列和标准购物广告系列。
PRESENCE 指定当用户位于或经常位于广告客户的定位到的地理位置时触发广告。

NegativeGeoTargetType

可能的排除地理位置定位类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
PRESENCE_OR_INTEREST 指定在用户位于广告客户排除的地理位置或对其表现出兴趣时，不向其展示广告。
PRESENCE 指定在用户位于广告客户排除的地理位置时，无法看到广告。

LocalCampaignSetting

本地广告系列的广告系列设置。

JSON 表示法 
{
  "locationSourceType": enum (LocationSourceType)
}
字段
locationSourceType

enum (LocationSourceType)

此本地广告系列的地理位置来源类型。

LocationSourceType

位置信息来源的可能类型。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
GOOGLE_MY_BUSINESS 与客户关联的商家资料相关联的营业地点。
AFFILIATE 联属营销（连锁）商店位置。例如，Best Buy 商店位置。

AppCampaignSetting

应用广告系列的广告系列级设置。

JSON 表示法 
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
字段
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

表示此应用广告系列的出价策略应针对的目标进行优化。
appStore

enum (AppCampaignAppStore)

不可变。分发此特定应用的应用商店。
appId

string

不可变。一个唯一标识移动应用的字符串。

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 (FrequencyCapKey)
  },
  "cap": integer
}
字段
key

object (FrequencyCapKey)

特定频次上限的键。最多只能有一个频次上限。
cap

integer

在相应时间范围内允许此上限的事件数上限。

FrequencyCapKey

用作频次上限的键的一组字段。最多只能有一个频次上限。

JSON 表示法 
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
字段
level

enum (FrequencyCapLevel)

上限所应用的级别（例如，广告组广告、广告组）。该上限应用于该级别的所有实体。
eventType

enum (FrequencyCapEventType)

该上限所适用的事件类型（例如展示）。
timeUnit

enum (FrequencyCapTimeUnit)

定义上限所用的时间单位（例如日、周）。
timeLength

integer

该上限持续的时间单位数。

FrequencyCapLevel

上限所应用的级别（例如广告组广告、广告组）。上限应用于此级别的所有资源。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AD_GROUP_AD 该上限在广告组广告级别应用。
AD_GROUP 该上限在广告组一级应用。
CAMPAIGN 该上限在广告系列一级应用。

FrequencyCapEventType

该上限所适用的事件类型（例如展示）。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
IMPRESSION 该上限适用于广告展示次数。
VIDEO_VIEW 该上限适用于视频广告观看次数。

BrandSafetySuitability

3 级品牌保障适宜性控制。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EXPANDED_INVENTORY 选择此选项后，您可以在 YouTube 和视频合作伙伴上所有符合我们创收标准的广告资源中展示广告。对于希望能够最大限度地使用符合广告投放条件的各类视频的品牌而言，此选项可能是一个合适的选择，此类视频包括但不限于：大量使用粗言秽语的喜剧类或纪实类视频，包含大量暴力内容的视频游戏等。
STANDARD_INVENTORY 此选项让您可以在适合大多数品牌的各种内容（例如流行音乐视频、纪录片和电影预告片）中展示广告。您可以在其中展示广告的内容基于 YouTube 的“适合投放广告的内容”准则，这些准则会考虑粗言秽语的强烈程度或出现频率，或者敏感事件等主题的适宜程度等。例如，如果内容中屡次出现重度粗言秽语、包含大量色情内容或血腥暴力画面，广告将不会展示。
LIMITED_INVENTORY 此选项允许您在较小范围的内容中展示广告，适用于对不当语言和性暗示有特别严格的准则（超越了 YouTube 的“适合投放广告的内容”准则）的品牌。可在此敏感类别中访问的视频需满足更高的要求，尤其是针对不当用语和性暗示内容的要求。例如，在 YouTube 和 Google 视频合作伙伴网站上，您的广告将不会伴随 YouTube 上某些最热门的音乐视频及其他流行文化内容展示。

VanityPharma

描述非品牌医药广告的显示方式。

JSON 表示法 
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
字段
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

个性化药店网址的显示模式。
vanityPharmaText

enum (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[]

string

用于优化此广告系列的一组选定的转化操作。

OptimizationGoalSetting

此广告系列的优化目标设置，其中包括一组优化目标类型。

JSON 表示法 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
字段
optimizationGoalTypes[]

enum (OptimizationGoalType)

优化目标类型的列表。

OptimizationGoalType

优化目标的类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用作返回值。表示此版本中的未知值。
CALL_CLICKS 针对点击致电进行优化。致电点击转化是指用户在浏览广告后选择“致电”联系商店的次数。
DRIVING_DIRECTIONS 针对行车路线进行优化。查询行车路线转化次数是指用户在浏览广告后选择“查询路线”导航到相应商店的次数。
APP_PRE_REGISTRATION 针对预注册进行优化。预注册转化次数是指当应用发布时用户收到通知的预注册用户数量。

TrackingSetting

与跟踪信息相关的广告系列级设置。

JSON 表示法 
{
  "trackingUrl": string
}
字段
trackingUrl

string

仅限输出。用于动态跟踪的网址。

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 (PerformanceMaxUpgradeStatus)
}
字段
performanceMaxCampaign

string

仅限输出。指明广告系列升级到的效果最大化广告系列。
preUpgradeCampaign

string

仅限输出。表示旧版广告系列已升级为效果最大化广告系列。
status

enum (PerformanceMaxUpgradeStatus)

仅限输出。某个广告系列的升级状态请求升级为效果最大化广告系列。

PerformanceMaxUpgradeStatus

广告系列的效果最大化广告系列升级状态枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
UPGRADE_ELIBIGLE 广告系列符合升级为效果最大化广告系列的条件。
UPGRADE_IN_PROGRESS 正在升级为效果最大化广告系列。
UPGRADE_COMPLETE 效果最大化广告系列的升级已完成。
UPGRADE_FAILED 未能升级为效果最大化广告系列。广告系列仍会像尝试升级之前一样投放。

ListingType

可能的商品详情类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
VEHICLES 此广告系列将投放车辆广告。

佣金

“佣金”是一种自动出价策略，在这种策略中，广告客户支付一定比例的转化价值。

JSON 表示法 
{
  "commissionRateMicros": string
}
字段
commissionRateMicros

string (int64 format)

佣金率决定了在转化价值中，广告客户需要支付的那部分费用。佣金率 x 应以 (x * 1,000,000) 的格式传入此字段。例如，106,000 表示佣金率为 0.106 (10.6%)。

ManualCpa

此类型没有任何字段。

一种人工出价策略，可让广告客户按广告客户指定的操作设置出价。

ManualCpc

基于点击的人工出价，此类出价中用户按点击次数付费。

JSON 表示法 
{
  "enhancedCpcEnabled": boolean
}
字段
enhancedCpcEnabled

boolean

是否根据转化优化工具数据增强出价。

ManualCpm

此类型没有任何字段。

基于展示次数的人工出价，此类出价中用户按每千次展示付费。

ManualCpv

此类型没有任何字段。

基于观看的出价，用户每次观看视频时都需要付费。

PercentCpc

一种出价策略。采用这种出价策略时，出价为某些商品或服务所宣传价格的一小部分。

JSON 表示法 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
字段
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此字段由广告客户输入，以本地货币微单位指定。注意：零值的解释方式与未定义 bid_曲目相同。
enhancedCpcEnabled

boolean

根据发生转化的可能性上下调整每次竞价的出价。各个出价可以超过 cpcBidCeilingMicros，但广告系列的平均出价金额不应超过 cpcBidCeilingMicros。

TargetCpm

目标每千次展示费用是一种自动出价策略，它会根据您设置的目标每千次展示费用来设置出价，以优化广告效果。

JSON 表示法 
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
字段
联合字段 goal。与出价目标有关的其他信息。goal 只能是下列其中一项：
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

“目标频次”出价目标的相关详情。

TargetCpmTargetFrequencyGoal

“目标频次”出价目标的相关详情。

JSON 表示法 
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
字段
targetCount

string (int64 format)

“目标频次”计数，表示您希望覆盖单个用户的次数。
timeUnit

enum (TargetFrequencyTimeUnit)

表示您希望在这段时间内达到指定 targetCount 的时间段。

TargetFrequencyTimeUnit

描述我们希望达到目标频次的时间范围的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
WEEKLY 优化出价，在一周内达到目标频次。