Hide

type BiddableAdGroupCriterion (v201506)

A biddable (positive) criterion in an adgroup.


Namespace
https://adwords.google.com/api/adwords/cm/v201506
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 will be ignored when sent to the API.
Enumerations
BIDDABLE
Biddable (positive) criterion
NEGATIVE
Negative criterion
criterion
Required
  1. Criterion
    1. AgeRange
    2. AppPaymentModel
    3. Gender
    4. Keyword
    5. MobileAppCategory
    6. MobileApplication
    7. Placement
    8. ProductPartition
    9. CriterionUserInterest
    10. CriterionUserList
    11. Vertical
    12. Webpage
    13. YouTubeChannel
    14. YouTubeVideo
The criterion part of the ad group criterion. This field is required and should not be null.
labels
Filterable
ReadOnly
Selectable
  1. Label[]
    1. TextLabel
Labels that are attached to the AdGroupCriterion. To associate an existing Label to an existing AdGroupCriterion, use AdGroupCriterionService.mutateLabel with ADD operator. To remove an associated Label from the AdGroupCriterion, use AdGroupCriterionService.mutateLabel with REMOVE operator. To filter on Labels, use one of Predicate.Operator.CONTAINS_ALL, Predicate.Operator.CONTAINS_ANY, Predicate.Operator.CONTAINS_NONE operators with a list of Label ids. This field can be selected using the value "Labels". This field can be filtered on. This field is read only and will be ignored when sent to the API for the following Operators: REMOVE and SET.
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. UserStatus may not be set to REMOVED. On add, defaults to ENABLED if unspecified. This field can be selected using the value "Status". This field can be filtered on.
Enumerations
ENABLED
Default state of a criterion (e.g. not paused).
REMOVED
Criterion is removed.
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 will be ignored when sent to the API.
Enumerations
ELIGIBLE
Criterion is eligible to serve.
RARELY_SERVED
Indicates low search volume.

For more information, visit Low Search Volume.

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 will be ignored when sent to the API.
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 will be ignored when sent to the API.
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".

Set to the empty string ("") to clear the destination URL. 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 will be ignored when sent to the API.
topOfPageCpc
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 field is read only and will be ignored when sent to the API.
qualityInfo
ReadOnly
QualityInfo Contains quality information about the criterion. This field is read only and will be ignored when sent to the API.
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
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.
finalUrls
Filterable
Selectable
UrlList A list of possible final URLs after all cross domain redirects. This field can be selected using the value "FinalUrls". This field can be filtered on.
finalMobileUrls
Filterable
Selectable
UrlList A list of possible final mobile URLs after all cross domain redirects. This field can be selected using the value "FinalMobileUrls". This field can be filtered on.
finalAppUrls
Filterable
Selectable
AppUrlList A list of final app URLs that will be used on mobile if the user has the specific app installed. This field can be selected using the value "FinalAppUrls". This field can be filtered on.
trackingUrlTemplate
Filterable
Selectable
xsd:string URL template for constructing a tracking URL.

On update, empty string ("") indicates to clear the field. This field can be selected using the value "TrackingUrlTemplate". This field can be filtered on.

urlCustomParameters
Filterable
Selectable
CustomParameters A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls. This field can be selected using the value "UrlCustomParameters". This field can be filtered on.

Send feedback about...

AdWords API