AdsApp.AdGroupDevices
Stay organized with collections
Save and categorize content based on your preferences.
Starting point for device-dependent ad group configurations. Typical usage:
var
mobileBidModifier
=
adGroup
.
devices
()
.
getMobileBidModifier
();
Device bid modifiers are multipliers applied to the ad group's bids. For
instance, a mobile bid modifier of 1.1
increases a bid to 110%
of its original value on mobile devices, and changes a bid of $5.00 to $5.50.
The Google Ads UI would render this setting as +10%.
If you set a device bid modifier at both campaign- and ad group-level in a
single campaign, the ad group bid modifier will be used when determining your
bid unless
the campaign bid modifier is set to -1
, a
special value which will opt the entire campaign out of the device type
regardless of any ad group bid modifiers that may have been set.
If an ad group does not have a bid modifier for a device, its effective
bid modifier is inherited from its campaign, which in turn defaults to 1
if the bid modifier is not set.
For more information about bid modifiers, please see the Google Ads Help Center
article
.
Methods:
clearDesktopBidModifier()
Clears the desktop bid modifier for this ad group. The ad group will use
its campaign's bid modifier if one is set. Returns nothing.
clearMobileBidModifier()
Clears the mobile bid modifier for this ad group. The ad group will use its
campaign's bid modifier if one is set. Returns nothing.
clearTabletBidModifier()
Clears the tablet bid modifier for this ad group. The ad group will use its
campaign's bid modifier if one is set. Returns nothing.
getDesktopBidModifier()
Returns the desktop bid modifier for this ad group. If the ad group's bid
modifier is not set, this returns the campaign's bid modifier. Return values:
getMobileBidModifier()
Returns the mobile bid modifier for this ad group. If the ad group's bid
modifier is not set, this returns the campaign's bid modifier. Return values:
getTabletBidModifier()
Returns the tablet bid modifier for this ad group. If the ad group's bid
modifier is not set, this returns the campaign's bid modifier. Return values:
setDesktopBidModifier(modifier)
Sets the desktop bid modifier for this ad group to the specified value. Bid
modifiers must be between 0.1
and 4.0
, or -1
to opt the ad group out of desktop ads. The operation will fail if the ad group's campaign has a desktop bid
modifier of -1
, a special value that opts the entire campaign
out of desktop ads.
Returns nothing.
Arguments:
setMobileBidModifier(modifier)
Sets the mobile bid modifier for this ad group to the specified value. Bid
modifiers must be between 0.1
and 4.0
, or -1
to opt the ad group out of mobile ads. The operation will fail if the ad group's campaign has a mobile bid
modifier of -1
, a special value that opts the entire campaign
out of mobile ads.
Returns nothing.
Arguments:
setTabletBidModifier(modifier)
Sets the tablet bid modifier for this ad group to the specified value. Bid
modifiers must be between 0.1
and 4.0
, or -1
to opt the ad group out of tablet ads. The operation will fail if the ad group's campaign has a tablet bid
modifier of -1
, a special value that opts the entire campaign
out of tablet ads.
Returns nothing.
Arguments:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eDevice bid modifiers adjust ad group bids, increasing or decreasing them by a specified percentage for desktop, mobile, and tablet devices.\u003c/p\u003e\n"],["\u003cp\u003eAd group bid modifiers override campaign-level modifiers unless the campaign modifier is set to \u003ccode\u003e-1\u003c/code\u003e, opting out of the device type.\u003c/p\u003e\n"],["\u003cp\u003eIf an ad group lacks a specific device bid modifier, it inherits the setting from its campaign, defaulting to \u003ccode\u003e1\u003c/code\u003e if not set at the campaign level.\u003c/p\u003e\n"],["\u003cp\u003eBid modifiers can be set and cleared using methods like \u003ccode\u003esetMobileBidModifier\u003c/code\u003e and \u003ccode\u003eclearTabletBidModifier\u003c/code\u003e to control bids for specific device types.\u003c/p\u003e\n"],["\u003cp\u003eBid modifier values must fall between 0.1 and 4.0, or -1 to opt-out of the device type for the ad group, and are subject to campaign-level opt-outs.\u003c/p\u003e\n"]]],[],null,["# AdsApp.AdGroupDevices\n\nStarting point for device-dependent ad group configurations.\n\nTypical usage:\n\n```gdscript\nvar mobileBidModifier = adGroup.devices().getMobileBidModifier();\n```\n\nDevice bid modifiers are multipliers applied to the ad group's bids. For\ninstance, a mobile bid modifier of `1.1` increases a bid to 110%\nof its original value on mobile devices, and changes a bid of $5.00 to $5.50.\nThe Google Ads UI would render this setting as +10%.\n\nIf you set a device bid modifier at both campaign- and ad group-level in a\nsingle campaign, the ad group bid modifier will be used when determining your\nbid **unless** the campaign bid modifier is set to `-1`, a\nspecial value which will opt the entire campaign out of the device type\nregardless of any ad group bid modifiers that may have been set.\n\nIf an ad group does not have a bid modifier for a device, its effective\nbid modifier is inherited from its campaign, which in turn defaults to\n`1` if the bid modifier is not set.\n\nFor more information about bid modifiers, please see the [Google Ads Help Center\narticle](//support.google.com/google-ads/answer/6167121).\n\n### Methods:\n\n| Member | Type | Description |\n|--------------------------------------------------------------------|----------|-------------------------------------------------------------------------|\n| [clearDesktopBidModifier()](#clearDesktopBidModifier) | `void` | Clears the desktop bid modifier for this ad group. |\n| [clearMobileBidModifier()](#clearMobileBidModifier) | `void` | Clears the mobile bid modifier for this ad group. |\n| [clearTabletBidModifier()](#clearTabletBidModifier) | `void` | Clears the tablet bid modifier for this ad group. |\n| [getDesktopBidModifier()](#getDesktopBidModifier) | `double` | Returns the desktop bid modifier for this ad group. |\n| [getMobileBidModifier()](#getMobileBidModifier) | `double` | Returns the mobile bid modifier for this ad group. |\n| [getTabletBidModifier()](#getTabletBidModifier) | `double` | Returns the tablet bid modifier for this ad group. |\n| [setDesktopBidModifier(modifier)](#setDesktopBidModifier_modifier) | `void` | Sets the desktop bid modifier for this ad group to the specified value. |\n| [setMobileBidModifier(modifier)](#setMobileBidModifier_modifier) | `void` | Sets the mobile bid modifier for this ad group to the specified value. |\n| [setTabletBidModifier(modifier)](#setTabletBidModifier_modifier) | `void` | Sets the tablet bid modifier for this ad group to the specified value. |\n\n`clearDesktopBidModifier()`\n---------------------------\n\nClears the desktop bid modifier for this ad group. The ad group will use its campaign's bid modifier if one is set.\n\nReturns nothing.\n\n`clearMobileBidModifier()`\n--------------------------\n\nClears the mobile bid modifier for this ad group. The ad group will use its campaign's bid modifier if one is set.\n\nReturns nothing.\n\n`clearTabletBidModifier()`\n--------------------------\n\nClears the tablet bid modifier for this ad group. The ad group will use its campaign's bid modifier if one is set.\n\nReturns nothing.\n\n`getDesktopBidModifier()`\n-------------------------\n\nReturns the desktop bid modifier for this ad group. If the ad group's bid modifier is not set, this returns the campaign's bid modifier.\n\n### Return values:\n\n| Type | Description |\n|----------|---------------------------|\n| `double` | The desktop bid modifier. |\n\n`getMobileBidModifier()`\n------------------------\n\nReturns the mobile bid modifier for this ad group. If the ad group's bid modifier is not set, this returns the campaign's bid modifier.\n\n### Return values:\n\n| Type | Description |\n|----------|--------------------------|\n| `double` | The mobile bid modifier. |\n\n`getTabletBidModifier()`\n------------------------\n\nReturns the tablet bid modifier for this ad group. If the ad group's bid modifier is not set, this returns the campaign's bid modifier.\n\n### Return values:\n\n| Type | Description |\n|----------|--------------------------|\n| `double` | The tablet bid modifier. |\n\n`setDesktopBidModifier(modifier)`\n---------------------------------\n\nSets the desktop bid modifier for this ad group to the specified value. Bid modifiers must be between `0.1` and `4.0`, or `-1` to opt the ad group out of desktop ads.\n\nThe operation will fail if the ad group's campaign has a desktop bid\nmodifier of `-1`, a special value that opts the entire campaign\nout of desktop ads.\n\nReturns nothing.\n\n### Arguments:\n\n| Name | Type | Description |\n|----------|----------|-------------------------------|\n| modifier | `double` | The new desktop bid modifier. |\n\n`setMobileBidModifier(modifier)`\n--------------------------------\n\nSets the mobile bid modifier for this ad group to the specified value. Bid modifiers must be between `0.1` and `4.0`, or `-1` to opt the ad group out of mobile ads.\n\nThe operation will fail if the ad group's campaign has a mobile bid\nmodifier of `-1`, a special value that opts the entire campaign\nout of mobile ads.\n\nReturns nothing.\n\n### Arguments:\n\n| Name | Type | Description |\n|----------|----------|------------------------------|\n| modifier | `double` | The new mobile bid modifier. |\n\n`setTabletBidModifier(modifier)`\n--------------------------------\n\nSets the tablet bid modifier for this ad group to the specified value. Bid modifiers must be between `0.1` and `4.0`, or `-1` to opt the ad group out of tablet ads.\n\nThe operation will fail if the ad group's campaign has a tablet bid\nmodifier of `-1`, a special value that opts the entire campaign\nout of tablet ads.\n\nReturns nothing.\n\n### Arguments:\n\n| Name | Type | Description |\n|----------|----------|------------------------------|\n| modifier | `double` | The new tablet bid modifier. |"]]
