Represents an ad group.
- Namespace
-
https://adwords.google.com/api/adwords/cm/v201809
Field |
|
---|---|
|
ID of this ad group. This field can be selected using the value "Id".
This field can be filtered on.
This field is read only and will be ignored when sent to the API for the following Operators: ADD.
This field is required and should not be
null when it is contained within Operators : SET. |
|
ID of the campaign with which this ad group is associated. This field can be selected using the value "CampaignId".
This field can be filtered on.
This field is required and should not be
null when it is contained within Operators : ADD. |
|
Name of the campaign with which this ad group is associated. This field can be selected using the value "CampaignName".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.
|
|
Name of this ad group. At most 256 characters (Unicode code points).
This field is required and should not be This field can be selected using the value "Name".
This field can be filtered on.
AdGroup names must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. This is checked by the regular expression '[^\x00\x0A\x0D]*'.
|
|
Status of this ad group. Enumerations
This field can be selected using the value "Status".
This field can be filtered on.
|
|
List of settings for the AdGroup. This field can be selected using the value "Settings".
|
|
Labels that are attached to the AdGroup. To associate an existing Label to an existing AdGroup, use AdGroupService.mutateLabel with ADD operator. To remove an associated Label from the AdGroup, use AdGroupService.mutateLabel with REMOVE operator. To filter on Labels, use one of Predicate.Operator.CONTAINS_ALL, Predicate.Operator.CONTAINS_ANY, Predicate.Operator.CONTAINS_NONE operators with a list of Label ids. This field can be selected using the value "Labels".
This field can be filtered on.
This field is read only and will be ignored when sent to the API for the following Operators: REMOVE and SET.
|
|
This Map provides a place to put new features and settings in older versions of the AdWords API in the rare instance we need to introduce a new feature in an older version. It is presently unused. Do not set a value. |
|
Bidding configuration for this ad group. To set the bids on the ad groups use BiddingStrategyConfiguration.bids. Multiple bids can be set on ad group at the same time. Only the bids that apply to the effective bidding strategy will be used. Effective bidding strategy is considered to be the directly attached strategy or inherited campaign level strategy when there’s no directly attached strategy. |
|
Allows advertisers to specify a criteria dimension on which to place absolute bids. This is only applicable for campaigns that target only the content network and not search. Enumerations
This field can be selected using the value "ContentBidCriterionTypeGroup".
This field can be filtered on.
|
|
ID of the base campaign from which this draft/trial adgroup was created. This field is only returned on get requests. This field can be selected using the value "BaseCampaignId".
This field is read only and will be ignored when sent to the API.
|
|
ID of the base adgroup from which this draft/trial adgroup was created. For base adgroups this is equal to the adgroup ID. If the adgroup was created in the draft or trial and has no corresponding base adgroup, this field is null. This field is readonly and will be ignored when sent to the API. This field can be selected using the value "BaseAdGroupId".
|
|
URL template for constructing a tracking URL. On update, empty string ("") indicates to clear the field. This field can be selected
using the value "TrackingUrlTemplate".
This field can be filtered on.
This field may not be set for
campaign channel type MULTI_CHANNEL.
|
|
URL template for appending params to Final URL. On update, empty string ("") indicates to clear the field. This field can be selected
using the value "FinalUrlSuffix".
This field can be filtered on.
This field may not be set for
campaign channel type MULTI_CHANNEL.
|
|
A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls. This field can be selected using the value "UrlCustomParameters".
This field may not be set for campaign channel type MULTI_CHANNEL.
|
|
Enumerations
This field can be selected using the value "AdGroupType".
This field can be filtered on.
This field may only be set to SHOPPING_GOAL_OPTIMIZED_ADS for campaign channel type SHOPPING with campaign channel subtype SHOPPING_GOAL_OPTIMIZED_ADS.
This field is read only and will be ignored when sent to the API for the following Operators: SET.
|
|
The ad rotation mode to specify how often the ads in the ad group will be served relative to one another. |