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)
  },
  "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)
  }
  // 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 (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

仅限输出。Accessible BiddingStrategy 的资源名称，其中包含附加组合出价策略（由“biddingStrategy”标识）的不受限制属性的只读视图。如果广告系列未使用组合策略，则为空。不受限制的策略属性可供共享策略的所有客户使用，并从 AccessibleBidStrategy 资源中读取。相比之下，受限属性仅适用于策略的所有者客户及其经理。受限属性只能从 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 中指定的网址。如果选择启用 (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)

标准的“目标广告支出回报率”出价策略，可在确保平均广告支出回报率的同时，自动最大限度提高收入。

object (TargetSpend)

“标准目标支出”出价策略，可自动设置您的出价，帮助您在预算范围内争取尽可能多的点击。

object (PercentCpc)

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

object (TargetCpm)

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