ad_group_criterion

Immutable. The ad group to which the criterion belongs.

Type of the age range.

Type of the app payment model.

Output only. Approval status of the criterion.

The Audience resource name.

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.

Shared set resource name of the brand list.

The CombinedAudience resource name.

The CPC (cost-per-click) bid.

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

The CPV (cost-per-view) bid.

Output only. The ID of the criterion. This field is ignored for mutates.

The CustomInterest resource name.

The CustomAudience resource name.

The CustomInterest resource name.

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.

Output only. The display name of the criterion. This field is ignored for mutates.

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

Output only. Source of the effective CPC bid.

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

Output only. Source of the effective CPM bid.

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

Output only. Source of the effective CPV bid.

Output only. The effective Percent CPC bid amount.

Output only. Source of the effective Percent CPC bid.

Taxonomy id of the extended demographic group.

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

URL template for appending params to final URL.

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

Type of the gender.

Type of the income range.

The match type of the keyword.

The text of the keyword (at most 80 characters and 10 words).

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

The language constant resource name.

Taxonomy id of the life event.

String value of the activity city. The Geo Target Constant resource name.

String value of the activity country. The Geo Target Constant resource name.

String value of the activity ID.

Long value of the activity rating.

String value of the activity state. The Geo Target Constant resource name.

The Geo Target Constant resource name.

Long value of the hotel class.

The Geo Target Constant resource name.

String value of the hotel ID.

The Geo Target Constant resource name.

String value of the product brand.

ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436

Level of the product category.

Value of the locality.

Value of the availability.

Value of the condition.

Indicates the index of the custom attribute.

String value of the product custom attribute.

Value of the id.

Level of the type.

Value of the type.

Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group.

The path of dimensions defining this listing group.

Type of the listing group.

The geo target constant resource name.

The mobile app category constant resource name.

A string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations.

Name of this mobile application.

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.

Type of the parental status.

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].

URL of the placement. For example, "http://www.domain.com".

Output only. Estimate of how many clicks per week you might get by changing your keyword bid to the value in first_position_cpc_micros.

Output only. Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros.

Output only. The estimate of the CPC bid required for ad to be shown on first page of search results.

Output only. The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results.

Output only. The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.

Output only. The primary status for the ad group criterion.

Output only. The primary status reasons for the ad group criterion.

Output only. The performance of the ad compared to other advertisers.

Output only. The quality score of the landing page.

Output only. The quality score. This field may not be populated if Google does not have enough information to determine a value.

Output only. The click-through rate compared to that of other advertisers.

Immutable. The resource name of the ad group criterion. Ad group criterion resource names have the form: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

The resource name of the shared set that contains the retail filter. This field is required.

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.

Output only. Serving status of the criterion.

The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category.

The Topic Constant resource name.

The URL template for constructing a tracking URL.

Output only. The type of the criterion.

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

The UserInterest resource name.

The User List resource name.

The shared set resource name of the vertical ads item group rule list.

ID for a Video lineup. Contact your Google business development representative for details.

Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.

Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.

The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.

Webpage sample urls

The YouTube uploader channel id or the channel code of a YouTube channel.

YouTube video id as it appears on the YouTube watch page.