- JSON 表示法
- AdGroupStatus
- AdGroupAdRotationMode
- AudienceSetting
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 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 |
每次点击费用 (cost-per-click) 出价上限。 |
effectiveCpcBidMicros |
仅限输出。当出价策略是每次点击费用人工出价、智能点击付费、首页推广或排名胜出率目标之一时,此值将与每次点击费用出价值相同,否则此值将为 null。 |
cpmBidMicros |
每千次展示费用(每千次可见展示费用)出价上限。 |
targetCpaMicros |
目标每次转化费用。如果广告组的广告系列出价策略是 TargetCpa 或 尽可能提高转化次数(设置了 targetCpa 字段),则此字段会替换广告系列的出价策略中指定的目标每次转化费用。否则,系统会忽略此值。 |
cpvBidMicros |
每次观看费用 (cost-per-view) 出价。 |
targetCpmMicros |
广告客户愿意为广告获得的每千次展示支付的平均金额(以微单位表示)。 |
targetRoas |
目标广告支出回报率。如果广告组的广告系列出价策略是 TargetRoas 或 MaximizeConversionValue(设置了 targetRoas 字段),则此字段会替换广告系列的出价策略中指定的目标广告支出回报率。否则,系统会忽略此值。 |
percentCpcBidMicros |
每次点击费用出价金额的百分比,表示为某些商品或服务的广告价格的比例。分数的有效范围为 [0,1),此处存储的值为 1,000,000 * [fraction]。 |
fixedCpmMicros |
广告客户为广告的每千次展示支付的固定金额(以微单位表示)。 |
targetCpvMicros |
广告客户愿意为每次广告观看支付的平均金额(以微单位表示)。 |
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 有贡献。 |