Share your feedback about the AdWords API! Take our annual survey.

type KeywordEstimateRequest (v201802)

Represents a keyword to be estimated.


Namespace
https://adwords.google.com/api/adwords/o/v201802

Field

EstimateRequest (inherited)

EstimateRequest.Type

xsd:string

Indicates that this instance is a subtype of EstimateRequest. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.

KeywordEstimateRequest

keyword

cm:Keyword

The Keyword to estimate. The keyword text is required regardless of whether the keyword ID is included. The keyword ID is optional and has the following characteristics:

  • When omitted, the ID indicates a new keyword to be estimated.
  • When present with a campaign and ad group also specified, the ID should be for an existing keyword in the ad group. This can improve the estimates since historical performance is known.
  • When present without a campaign and ad group specified, the ID is ignored.

This field is required and should not be null.

maxCpc

cm:Money

The max CPC bid for this keyword. In general, the maxCpc of a KeywordEstimateRequest is optional, since there is usually another maxCpc that can be used, such as the maxCpc on an existing keyword, an existing or overriding maxCpc of containing AdGroupEstimateRequest. However, if there is no backup value of maxCpc anywhere along the line, you must provide a value for maxCpc in KeywordEstimateRequest. This would happen, for example, if the KeywordEstimateRequest is for a new keyword.

isNegative

xsd:boolean

Whether the keyword is negative or not. The default value is false. If negative, no current ad group ads will appear for searches containing this keyword.

The estimate for negative keywords should reflect no traffic and zero CPC, but including a negative keyword will affect the other estimates in the request.

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.