ad_group_criterion

Field description

The ad group to which the criterion belongs.

Category

ATTRIBUTE

Data Type

RESOURCE_NAME

Type URL

N/A

Filterable

True

Selectable

True

Sortable

False

Repeated

False

Field description

Type of the age range.

Category

ATTRIBUTE

Data Type

ENUM

AGE_RANGE_18_24

AGE_RANGE_25_34

AGE_RANGE_35_44

AGE_RANGE_45_54

AGE_RANGE_55_64

AGE_RANGE_65_UP

AGE_RANGE_UNDETERMINED

UNKNOWN

UNSPECIFIED

Type URL

google.ads.searchads360.v0.enums.AgeRangeTypeEnum.AgeRangeType

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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.

Category

ATTRIBUTE

Data Type

DOUBLE

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The CPC (cost-per-click) bid.

Category

ATTRIBUTE

Data Type

INT64

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

Category

ATTRIBUTE

Data Type

DATE

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The ID of the criterion.

Category

ATTRIBUTE

Data Type

INT64

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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

Category

ATTRIBUTE

Data Type

INT64

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The resource names of effective labels attached to this ad group criterion. An effective label is a label inherited or directly assigned to this ad group criterion.

Category

ATTRIBUTE

Data Type

RESOURCE_NAME

Type URL

N/A

Filterable

True

Selectable

True

Sortable

False

Repeated

True

Field description

ID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group_criterion.criterion_id" instead.

Category

ATTRIBUTE

Data Type

STRING

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The Engine Status for ad group criterion.

Category

ATTRIBUTE

Data Type

ENUM

AD_GROUP_CRITERION_ACCOUNT_PAUSED

AD_GROUP_CRITERION_APPROVED

AD_GROUP_CRITERION_DISAPPROVED

AD_GROUP_CRITERION_ELIGIBLE

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN

AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH

AD_GROUP_CRITERION_INVALID_PC_SEARCH

AD_GROUP_CRITERION_INVALID_SEARCH

AD_GROUP_CRITERION_LOW_SEARCH_VOLUME

AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW

AD_GROUP_CRITERION_NOT_REVIEWED

AD_GROUP_CRITERION_ON_HOLD

AD_GROUP_CRITERION_PARTIALLY_INVALID

AD_GROUP_CRITERION_PAUSED

AD_GROUP_CRITERION_PENDING_REVIEW

AD_GROUP_CRITERION_REMOVED

AD_GROUP_CRITERION_SERVING

AD_GROUP_CRITERION_TO_BE_ACTIVATED

AD_GROUP_CRITERION_UNDER_REVIEW

UNKNOWN

UNSPECIFIED

Type URL

google.ads.searchads360.v0.enums.AdGroupCriterionEngineStatusEnum.AdGroupCriterionEngineStatus

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

URL template for appending params to final URL.

Category

ATTRIBUTE

Data Type

STRING

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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

Category

ATTRIBUTE

Data Type

STRING

Type URL

N/A

Filterable

True

Selectable

True

Sortable

False

Repeated

True

Field description

Type of the gender.

Category

ATTRIBUTE

Data Type

ENUM

FEMALE

MALE

UNDETERMINED

UNKNOWN

UNSPECIFIED

Type URL

google.ads.searchads360.v0.enums.GenderTypeEnum.GenderType

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The match type of the keyword.

Category

ATTRIBUTE

Data Type

ENUM

BROAD

EXACT

PHRASE

UNKNOWN

UNSPECIFIED

Type URL

google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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

Category

ATTRIBUTE

Data Type

STRING

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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

Category

ATTRIBUTE

Data Type

RESOURCE_NAME

Type URL

N/A

Filterable

True

Selectable

True

Sortable

False

Repeated

True

Field description

The datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

Category

ATTRIBUTE

Data Type

DATE

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

Type of the listing group.

Category

ATTRIBUTE

Data Type

ENUM

SUBDIVISION

UNIT

UNKNOWN

UNSPECIFIED

Type URL

google.ads.searchads360.v0.enums.ListingGroupTypeEnum.ListingGroupType

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The geo target constant resource name.

Category

ATTRIBUTE

Data Type

RESOURCE_NAME

Type URL

N/A

Filterable

True

Selectable

True

Sortable

False

Repeated

False

Field description

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.

Category

ATTRIBUTE

Data Type

BOOLEAN

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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

Category

ATTRIBUTE

Data Type

INT64

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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

Category

ATTRIBUTE

Data Type

INT32

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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}

Category

ATTRIBUTE

Data Type

RESOURCE_NAME

Type URL

N/A

Filterable

True

Selectable

True

Sortable

False

Repeated

False

Field description

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.

Category

ATTRIBUTE

Data Type

ENUM

ENABLED

PAUSED

REMOVED

UNKNOWN

UNSPECIFIED

Type URL

google.ads.searchads360.v0.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The URL template for constructing a tracking URL.

Category

ATTRIBUTE

Data Type

STRING

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The type of the criterion.

Category

ATTRIBUTE

Data Type

ENUM

AD_SCHEDULE

AGE_RANGE

APP_PAYMENT_MODEL

AUDIENCE

BRAND

BRAND_LIST

CARRIER

COMBINED_AUDIENCE

CONTENT_LABEL

CUSTOM_AFFINITY

CUSTOM_AUDIENCE

CUSTOM_INTENT

DEVICE

GENDER

INCOME_RANGE

IP_BLOCK

KEYWORD

KEYWORD_THEME

LANGUAGE

LIFE_EVENT

LISTING_GROUP

LISTING_SCOPE

LOCAL_SERVICE_ID

LOCATION

LOCATION_GROUP

MOBILE_APPLICATION

MOBILE_APP_CATEGORY

MOBILE_DEVICE

OPERATING_SYSTEM_VERSION

PARENTAL_STATUS

PLACEMENT

PROXIMITY

TOPIC

UNKNOWN

UNSPECIFIED

USER_INTEREST

USER_LIST

WEBPAGE

YOUTUBE_CHANNEL

YOUTUBE_VIDEO

Type URL

google.ads.searchads360.v0.enums.CriterionTypeEnum.CriterionType

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

The User List resource name.

Category

ATTRIBUTE

Data Type

RESOURCE_NAME

Type URL

N/A

Filterable

True

Selectable

True

Sortable

False

Repeated

False

Field description

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.

Category

ATTRIBUTE

Data Type

MESSAGE

Type URL

google.ads.searchads360.v0.common.WebpageConditionInfo

Filterable

False

Selectable

True

Sortable

False

Repeated

True

Field description

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.

Category

ATTRIBUTE

Data Type

DOUBLE

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False

Field description

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.

Category

ATTRIBUTE

Data Type

STRING

Type URL

N/A

Filterable

True

Selectable

True

Sortable

True

Repeated

False