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 properties such as resource name, match type, the associated Keyword Plan ad group, ID, text, optional CPC bid in micros, and a flag indicating if it is negative.

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

  • The CPC bid in micros allows for setting a maximum CPC at the keyword level, overriding any bid set at the ad group level, and is not applicable to negative keywords.

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

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.