My favorites | English | Sign in

Faster JavaScript with Closure Tools New!

Documentation for the requested version is not available.Documentation for the requested diff is not available.

AdGroup

Link to this version

Data associated with an ad group. This data is used by AdGroupService

Note on bid amounts: All fields related to bid amounts are in micro-units of currency. Bid amounts 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.

Fields

campaignId int
ID of the campaign to which this ad group belongs. This field is immutable.
id long
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 long
If set, this maximum cost-per-click bid overrides keywordMaxCpc for content network clicks. See the note on bid amounts for more information on using this field.
keywordMaxCpc long
Default maximum cost-per-click bid for Keyword criteria. See the note on bid amounts for more information on using this field.

If this field is set, then siteMaxCpm must not be set.

maxCpa long
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.
name string
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 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.
siteMaxCpc long
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 must not be set.

siteMaxCpm long
Default maximum cost-per-mille (thousand impressions) bid for 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
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:

  • Enabled
  • Paused
  • Deleted