- JSON 表示法
- AdGroupStatus
- AdGroupAdRotationMode
- AudienceSetting
- AdGroupPrimaryStatus
- AdGroupPrimaryStatusReason
广告组。
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。 |
primaryStatus |
仅限输出。提供汇总视图,让您了解某个广告组为何未能投放或未能实现最佳效果。 |
primaryStatusReasons[] |
仅限输出。说明广告组无法投放或未实现最佳投放的原因。 |
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 * [分数]。 |
finalUrlSuffix |
用于将参数附加到最终到达网址的网址模板。 |
effectiveTargetCpaMicros |
仅限输出。有效目标每次转化费用 (cost-per-acquisition)。此字段为只读字段。 |
effectiveTargetRoas |
仅限输出。有效目标广告支出回报率 (return-on-ad-spend)。此字段为只读字段。 |
AdGroupStatus
广告组的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定状态。 |
UNKNOWN |
此版本中未知的值。 这是一个仅用于响应的值。 |
ENABLED |
该广告组已启用。 |
PAUSED |
广告组已暂停。 |
REMOVED |
该广告组会被移除。 |
AdGroupAdRotationMode
广告组可能采用的广告轮播模式。
枚举 | |
---|---|
UNSPECIFIED |
未指定广告轮播模式。 |
UNKNOWN |
此版本中未知的值。 这是一个仅用于响应的值。 |
OPTIMIZE |
根据点击次数或转化次数优化广告组中的广告。 |
ROTATE_FOREVER |
永久均匀轮播。 |
AudienceSetting
受众群体定位的设置。
JSON 表示法 |
---|
{ "useAudienceGrouped": boolean } |
字段 | |
---|---|
useAudienceGrouped |
不可变。如果为 true,此广告组将使用受众群体资源进行受众群体定位。如果为 false,此广告组可以改用细分受众群条件。 |
AdGroupPrimaryStatus
广告组的可能状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ELIGIBLE |
广告组符合投放条件。 |
PAUSED |
广告组已暂停。 |
REMOVED |
该广告组会被移除。 |
PENDING |
此广告组将来可能会投放。 |
NOT_ELIGIBLE |
此广告组不符合投放条件。 |
LIMITED |
此广告组的投放能力受限。 |
AdGroupPrimaryStatusReason
广告组处于此状态的可能原因。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
CAMPAIGN_REMOVED |
系统会移除用户指定的广告系列状态。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
CAMPAIGN_PAUSED |
用户指定的广告系列状态为“已暂停”。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
CAMPAIGN_PENDING |
用户指定的此广告系列的开始时间是将来的时间。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE |
CAMPAIGN_ENDED |
用户指定的此广告系列的结束时间已过。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
AD_GROUP_PAUSED |
用户指定的广告组状态为“已暂停”。有助于 AdGroupPrimaryStatus.PAUSED。 |
AD_GROUP_REMOVED |
用户指定的广告组状态会被移除。有助于 AdGroupPrimaryStatus.REMOVED。 |
AD_GROUP_INCOMPLETE |
此广告组的构建尚未完成。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
KEYWORDS_PAUSED |
此广告组中的用户指定的关键字状态均已暂停。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
NO_KEYWORDS |
此广告组中没有符合条件的关键字。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
AD_GROUP_ADS_PAUSED |
此广告组中用户指定的广告组广告状态均已暂停。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
NO_AD_GROUP_ADS |
此广告组中没有符合条件的广告组广告。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
HAS_ADS_DISAPPROVED |
至少有一个广告被拒登时的政策状态原因。导致出现多个 AdGroupPrimaryStatus。 |
HAS_ADS_LIMITED_BY_POLICY |
至少有一个广告受到政策限制时的政策状态原因。导致出现多个 AdGroupPrimaryStatus。 |
MOST_ADS_UNDER_REVIEW |
大多数广告处于待审核状态时的政策状态原因。有助于 AdGroupPrimaryStatus.PENDING。 |
CAMPAIGN_DRAFT |
此广告组属于广告系列草稿。有助于 AdGroupPrimaryStatus.NOT_ELIGIBLE。 |
AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY |
由于投放活动持续低水平,广告组已暂停。有助于 AdGroupPrimaryStatus.PAUSED。 |