Campaign

{
  "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)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "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)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "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)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}

string

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

customers/{customerId}/campaigns/{campaignId}

enum (CampaignPrimaryStatus)

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

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

enum (CampaignPrimaryStatusReason)

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

深入了解广告系列未投放或未以最佳方式投放的原因。系统会汇总这些原因，以确定总体 CampaignPrimaryStatus。

enum (CampaignStatus)

广告系列的状态。

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

enum (CampaignServingStatus)

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

enum (BiddingStrategySystemStatus)

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

enum (AdServingOptimizationStatus)

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

enum (AdvertisingChannelType)

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

此字段为必填字段，在创建新广告系列时不应为空。

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

enum (AdvertisingChannelSubType)

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

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

object (CustomParameter)

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

object (LocalServicesCampaignSettings)

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

object (TravelCampaignSettings)

旅游广告系列的设置。

object (DemandGenCampaignSettings)

需求开发广告系列的设置。

object (VideoCampaignSettings)

视频广告系列的设置。

object (RealTimeBiddingSetting)

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

object (NetworkSettings)

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

object (HotelSettingInfo)

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

object (DynamicSearchAdsSetting)

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

object (ShoppingSetting)

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

object (TargetingSetting)

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

object (GeoTargetTypeSetting)

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

object (LocalCampaignSetting)

本地广告系列的设置。

object (AppCampaignSetting)

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

string

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

enum (CampaignExperimentType)

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

enum (BiddingStrategyType)

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

您可以通过以下方式创建出价策略：设置出价方案来创建标准出价策略，或设置 biddingStrategy 字段来创建组合出价策略。

此字段为只读字段。

string

仅限输出。AccessibleBiddingStrategy 的资源名称，是指通过“biddingStrategy”标识的附加组合出价策略的无限制属性的只读视图。如果广告系列未使用组合策略，则为空。不受限制的策略属性可供与该策略共享的所有客户使用，并且会从 AccessibleBiddingStrategy 资源读取。与之相反，受限属性仅供策略的客户所有者及其经理使用。受限属性只能从 BiddingStrategy 资源读取。

object (FrequencyCapEntry)

用于限制每位用户看到此广告系列的广告的频率的列表。

enum (BrandSafetySuitability)

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

object (VanityPharma)

说明非品牌药品广告的展示方式。

object (SelectiveOptimization)

此广告系列的选择性优化设置，其中包含一组要针对此广告系列进行优化的转化操作。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType 且将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。

object (OptimizationGoalSetting)

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

object (TrackingSetting)

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

enum (PaymentMode)

广告系列的付款模式。

enum (AssetFieldType)

应从此广告系列中排除的素材资源字段类型。此广告系列不会从上级继承使用这些字段类型的素材资源关联。

enum (AssetSetType)

应从此广告系列中排除的素材资源组类型。此广告系列不会从上级继承具有这些类型的素材资源组关联。营业地点组类型（GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP 和 STATIC_LOCATION_GROUP）是 LOCATION_SYNC 的子类型。因此，如果为此字段设置了 LOCATION_SYNC，则所有营业地点组素材资源集都将无法与此广告系列相关联，并且此广告系列下将不会投放任何附加地址信息 (LE) 和附加关联商户地址信息 (ALE)。目前仅支持 LOCATION_SYNC。

object (PerformanceMaxUpgrade)

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

object (AssetAutomationSetting)

包含每个 AssetAutomationType 的选择启用/停用状态。如需了解默认的选择启用/停用行为，请参阅每种素材资源自动化类型枚举的文档。

enum (CampaignKeywordMatchType)

广告系列的关键字匹配类型。设置为“广泛”可为广告系列中的所有关键字设置广泛匹配。

string (int64 format)

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

string

广告系列的名称。

此字段为必填字段，在创建新广告系列时不应为空。

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

string

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

object (AudienceSetting)

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

string

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

此字段为只读字段。

string

广告系列的广告系列预算资源名称。

string

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

string

此广告系列所属广告系列组的资源名称。

string

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

string

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

number

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

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

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

此字段为只读字段。

boolean

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

string

不可变。指定旅行目标的效果最大化广告系列中一组酒店房源的资源名称。

enum (ListingType)

不可变。为此广告系列投放的广告的广告素材资源类型。此字段仅可用于效果最大化广告系列。

string

广告系列使用的组合出价策略的资源名称。

object (Commission)

佣金是一种自动出价策略，广告客户需要支付转化价值的一定比例。

object (ManualCpa)

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

object (ManualCpc)

标准的每次点击费用人工出价策略。按点击次数手动出价，用户按点击次数付费。

object (ManualCpm)

标准的“每千次展示费用人工出价”策略。按展示次数进行人工出价，用户按每千次展示付费。

object (ManualCpv)

一种出价策略，按每次视频观看付费，付费金额可进行配置。

object (MaximizeConversions)

标准的“尽可能提高转化次数”出价策略，可在不超出预算的前提下自动争取尽可能多的转化次数。

object (MaximizeConversionValue)

标准的“尽可能提高转化价值”出价策略，可自动设置出价，以便在您的预算范围内，尽可能提高收入。

object (TargetCpa)

标准的“目标每次转化费用”出价策略，可自动设置适当的出价，帮助您以自己设定的目标每次转化费用 (CPA) 争取到尽可能多的转化。

object (TargetImpressionShare)

“目标展示次数份额”出价策略。这是一种自动出价策略，系统会根据所选的展示次数百分比设置出价。

object (TargetRoas)

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

object (TargetSpend)

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

object (PercentCpc)

标准的“百分比形式的每次点击费用”出价策略，其中出价是某件商品或服务的广告价格的一小部分。

object (TargetCpm)

一种自动优化每千次展示费用的出价策略。

object (FixedCpm)

一种设定固定每千次展示费用的人工出价策略。

object (TargetCpv)

一种自动出价策略，可根据您设置的目标每次转化费用 (CPV) 设置出价，以优化效果。