keyword_plan_ad_group

  • Keyword Plan ad groups have a maximum limit of 200 per plan.

  • Fields from resources like customer, keyword_plan, and keyword_plan_campaign can be selected with this resource but will not segment metrics.

  • The cpc_bid_micros field sets a default max CPC bid for keywords within the ad group and inherits from the parent campaign if not set.

  • The id field is an output-only identifier for the keyword plan ad group.

  • The name field is a required and non-empty string used to identify the keyword plan ad group.

  • The resource_name field provides the immutable resource identifier for the Keyword Planner ad group.

A Keyword Planner ad group. Max number of keyword plan ad groups per plan: 200.

Attributed resources
customer
keyword_plan
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.cpc_bid_micros

Field descriptionA default ad group max cpc bid in micros in account currency for all biddable keywords under the keyword plan ad group. If not set, will inherit from parent campaign.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group.id

Field descriptionOutput only. The ID of the keyword plan ad group.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group.keyword_plan_campaign

Field descriptionThe keyword plan campaign to which this ad group belongs.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

keyword_plan_ad_group.name

Field descriptionThe name of the keyword plan ad group. This field is required and should not be empty when creating keyword plan ad group.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

keyword_plan_ad_group.resource_name

Field descriptionImmutable. The resource name of the Keyword Planner ad group. KeywordPlanAdGroup resource names have the form: customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse