广告组。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resourceName |
不可变。广告组的资源名称。广告组资源名称采用以下格式:
|
status |
广告组的状态。 |
type |
不可变。广告组的类型。 |
adRotationMode |
广告组的广告轮播模式。 |
urlCustomParameters[] |
用于替换 |
optimizedTargetingEnabled |
如果已启用优化型定位,则为“true”。“优化型定位”将取代“受众群体扩展”。 |
displayCustomBidDimension |
可让广告主指定要为其设置绝对出价的定位维度。仅适用于仅定位展示广告网络而不是搜索网络的广告系列。 |
targetingSetting |
用于定位相关功能的设置。 |
audienceSetting |
不可变。受众群体相关功能的设置。 |
effectiveTargetCpaSource |
仅供输出。有效目标每次转化费用的来源。此字段为只读字段。 |
effectiveTargetRoasSource |
仅供输出。有效目标广告支出回报率的来源。此字段为只读字段。 |
labels[] |
仅供输出。附加到此广告组的标签的资源名称。 |
excludedParentAssetFieldTypes[] |
应从此广告组中排除的素材资源字段类型。此广告组不会从较高级别沿用包含这些字段类型的素材资源链接。 |
excludedParentAssetSetTypes[] |
应从此广告组中排除的素材资源集类型。此广告组不会从较高级别沿用具有这些类型的素材资源集链接。营业地点组类型(GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP 和 STATIC_LOCATION_GROUP)是 LOCATION_SYNC 的子级类型。因此,如果为此字段设置了 LOCATION_SYNC,则不允许将任何营业地点组素材资源组与此广告组相关联,并且此广告组中的所有附加地址信息 (LE) 和附加关联商户地址信息 (ALE) 都不会投放。目前仅支持 LOCATION_SYNC。 |
id |
仅供输出。广告组的 ID。 |
name |
广告组的名称。 此字段是必填字段,在创建新广告组时不应留空。 包含的 UTF-8 全角字符必须少于 255 个。 并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
baseAdGroup |
仅供输出。对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基准广告组,则此字段为 null。 对于基本广告组,此字段等于广告组资源名称。 此字段为只读字段。 |
trackingUrlTemplate |
用于构建跟踪网址的网址模板。 |
campaign |
不可变。广告组所属的广告系列。 |
cpcBidMicros |
每次点击费用出价上限。 |
effectiveCpcBidMicros |
仅供输出。当出价策略为人工每次点击费用、智能点击付费、首页顶部广告或排名胜出率目标时,此值将与每次点击费用 (CPC) 出价的值相同,否则此值将为 null。 |
cpmBidMicros |
每千次展示费用(每千次可见展示费用)出价上限。 |
targetCpaMicros |
目标每次转化费用。如果广告组的广告系列出价策略是 TargetCpa 或“尽可能提高转化次数”(其 targetCpa 字段已设置),则此字段将替换广告系列的出价策略中指定的目标每次转化费用。否则,系统会忽略此值。 |
cpvBidMicros |
每次观看费用 (cost-per-view) 出价。 |
targetCpmMicros |
广告客户愿意为广告获得的每千次展示支付的平均金额(以微单位表示)。 |
targetRoas |
目标广告支出回报率替换值。如果广告组的广告系列出价策略是 TargetRoas 或 尽可能提高转化价值(其 targetRoas 字段已设置),则此字段会替换广告系列的出价策略中指定的目标广告支出回报率。否则,系统会忽略此值。 |
percentCpcBidMicros |
每次点击费用出价金额百分比,表示为某种商品或服务广告价格的一定比例。分数的有效范围是 [0,1),此处存储的值为 1,000,000 * [fraction]。 |
finalUrlSuffix |
用于将参数附加到最终到达网址的网址模板。 |
effectiveTargetCpaMicros |
仅供输出。有效目标每次转化费用 (cost-per-acquisition)。此字段为只读字段。 |
effectiveTargetRoas |
仅供输出。有效目标广告支出回报率 (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 |
不可变。如果为 true,此广告组会使用受众群体资源进行受众群体定位。如果为 false,此广告组可以改用细分受众群条件。 |