keyword_plan_ad_group_keyword

  • Keyword Plan ad group keywords are limited to 10000 per plan.

  • Attributed resources like customer and keyword plan can be used in SELECT and WHERE clauses, but will not segment metrics.

  • The cpc_bid_micros field allows setting a keyword-level max CPC bid in micros, overriding the ad group level bid.

  • The id field provides the output-only ID of the Keyword Plan keyword.

  • Keyword match type is specified by the match_type field, and the negative field indicates if the keyword is negative.

A Keyword Plan ad group keyword. Max number of keyword plan keywords per plan: 10000.

Attributed resources
customer
keyword_plan
keyword_plan_ad_group
keyword_plan_campaign

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

keyword_plan_ad_group_keyword.cpc_bid_micros

Field description

A keyword level max cpc bid in micros (for example, $1 = 1mm). The currency is the same as the account currency code. This will override any CPC bid set at the keyword plan ad group level. Not applicable for negative keywords. (negative = true) This field is Optional.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group_keyword.id

Field description

Output only. The ID of the Keyword Plan keyword.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group_keyword.keyword_plan_ad_group

Field description

The Keyword Plan ad group to which this keyword belongs.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

keyword_plan_ad_group_keyword.match_type

Field description

The keyword match type.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.KeywordMatchTypeEnum.KeywordMatchType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group_keyword.negative

Field description

Immutable. If true, the keyword is negative.

CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group_keyword.resource_name

Field description

Immutable. The resource name of the Keyword Plan ad group keyword. KeywordPlanAdGroupKeyword resource names have the form: customers/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

keyword_plan_ad_group_keyword.text

Field description

The keyword text.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse