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.
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.
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. The range is 1.0 - 6.0 for PreferredContent. Use 0 to opt out of a Device type.
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}
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eRepresents a bid modifier for an ad group, allowing adjustments based on criteria like device type.\u003c/p\u003e\n"],["\u003cp\u003eBid 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.\u003c/p\u003e\n"],["\u003cp\u003eIncludes fields like \u003ccode\u003ebid_modifier\u003c/code\u003e, \u003ccode\u003edevice.type\u003c/code\u003e, and \u003ccode\u003eresource_name\u003c/code\u003e, providing information about the modifier and its associated ad group.\u003c/p\u003e\n"],["\u003cp\u003eFields from linked resources (ad group, campaign, customer) can be selected but won't segment metrics.\u003c/p\u003e\n"]]],["The content describes the ad group bid modifier, which adjusts bids based on specific criteria. Key actions include setting the `bid_modifier` (a numerical value between 0.1-10.0, or 0 for opting out of a device type). The `device.type` field specifies the device targeted (e.g., MOBILE, DESKTOP). The `resource_name` field identifies the specific ad group bid modifier. These fields are filterable, selectable and some are sortable.\n"],null,["# ad_group_bid_modifier\n\nRepresents an ad group bid modifier.\n\n| Attributed resources |\n|--------------------------------------------------------------------|\n| [ad_group](/search-ads/reporting/api/reference/fields/v0/ad_group) |\n| [campaign](/search-ads/reporting/api/reference/fields/v0/campaign) |\n| [customer](/search-ads/reporting/api/reference/fields/v0/customer) |\n\nFields from the above resources may be selected along with this\nresource in your SELECT and WHERE clauses. These fields **will not segment**\nmetrics in your `SELECT` clause.\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | 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. The range is 1.0 - 6.0 for PreferredContent. 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 | |\n| | 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 | |\n| | 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 | |"]]
