The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.

ad_group_bid_modifier

Page Summary

Represents a bid modifier for an ad group, allowing adjustments based on criteria like device type.
Bid modifiers range from 0.1 to 10.0 (or 1.0 to 6.0 for PreferredContent), with 0 used to opt out of a device type.
Includes fields like bid_modifier, device.type, and resource_name, providing information about the modifier and its associated ad group.
Fields from linked resources (ad group, campaign, customer) can be selected but won't segment metrics.

Represents an ad group bid modifier.

Attributed resources
ad_group
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.

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_bid_modifier. However, when you specify ad_group_bid_modifier 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_bid_modifier is specified in the FROM clause.

Is ad_group_bid_modifier specified in the FROM clause of your query?

Resource fields
bid_modifier
device.type
resource_name

Segments
date
keyword.ad_group_criterion
keyword.info.match_type
keyword.info.text

Metrics
clicks
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
conversions_from_interactions_value_per_interaction
ctr
impressions

ad_group_bid_modifier.bid_modifier
Field description	The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Use 0 to opt out of a Device type.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_bid_modifier.device.type
Field description	Type of the device.
Category	`ATTRIBUTE`
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	False
Repeated	False

ad_group_bid_modifier.resource_name
Field description	The resource name of the ad group bid modifier. Ad group bid modifier resource names have the form: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
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.keyword.ad_group_criterion
Field description	The AdGroupCriterion resource name.
Category	`SEGMENT`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

segments.keyword.info.match_type
Field description	The match type of the keyword.
Category	`SEGMENT`
Data Type	`ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.keyword.info.text
Field description	The text of the keyword (at most 80 characters and 10 words).
Category	`SEGMENT`
Data Type	`STRING`
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.conversions_from_interactions_value_per_interaction
Field description	The value of conversions from interactions divided by the number of ad interactions. 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.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.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

ad_group_bid_modifier Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Fields/Segments/Metrics

ad_group_bid_modifier.bid_modifier

ad_group_bid_modifier.device.type

ad_group_bid_modifier.resource_name

segments.date

segments.keyword.ad_group_criterion

segments.keyword.info.match_type

segments.keyword.info.text

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions_from_interactions_value_per_interaction

metrics.ctr

metrics.impressions

ad_group_bid_modifier