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. |