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:
| Member | Type | Description |
|---|---|---|
| clearDesktopBidModifier | void | Clears the desktop bid modifier for this ad group. |
| clearMobileBidModifier | void | Clears the mobile bid modifier for this ad group. |
| clearTabletBidModifier | void | Clears the tablet bid modifier for this ad group. |
| getDesktopBidModifier | double | Returns the desktop bid modifier for this ad group. |
| getMobileBidModifier | double | Returns the mobile bid modifier for this ad group. |
| getTabletBidModifier | double | Returns the tablet bid modifier for this ad group. |
| setDesktopBidModifier | void | Sets the desktop bid modifier for this ad group to the specified value. |
| setMobileBidModifier | void | Sets the mobile bid modifier for this ad group to the specified value. |
| setTabletBidModifier | void | Sets the tablet bid modifier for this ad group to the specified value. |
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:
| Type | Description |
|---|---|
double | The desktop bid modifier. |
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:
| Type | Description |
|---|---|
double | The mobile bid modifier. |
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:
| Type | Description |
|---|---|
double | The tablet bid modifier. |
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:
| Name | Type | Description |
|---|---|---|
| modifier | double | The new desktop bid modifier. |
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:
| Name | Type | Description |
|---|---|---|
| modifier | double | The new mobile bid modifier. |
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:
| Name | Type | Description |
|---|---|---|
| modifier | double | The new tablet bid modifier. |