ad_group

ad_group

Field descriptionThe ad group referenced in the query.
CategoryRESOURCE
Data Type MESSAGE
Type URLcom.google.ads.googleads.v1.resources.AdGroup
FilterableFalse
SelectableFalse
SortableFalse
RepeatedFalse
Selectable With
Attribute Resources
Metrics
Segments

ad_group.ad_rotation_mode

Field descriptionThe ad rotation mode of the ad group.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.base_ad_group

Field descriptionFor draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only.
CategoryATTRIBUTE
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.campaign

Field descriptionThe campaign to which the ad group belongs.
CategoryATTRIBUTE
Data Type RESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

ad_group.cpc_bid_micros

Field descriptionThe maximum CPC (cost-per-click) bid.
CategoryATTRIBUTE
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.cpm_bid_micros

Field descriptionThe maximum CPM (cost-per-thousand viewable impressions) bid.
CategoryATTRIBUTE
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.cpv_bid_micros

Field descriptionThe CPV (cost-per-view) bid.
CategoryATTRIBUTE
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.display_custom_bid_dimension

Field descriptionAllows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.TargetingDimensionEnum.TargetingDimension
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.effective_target_cpa_micros

Field descriptionThe effective target CPA (cost-per-acquisition). This field is read-only.
CategoryATTRIBUTE
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.effective_target_cpa_source

Field descriptionSource of the effective target CPA. This field is read-only.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.effective_target_roas

Field descriptionThe effective target ROAS (return-on-ad-spend). This field is read-only.
CategoryATTRIBUTE
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.effective_target_roas_source

Field descriptionSource of the effective target ROAS. This field is read-only.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.explorer_auto_optimizer_setting.opt_in

Field descriptionIndicates whether the optimizer is turned on.
CategoryATTRIBUTE
Data Type BOOLEAN
Type URLgoogle.protobuf.BoolValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.final_url_suffix

Field descriptionURL template for appending params to Final URL.
CategoryATTRIBUTE
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.id

Field descriptionThe ID of the ad group.
CategoryATTRIBUTE
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.name

Field descriptionThe name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
CategoryATTRIBUTE
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.percent_cpc_bid_micros

Field descriptionThe percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction].
CategoryATTRIBUTE
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.resource_name

Field descriptionThe resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}`
CategoryATTRIBUTE
Data Type RESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

ad_group.status

Field descriptionThe status of the ad group.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.AdGroupStatusEnum.AdGroupStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.target_cpa_micros

Field descriptionThe target CPA (cost-per-acquisition).
CategoryATTRIBUTE
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.target_cpm_micros

Field descriptionAverage amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
CategoryATTRIBUTE
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.target_roas

Field descriptionThe target ROAS (return-on-ad-spend) override. If the ad group's campaign bidding strategy is a standard Target ROAS strategy, then this field overrides the target ROAS specified in the campaign's bidding strategy. Otherwise, this value is ignored.
CategoryATTRIBUTE
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.targeting_setting.target_restrictions

Field descriptionThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
CategoryATTRIBUTE
Data Type MESSAGE
Type URLgoogle.ads.googleads.v1.common.TargetRestriction
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

ad_group.tracking_url_template

Field descriptionThe URL template for constructing a tracking URL.
CategoryATTRIBUTE
Data Type STRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.type

Field descriptionThe type of the ad group.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.AdGroupTypeEnum.AdGroupType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group.url_custom_parameters

Field descriptionThe list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
CategoryATTRIBUTE
Data Type MESSAGE
Type URLgoogle.ads.googleads.v1.common.CustomParameter
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

Send feedback about...

Google Ads API
Google Ads API
Need help? Visit our support page.