KeywordPlanAdGroupKeyword

  • Each Keyword Plan can have a maximum of 10,000 keywords.

  • The resource name for a Keyword Plan ad group keyword follows a specific format including customer and keyword ID.

  • Key attributes of a Keyword Plan ad group keyword include its match type, the associated ad group, an output-only ID, the keyword text, an optional CPC bid, and whether it is negative.

  • CPC bids in micros can be set at the keyword level, overriding bids at the ad group level, and are not applicable for negative keywords.

  • A keyword's negative status, once set to true, is immutable.

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.