AdGroup

广告组。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}
字段
resourceName

string

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

customers/{customerId}/adGroups/{adGroupId}
status

enum (AdGroupStatus)

广告组的状态。
type

enum (AdGroupType)

不可变。广告组的类型。
adRotationMode

enum (AdGroupAdRotationMode)

广告组的广告轮播模式。
urlCustomParameters[]

object (CustomParameter)

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

boolean

如果已启用优化型定位，则为“true”。“优化型定位”将取代“受众群体扩展”。
displayCustomBidDimension

enum (TargetingDimension)

可让广告主指定要为其设置绝对出价的定位维度。仅适用于仅定位展示广告网络而不是搜索网络的广告系列。
targetingSetting

object (TargetingSetting)

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

object (AudienceSetting)

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

enum (BiddingSource)

仅供输出。有效目标每次转化费用的来源。此字段为只读字段。
effectiveTargetRoasSource

enum (BiddingSource)

仅供输出。有效目标广告支出回报率的来源。此字段为只读字段。
labels[]

string

仅供输出。附加到此广告组的标签的资源名称。
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。
id

string (int64 format)

仅供输出。广告组的 ID。
name

string

广告组的名称。

此字段是必填字段，在创建新广告组时不应留空。

包含的 UTF-8 全角字符必须少于 255 个。

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

string

仅供输出。对于草稿或实验广告组，此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基准广告组，则此字段为 null。

对于基本广告组，此字段等于广告组资源名称。

此字段为只读字段。
trackingUrlTemplate

string

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

string

不可变。广告组所属的广告系列。
cpcBidMicros

string (int64 format)

每次点击费用出价上限。
effectiveCpcBidMicros

string (int64 format)

仅供输出。当出价策略为人工每次点击费用、智能点击付费、首页顶部广告或排名胜出率目标时，此值将与每次点击费用 (CPC) 出价的值相同，否则此值将为 null。
cpmBidMicros

string (int64 format)

每千次展示费用（每千次可见展示费用）出价上限。
targetCpaMicros

string (int64 format)

目标每次转化费用。如果广告组的广告系列出价策略是 TargetCpa 或“尽可能提高转化次数”（其 targetCpa 字段已设置），则此字段将替换广告系列的出价策略中指定的目标每次转化费用。否则，系统会忽略此值。
cpvBidMicros

string (int64 format)

每次观看费用 (cost-per-view) 出价。
targetCpmMicros

string (int64 format)

广告客户愿意为广告获得的每千次展示支付的平均金额（以微单位表示）。
targetRoas

number

目标广告支出回报率替换值。如果广告组的广告系列出价策略是 TargetRoas 或 尽可能提高转化价值（其 targetRoas 字段已设置），则此字段会替换广告系列的出价策略中指定的目标广告支出回报率。否则，系统会忽略此值。
percentCpcBidMicros

string (int64 format)

每次点击费用出价金额百分比，表示为某种商品或服务广告价格的一定比例。分数的有效范围是 [0,1)，此处存储的值为 1,000,000 * [fraction]。
finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。
effectiveTargetCpaMicros

string (int64 format)

仅供输出。有效目标每次转化费用 (cost-per-acquisition)。此字段为只读字段。
effectiveTargetRoas

number

仅供输出。有效目标广告支出回报率 (return-on-ad-spend)。此字段为只读字段。

AdGroupStatus

广告组的可能状态。

枚举
UNSPECIFIED 尚未指定状态。
UNKNOWN

此版本中未知接收的值。

这是一个仅用于响应的值。
ENABLED 广告组已启用。
PAUSED 广告组已暂停。
REMOVED 该广告组会被移除。

AdGroupType

列出可能的广告组类型的枚举。

枚举
UNSPECIFIED 尚未指定类型。
UNKNOWN

此版本中未知接收的值。

这是一个仅用于响应的值。
SEARCH_STANDARD 搜索广告系列的默认广告组类型。
DISPLAY_STANDARD 展示广告系列的默认广告组类型。
SHOPPING_PRODUCT_ADS 投放标准产品广告的购物广告系列的广告组类型。
HOTEL_ADS 酒店广告系列的默认广告组类型。
SHOPPING_SMART_ADS 智能购物广告系列中广告组的类型。
VIDEO_BUMPER 不可跳过的简短插播视频广告。
VIDEO_TRUE_VIEW_IN_STREAM TrueView（可跳过）插播视频广告。
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView 展示视频广告。
VIDEO_NON_SKIPPABLE_IN_STREAM 不可跳过的插播视频广告。
VIDEO_OUTSTREAM 外播视频广告。
SEARCH_DYNAMIC_ADS 动态搜索广告广告组的广告组类型。
SHOPPING_COMPARISON_LISTING_ADS 购物比价购物广告系列中广告组的类型。
PROMOTED_HOTEL_ADS 促销酒店广告组的广告组类型。
VIDEO_RESPONSIVE 视频自适应广告组。
VIDEO_EFFICIENT_REACH 视频“经济实惠地扩大覆盖面”广告组。
SMART_CAMPAIGN_ADS 智能广告系列的广告组类型。
TRAVEL_ADS 旅游广告系列的广告组类型。

AdGroupAdRotationMode

广告组可能采用的广告轮播模式。

枚举
UNSPECIFIED 尚未指定广告轮播模式。
UNKNOWN

此版本中未知接收的值。

这是一个仅用于响应的值。
OPTIMIZE 根据点击次数或转化次数优化广告组广告。
ROTATE_FOREVER 永久均匀轮播。

AudienceSetting

受众群体定位设置。

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

boolean

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