AdGroup

{
  "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)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "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
}

string

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

customers/{customerId}/adGroups/{adGroupId}

enum (AdGroupStatus)

广告组的状态。

enum (AdGroupType)

不可变。广告组的类型。

enum (AdGroupAdRotationMode)

广告组的广告轮播模式。

object (CustomParameter)

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

boolean

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

enum (TargetingDimension)

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

object (TargetingSetting)

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

object (AudienceSetting)

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

enum (BiddingSource)

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

enum (BiddingSource)

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

string

仅限输出。附加到此广告组的标签的资源名称。

enum (AssetFieldType)

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

enum (AssetSetType)

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

enum (AdGroupPrimaryStatus)

仅限输出。提供汇总视图，让您了解某个广告组为何未能投放或未能实现最佳效果。

enum (AdGroupPrimaryStatusReason)

仅限输出。说明广告组无法投放或未实现最佳投放的原因。

string (int64 format)

仅限输出。广告组的 ID。

string

广告组的名称。

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

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

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

string

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

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

此字段为只读字段。

string

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

string

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

string (int64 format)

每次点击费用出价上限。

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

string (int64 format)

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

string

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

string (int64 format)

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

number

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