AdGroup

An ad group.

Fields
resource_name	string Immutable. The resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id}
status	AdGroupStatus The status of the ad group.
type	AdGroupType Immutable. The type of the ad group.
ad_rotation_mode	AdGroupAdRotationMode The ad rotation mode of the ad group.
url_custom_parameters[]	CustomParameter The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
optimized_targeting_enabled	bool True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion.
display_custom_bid_dimension	TargetingDimension Allows 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.
targeting_setting	TargetingSetting Setting for targeting related features.
audience_setting	AudienceSetting Immutable. Setting for audience related features.
effective_target_cpa_source	BiddingSource Output only. Source of the effective target CPA. This field is read-only.
effective_target_roas_source	BiddingSource Output only. Source of the effective target ROAS. This field is read-only.
labels[]	string Output only. The resource names of labels attached to this ad group.
excluded_parent_asset_field_types[]	AssetFieldType The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels.
excluded_parent_asset_set_types[]	AssetSetType The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported.
primary_status	AdGroupPrimaryStatus Output only. Provides aggregated view into why an ad group is not serving or not serving optimally.
primary_status_reasons[]	AdGroupPrimaryStatusReason Output only. Provides reasons for why an ad group is not serving or not serving optimally.
id	int64 Output only. The ID of the ad group.
name	string The 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.
base_ad_group	string Output only. For 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.
tracking_url_template	string The URL template for constructing a tracking URL.
campaign	string Immutable. The campaign to which the ad group belongs.
cpc_bid_micros	int64 The maximum CPC (cost-per-click) bid.
effective_cpc_bid_micros	int64 Output only. Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null.
cpm_bid_micros	int64 The maximum CPM (cost-per-thousand viewable impressions) bid.
target_cpa_micros	int64 The target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored.
cpv_bid_micros	int64 The CPV (cost-per-view) bid.
target_cpm_micros	int64 Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
target_roas	double The target ROAS (return-on-ad-spend) override. If the ad group's campaign bidding strategy is TargetRoas or MaximizeConversionValue (with its target_roas field set), then this field overrides the target ROAS specified in the campaign's bidding strategy. Otherwise, this value is ignored.
percent_cpc_bid_micros	int64 The 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].
final_url_suffix	string URL template for appending params to Final URL.
effective_target_cpa_micros	int64 Output only. The effective target CPA (cost-per-acquisition). This field is read-only.
effective_target_roas	double Output only. The effective target ROAS (return-on-ad-spend). This field is read-only.