ad_group

An ad group.

Attributed resources
bidding_strategy
campaign
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

Segmenting resources
ad_group_bid_modifier

Fields from the above resources, when selected along with this resource in your SELECT and WHERE clauses, will segment metrics.

Fields/Segments/Metrics

This page shows all metrics and segments that can be put in the same SELECT clause as the fields of ad_group. However, when you specify ad_group in the FROM clause, some metrics and segments cannot be used. Use the following filter to show only the fields that can be used when ad_group is specified in the FROM clause.

Is ad_group specified in the FROM clause of your query?

Resource fields
ad_rotation_mode
cpc_bid_micros
creation_time
end_date
engine_id
engine_status
id
labels
language_code
last_modified_time
name
resource_name
start_date
status
targeting_setting.target_restrictions
type

Segments
conversion_action
conversion_action_category
conversion_action_name
date
device
month
quarter
week
year

Metrics
absolute_top_impression_percentage
all_conversions
all_conversions_value
average_cpc
average_cpm
clicks
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
content_budget_lost_impression_share
content_impression_share
content_rank_lost_impression_share
conversions
conversions_value
cost_micros
cross_device_conversions
cross_device_conversions_value
ctr
historical_quality_score
impressions
search_absolute_top_impression_share
search_budget_lost_absolute_top_impression_share
search_budget_lost_impression_share
search_budget_lost_top_impression_share
search_impression_share
search_rank_lost_absolute_top_impression_share
search_rank_lost_impression_share
search_rank_lost_top_impression_share
search_top_impression_share
top_impression_percentage
visits

ad_group.ad_rotation_mode
Field description	The ad rotation mode of the ad group.
Category	`ATTRIBUTE`
Data Type	`ENUM OPTIMIZE ROTATE_FOREVER UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.cpc_bid_micros
Field description	The maximum CPC (cost-per-click) bid.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.creation_time
Field description	Output only. The timestamp when this ad_group was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.end_date
Field description	Output only. Date when the ad group ends serving ads. By default, the ad group ends on the ad group's end date. If this field is set, then the ad group ends at the end of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.engine_id
Field description	Output only. ID of the ad group in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group.id" instead.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.engine_status
Field description	Output only. The Engine Status for ad group.
Category	`ATTRIBUTE`
Data Type	`ENUM ACCOUNT_PAUSED AD_GROUP_DRAFT AD_GROUP_ELIGIBLE AD_GROUP_EXPIRED AD_GROUP_PAUSED AD_GROUP_REMOVED AD_GROUP_SERVING AD_GROUP_SUBMITTED CAMPAIGN_PAUSED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AdGroupEngineStatusEnum.AdGroupEngineStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.id
Field description	Output only. The ID of the ad group.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.labels
Field description	Output only. The resource names of labels attached to this ad group.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

ad_group.language_code
Field description	Output only. The language of the ads and keywords in an ad group. This field is only available for Microsoft Advertising accounts. More details: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.last_modified_time
Field description	Output only. The datetime when this ad group was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.name
Field description	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.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.resource_name
Field description	Immutable. The resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

