AdsApp.​AdGroupDevices

AI-generated Key Takeaways

outlined_flag

• AdGroupDevices allows for device-dependent ad group configurations, specifically managing bid modifiers for different devices.

• Device bid modifiers are multipliers applied to ad group bids that adjust bids up or down for specific device types.

• Ad group bid modifiers override campaign-level bid modifiers unless the campaign modifier is -1, which opts the entire campaign out of that device type.

• If an ad group bid modifier is not set, it inherits the bid modifier from its campaign, defaulting to 1 if not set at the campaign level either.

• Bid modifiers must be between 0.1 and 4.0, or -1 to opt out, and setting a modifier will fail if the campaign is already opted out for that device.

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()

Returns nothing.

clearMobileBidModifier()

Returns nothing.

clearTabletBidModifier()

Returns nothing.

getDesktopBidModifier()

Return values:

getMobileBidModifier()

Return values:

getTabletBidModifier()

Return values:

setDesktopBidModifier(modifier)

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)

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)

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: