AdsApp.​AdGroupDevices

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:

MemberTypeDescription
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:

TypeDescription
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:

TypeDescription
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:

TypeDescription
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:

NameTypeDescription
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:

NameTypeDescription
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:

NameTypeDescription
modifier double The new tablet bid modifier.