ad_group.start_date
Field description	Output only. Date when this ad group starts serving ads. By default, the ad group starts now or the ad group's start date, whichever is later. If this field is set, then the ad group starts at the beginning of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.status
Field description	The status of the ad group.
Category	`ATTRIBUTE`
Data Type	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AdGroupStatusEnum.AdGroupStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group.targeting_setting.target_restrictions
Field description	The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.searchads360.v0.common.TargetRestriction`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group.type
Field description	Immutable. The type of the ad group.
Category	`ATTRIBUTE`
Data Type	`ENUM DISPLAY_STANDARD HOTEL_ADS PROMOTED_HOTEL_ADS SEARCH_DYNAMIC_ADS SEARCH_STANDARD SHOPPING_COMPARISON_LISTING_ADS SHOPPING_PRODUCT_ADS SHOPPING_SHOWCASE_ADS SHOPPING_SMART_ADS SMART_CAMPAIGN_ADS TRAVEL_ADS UNKNOWN UNSPECIFIED VIDEO_BUMPER VIDEO_EFFICIENT_REACH VIDEO_NON_SKIPPABLE_IN_STREAM VIDEO_OUTSTREAM VIDEO_RESPONSIVE VIDEO_TRUE_VIEW_IN_DISPLAY VIDEO_TRUE_VIEW_IN_STREAM`
Type URL	`google.ads.searchads360.v0.enums.AdGroupTypeEnum.AdGroupType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.conversion_action
Field description	Resource name of the conversion action.
Category	`SEGMENT`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.conversion_action_category
Field description	Conversion action category.
Category	`SEGMENT`
Data Type	`ENUM ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.conversion_action_name
Field description	Conversion action name.
Category	`SEGMENT`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.date
Field description	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.device
Field description	Device to which metrics apply.
Category	`SEGMENT`
Data Type	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.month
Field description	Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.quarter
Field description	Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.week
Field description	Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.year
Field description	Year, formatted as yyyy.
Category	`SEGMENT`
Data Type	`INT32`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.absolute_top_impression_percentage
Field description	The percent of your ad impressions that are shown as the very first ad above the organic search results.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.all_conversions
Field description	The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.all_conversions_value
Field description	The value of all conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.average_cpc
Field description	The total cost of all clicks divided by the total number of clicks received.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.average_cpm
Field description	Average cost-per-thousand impressions (CPM).
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.clicks
Field description	The number of clicks.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.client_account_conversions
Field description	The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.client_account_conversions_value
Field description	The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.client_account_view_through_conversions
Field description	The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.content_budget_lost_impression_share
Field description	The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.content_impression_share
Field description	The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.content_rank_lost_impression_share
Field description	The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.conversions
Field description	The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.conversions_value
Field description	The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cost_micros
Field description	The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cross_device_conversions
Field description	Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cross_device_conversions_value
Field description	The sum of the value of cross-device conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.ctr
Field description	The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.historical_quality_score
Field description	The historical quality score.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.impressions
Field description	Count of how often your ad has appeared on a search results page or website on the Google Network.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_absolute_top_impression_share
Field description	The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_budget_lost_absolute_top_impression_share
Field description	The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_budget_lost_impression_share
Field description	The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_budget_lost_top_impression_share
Field description	The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_impression_share
Field description	The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_rank_lost_absolute_top_impression_share
Field description	The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_rank_lost_impression_share
Field description	The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_rank_lost_top_impression_share
Field description	The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.search_top_impression_share
Field description	The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.top_impression_percentage
Field description	The percent of your ad impressions that are shown anywhere above the organic search results.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.visits
Field description	Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group

Fields/Segments/Metrics

ad_group.ad_rotation_mode

ad_group.cpc_bid_micros

ad_group.creation_time

ad_group.end_date

ad_group.engine_id

ad_group.engine_status

ad_group.id

ad_group.labels

ad_group.language_code

ad_group.last_modified_time

ad_group.name

ad_group.resource_name

ad_group.start_date

ad_group.status

ad_group.targeting_setting.target_restrictions

ad_group.type

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.device

segments.month

segments.quarter

segments.week

segments.year

metrics.absolute_top_impression_percentage

metrics.all_conversions

metrics.all_conversions_value

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.content_budget_lost_impression_share

metrics.content_impression_share

metrics.content_rank_lost_impression_share

metrics.conversions

metrics.conversions_value

metrics.cost_micros

metrics.cross_device_conversions

metrics.cross_device_conversions_value

metrics.ctr

metrics.historical_quality_score

metrics.impressions

metrics.search_absolute_top_impression_share

metrics.search_budget_lost_absolute_top_impression_share

metrics.search_budget_lost_impression_share

metrics.search_budget_lost_top_impression_share

metrics.search_impression_share

metrics.search_rank_lost_absolute_top_impression_share

metrics.search_rank_lost_impression_share

metrics.search_rank_lost_top_impression_share

metrics.search_top_impression_share

metrics.top_impression_percentage

metrics.visits