type AdGroup (v201609)

id

xsd:long

ID of this ad group.

campaignId

xsd:long

ID of the campaign with which this ad group is associated.

campaignName

xsd:string

Name of the campaign with which this ad group is associated.

name

xsd:string

Name of this ad group (at most 255 UTF-8 full-width characters). This field is required and should not be null for ADD operations from v201309 version.

status

AdGroup.Status

Status of this ad group.

UNKNOWN

ENABLED

Active.

PAUSED

Paused.

REMOVED

Removed.

settings

1. Setting[]
   1. ExplorerAutoOptimizerSetting
   2. TargetingSetting

List of settings for the AdGroup.

labels

1. Label[]
   1. TextLabel

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.

forwardCompatibilityMap

String_StringMapEntry[]

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.

biddingStrategyConfiguration

BiddingStrategyConfiguration

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.

contentBidCriterionTypeGroup

CriterionTypeGroup

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.

KEYWORD

Criteria for targeting keywords. e.g. 'mars cruise' KEYWORD may be used as a content bid dimension. Keywords are always a targeting dimension, so may not be set as a target "ALL" dimension with TargetRestriction.

USER_INTEREST_AND_LIST

Criteria for targeting lists of users. Lists may represent users with particular interests, or they may represent users who have interacted with an advertiser's site in particular ways.

VERTICAL

Criteria for targeting similar categories of placements, e.g. 'category::Animals>Pets' Used only for content network targeting.

GENDER

Criteria for targeting gender.

AGE_RANGE

Criteria for targeting age ranges.

PLACEMENT

Criteria for targeting placements. aka Website. e.g. 'www.flowers4sale.com' This group also includes mobile applications and mobile app categories.

PARENT

Criteria for parental status targeting.

NONE

Special criteria type group used to reset the existing value.

UNKNOWN

baseCampaignId

xsd:long

ID of the base campaign from which this draft/trial adgroup was created. This field is only returned on get requests.

baseAdGroupId

xsd:long

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 only returned on get requests.

trackingUrlTemplate

xsd:string

URL template for constructing a tracking URL.

On update, empty string ("") indicates to clear the field.

urlCustomParameters

CustomParameters

A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls.