| Field name | Field type | Field description |
|---|
campaignId |
int |
The numeric ID of the campaign to which this ad group belongs.
This field is immutable. |
id |
long |
The numeric ID of this ad group.
AdGroupService sets the id when you create a new ad group.
If you provide the id when creating an ad group, it will be ignored.
This field is immutable. |
keywordContentMaxCpc
new in v11 |
long |
The maximum cost-per-click bid for content network clicks in this
ad group.
You can set this field only if the associated campaign's
enableSeparateContentBids
field is true.
Setting this field overrides keywordMaxCpc and
all associated keyword maxCpc settings.
See the
note on bid amounts for more
information on using this field. |
keywordMaxCpc
new in v11 |
long |
The default maximum cost-per-click bid for Keyword criteria in this
ad group. See the
note on bid amounts for more
information on using this field.
If this field is set, then siteMaxCpm and siteMaxCpc must not be set. |
maxContentCpc |
long |
The maximum cost-per-click bid for content network clicks in this
ad group, in micro-units of currency. This setting overrides any maxCpc
setting for keywords that belong to this ad group. This setting is
ignored unless the enableSeparateContentBids flag is set for this
campaign. The bid amount must not be too small or too large and must be a
multiple of the billing unit for the relevant currency (so, for example,
in US dollars, you can't bid half-pennies). The currency used for
interpretation is the one already associated with the account. |
maxCpa
new in v12 |
long |
The maximum cost-per-acquisition (conversion) bid for this ad group. This
field is ignored unless conversion optimizer is enabled for the associated
campaign.
See the
note on bid amounts for more
information on using this field. |
maxCpc |
long |
The default maximum cost-per-click bid for keywords in this
ad group in
micro-units of currency.
The bid amount must not be too small or too large and must be a
multiple of the billing unit for the relevant currency (for example,
in US dollars, you can't bid half-pennies).
The currency used for
interpretation is the one already associated with the account.
If this field is set then maxCpm must not be set, as each AdGroup
needs to be CPC-based or CPM-based. |
maxCpm |
long |
The default maximum cost-per-impression bid for site targeted ads
in this ad group, in
micro-units of currency.
The bid amount must not be too small or too large and must be a
multiple of the billing unit for the relevant currency (so, for example,
in US dollars, you can't bid half-pennies). The currency used for
interpretation is the one already associated with the account.
If this field is set then maxCpc must not be set, as each ad group
needs to be CPC-based or CPM-based. |
name |
string |
The human-readable name of this ad group.
The name must be unique among all ad groups associated with
the same campaign. If you omit the name when creating an ad group,
a default value of the form "Ad Group #n" will be used. |
proxyKeywordMaxCpc
new in v11 |
long |
When present, this read-only field indicates that there is a default proxy
bid that is being placed on behalf of this ad group. This will be the case,
for instance, when budget optimizer is turned on for the campaign that
this ad group is a part of. |
proxyMaxCpc |
long |
When present, this read-only field indicates that there is a default proxy
bid that is being placed on behalf of this ad group. This will be the
case, for instance, when budget optimizer is enabled for the campaign
this ad group is a part of. |
siteMaxCpc
new in v12 |
long |
The default maximum cost-per-click bid for Website criteria in this
ad group. See the
note on bid amounts for more
information on using this field.
If this field is set, then siteMaxCpm and keywordMaxCpc must not be
set. |
siteMaxCpm
new in v11 |
long |
The default maximum cost-per-mille (thousand impressions) bid for
Website criteria in this ad group. See the
note on bid amounts for more
information on using this field.
If this field is set, then keywordMaxCpc and siteMaxCpc must not be
set. |
status |
AdGroupStatus |
The status of this ad group.
When you create a new ad group, the default status is Enabled
unless otherwise specified. Enabled ads are served; paused or deleted ads
are not served.
Values are:
|
API Reference
