KeywordPlanAdGroupKeyword

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

  • Each keyword plan ad group keyword has specific fields including resource name, match type, ID, text, optional CPC bid, and a boolean indicating if it is negative.

  • The resource name uniquely identifies the keyword plan ad group keyword and follows a specific format including customer and keyword plan ad group keyword IDs.

  • The cpc_bid_micros field allows setting a specific bid for the keyword, which overrides bids set at the ad group level, and is not applicable to negative keywords.

  • The negative field is an immutable boolean indicating if the keyword is negative.

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

Fields

resource_name

string

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}

match_type

KeywordMatchType

The keyword match type.

keyword_plan_ad_group

string

The Keyword Plan ad group to which this keyword belongs.

id

int64

Output only. The ID of the Keyword Plan keyword.

text

string

The keyword text.

cpc_bid_micros

int64

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.

negative

bool

Immutable. If true, the keyword is negative.