Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

AdGroupCriterion

Stay organized with collections Save and categorize content based on your preferences.

An ad group criterion.

JSON representation
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field criterion.
}
Fields
resourceName

string

Immutable. The resource name of the ad group criterion. Ad group criterion resource names have the form:

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}

displayName

string

Output only. The display name of the criterion.

This field is ignored for mutates.

status

enum (AdGroupCriterionStatus)

The status of the criterion.

This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added.

qualityInfo

object (QualityInfo)

Output only. Information regarding the quality of the criterion.

type

enum (CriterionType)

Output only. The type of the criterion.

systemServingStatus

enum (CriterionSystemServingStatus)

Output only. Serving status of the criterion.

approvalStatus

enum (AdGroupCriterionApprovalStatus)

Output only. Approval status of the criterion.

disapprovalReasons[]

string

Output only. List of disapproval reasons of the criterion.

The different reasons for disapproving a criterion can be found here: https://support.google.com/adspolicy/answer/6008942

This field is read-only.

labels[]

string

Output only. The resource names of labels attached to this ad group criterion.

effectiveCpcBidSource

enum (BiddingSource)

Output only. Source of the effective CPC bid.

effectiveCpmBidSource

enum (BiddingSource)

Output only. Source of the effective CPM bid.

effectiveCpvBidSource

enum (BiddingSource)

Output only. Source of the effective CPV bid.

effectivePercentCpcBidSource

enum (BiddingSource)

Output only. Source of the effective Percent CPC bid.

positionEstimates

object (PositionEstimates)

Output only. Estimates for criterion bids at various positions.

finalUrls[]

string

The list of possible final URLs after all cross-domain redirects for the ad.

finalMobileUrls[]

string

The list of possible final mobile URLs after all cross-domain redirects.

urlCustomParameters[]

object (CustomParameter)

The list of mappings used to substitute custom parameter tags in a trackingUrlTemplate, finalUrls, or mobile_final_urls.

criterionId

string (int64 format)

Output only. The ID of the criterion.

This field is ignored for mutates.

adGroup

string

Immutable. The ad group to which the criterion belongs.

negative

boolean

Immutable. Whether to target (false) or exclude (true) the criterion.

This field is immutable. To switch a criterion from positive to negative, remove then re-add it.

bidModifier

number

The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.

cpcBidMicros

string (int64 format)

The CPC (cost-per-click) bid.

cpmBidMicros

string (int64 format)

The CPM (cost-per-thousand viewable impressions) bid.

cpvBidMicros

string (int64 format)

The CPV (cost-per-view) bid.

percentCpcBidMicros

string (int64 format)

The CPC bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction].

effectiveCpcBidMicros

string (int64 format)

Output only. The effective CPC (cost-per-click) bid.

effectiveCpmBidMicros

string (int64 format)

Output only. The effective CPM (cost-per-thousand viewable impressions) bid.

effectiveCpvBidMicros

string (int64 format)

Output only. The effective CPV (cost-per-view) bid.

effectivePercentCpcBidMicros

string (int64 format)

Output only. The effective Percent CPC bid amount.

finalUrlSuffix

string

URL template for appending params to final URL.

trackingUrlTemplate

string

The URL template for constructing a tracking URL.

Union field criterion. The ad group criterion.

Exactly one must be set. criterion can be only one of the following:

keyword

object (KeywordInfo)

Immutable. Keyword.

placement

object (PlacementInfo)

Immutable. Placement.

mobileAppCategory

object (MobileAppCategoryInfo)

Immutable. Mobile app category.

mobileApplication

object (MobileApplicationInfo)

Immutable. Mobile application.

listingGroup

object (ListingGroupInfo)

Immutable. Listing group.

ageRange

object (AgeRangeInfo)

Immutable. Age range.

gender

object (GenderInfo)

Immutable. Gender.

incomeRange

object (IncomeRangeInfo)

Immutable. Income range.

parentalStatus

object (ParentalStatusInfo)

Immutable. Parental status.

userList

object (UserListInfo)

Immutable. User List.

youtubeVideo

object (YouTubeVideoInfo)

Immutable. YouTube Video.

youtubeChannel

object (YouTubeChannelInfo)

Immutable. YouTube Channel.

topic

object (TopicInfo)

Immutable. Topic.

userInterest

object (UserInterestInfo)

Immutable. User Interest.

webpage

object (WebpageInfo)

Immutable. Webpage

appPaymentModel

object (AppPaymentModelInfo)

Immutable. App Payment Model.

customAffinity

object (CustomAffinityInfo)

Immutable. Custom Affinity.

customIntent

object (CustomIntentInfo)

Immutable. Custom Intent.

customAudience

object (CustomAudienceInfo)

Immutable. Custom Audience.

combinedAudience

object (CombinedAudienceInfo)

Immutable. Combined Audience.

audience

object (AudienceInfo)

Immutable. Audience.

AdGroupCriterionStatus

The possible statuses of an AdGroupCriterion.