AdWords API
Feedback on this document

type BiddableAdGroupCriterion (v201306)

A biddable (positive) criterion in an adgroup.


Namespace
https://adwords.google.com/api/adwords/cm/v201306
Fields
Field Type Description
AdGroupCriterion (inherited)
adGroupId
Filterable
Required
Selectable
xsd:long The ad group this criterion 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.
criterionUse
Filterable
ReadOnly
Selectable
CriterionUse This field can be selected using the value "CriterionUse". This field can be filtered on. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
Enumerations
BIDDABLE
Biddable (positive) criterion
NEGATIVE
Negative criterion
criterion
Required
  1. Criterion
    1. AdSchedule
    2. AgeRange
    3. Carrier
    4. ContentLabel
    5. Gender
    6. Keyword
    7. Language
    8. Location
    9. MobileAppCategory
    10. MobileApplication
    11. MobileDevice
    12. OperatingSystemVersion
    13. Placement
    14. Platform
    15. Product
    16. Proximity
    17. CriterionUserInterest
    18. CriterionUserList
    19. Vertical
    20. Webpage
The criterion part of the ad group criterion. This field is required and should not be null.
forwardCompatibilityMap String_StringMapEntry[] This Map provides a place to put new features and settings in older versions of the AdWords API in the rare instance we need to introduce a new feature in an older version. It is presently unused. Do not set a value.
AdGroupCriterion.Type xsd:string Indicates that this instance is a subtype of AdGroupCriterion. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.
BiddableAdGroupCriterion
userStatus
Filterable
Selectable
UserStatus Current user set state of criterion.

During an ADD operation: It may not be set to DELETED. Defaults to UserStatus.Active if unspecified. This field can be selected using the value "Status". This field can be filtered on.


Enumerations
ACTIVE
Default state of a criterion (e.g. not paused).
DELETED
Criterion is deleted.
PAUSED
Criterion is paused. Also used to pause a criterion.
systemServingStatus
Filterable
ReadOnly
Selectable
SystemServingStatus Serving status. This field can be selected using the value "SystemServingStatus". This field can be filtered on. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
Enumerations
ELIGIBLE
Criterion is eligible to serve. Not rarely served and not inactive for search.
RARELY_SERVED
Rarely served. Criteria.isRarelyServed is true.
approvalStatus
Filterable
ReadOnly
Selectable
ApprovalStatus Approval status. This field can be selected using the value "ApprovalStatus". This field can be filtered on. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
Enumerations
APPROVED
Criterion with no reportable policy problems.
PENDING_REVIEW
Criterion that is yet to be reviewed.
UNDER_REVIEW
Criterion that is under review.
DISAPPROVED
Criterion disapproved due to policy violation.
disapprovalReasons
ReadOnly
Selectable
xsd:string[] List of disapproval reasons. This field can be selected using the value "DisapprovalReasons". This field is read only and should not be set. If this field is sent to the API, it will be ignored.
destinationUrl
Filterable
Selectable
xsd:string Destination URL override when Ad is triggered by this criterion.

Some sample valid URLs are: "http://www.website.com", "http://www.domain.com/somepath". This field can be selected using the value "DestinationUrl". This field can be filtered on.

experimentData BiddableAdGroupCriterionExp... The campaign bidding strategy specific experiment data for this criterion.
firstPageCpc
Filterable
ReadOnly
Selectable
Bid First page Cpc for this criterion. This field can be selected using the value "FirstPageCpc". This field can be filtered on. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
topOfPageCpc
Beta
Filterable
ReadOnly
Selectable
Bid An estimate of the cpc bid needed for your ad to appear above the first page of Google search results when a query matches the keywords exactly. Note that meeting this estimate is not a guarantee of ad position, which may depend on other factors. This field can be selected using the value "TopOfPageCpc". This field can be filtered on. This is a beta feature. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
qualityInfo
ReadOnly
QualityInfo Contains quality information about the criterion. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
stats
ReadOnly
  1. Stats
    1. AdExtensionOverrideStats
    2. AdStats
    3. CampaignAdExtensionStats
    4. CampaignStats
Contains statistics about the criterion. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
biddingStrategyConfiguration BiddingStrategyConfiguration Bidding configuration for this ad group criterion. To set the bids on the ad groups use BiddingStrategyConfiguration.bids. Multiple bids can be set on ad group criterion at the same time. Only the bids that apply to the campaign's bidding strategy bidding strategy will be used.
bidModifier
Beta
Filterable
Selectable
xsd:double Bid modifier of the criterion which is used when the criterion is not in an absolute bidding dimension. This field can be selected using the value "BidModifier". This field can be filtered on. This is a beta feature.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.