The AdWords API will sunset on April 27, 2022. Migrate to the Google Ads API to take advantage of the latest Google Ads features.

type AdGroupBidModifier (v201809)

Service
AdGroupBidModifierService
Dependencies
AdGroupBidModifierOperation AdGroupBidModifierPage AdGroupBidModifierReturnValue
▼
AdGroupBidModifier

Represents an adgroup level bid modifier override for campaign level criterion bid modifier values.

Namespace
https://adwords.google.com/api/adwords/cm/v201809

Field

campaignId

xsd:long

The campaign that the criterion is in.

This field can be selected using the value "CampaignId".
This field can be filtered on.

adGroupId

xsd:long

The adgroup that the bid modifier override is in.

This field can be selected using the value "AdGroupId".
This field can be filtered on.
This field is required and should not be null.

criterion

  1. Criterion
    1. Platform
    2. PreferredContent

The criterion whose bid value is being overridden.

Currently, bid modifier overrides are supported only for platform criterion (ID=30000, 30001, 30002) and preferred content criterion (ID = 400). The AdGroupBidModifierService.get method returns all platform and preferred content criteria.

This field is required and should not be null.

bidModifier

xsd:double

The modifier for bids when the criterion matches.

Valid modifier values range from 0.1 to 10.0, with 0.0 reserved for opting out of a platform.

This field can be selected using the value "BidModifier".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : ADD, SET.

baseAdGroupId

xsd:long

ID of the base adgroup from which this draft/trial adgroup bid modifier was created. For base adgroups this is equal to the adgroup ID. If the adgroup was created in the draft or trial and has no corresponding base adgroup, this field is null. This field is readonly and only returned on get requests.

This field can be selected using the value "BaseAdGroupId".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.

bidModifierSource

BidModifierSource

Bid modifier source.

Enumerations
UNKNOWN
CAMPAIGN
The bid modifier is specified at the campaign level, on the campaign level criterion.
AD_GROUP
The bid modifier is specified (overridden) at the ad group level.

This field can be selected using the value "BidModifierSource".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.