keyword_plan_ad_group_keyword

  • Keyword Plan ad group keywords represent keywords within a Keyword Plan ad group, with a limit of 10,000 keywords per plan.

  • You can select fields from attributed resources such as customer, keyword_plan, keyword_plan_ad_group, and keyword_plan_campaign along with this resource in SELECT and WHERE clauses.

  • Key fields include cpc_bid_micros for setting bids, id for the keyword ID, match_type for the keyword match type, negative to indicate if the keyword is negative, resource_name for the unique identifier, and text for the keyword itself.

  • The cpc_bid_micros field allows for setting a keyword-level max CPC bid in the account's currency, overriding ad group level bids, and is not applicable for negative keywords.

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 descriptionA 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 descriptionOutput 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 descriptionThe 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 descriptionThe keyword match type.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.KeywordMatchTypeEnum.KeywordMatchType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group_keyword.negative

Field descriptionImmutable. If true, the keyword is negative.
CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group_keyword.resource_name

Field descriptionImmutable. 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 descriptionThe keyword text.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse