Data associated with one Keyword. This data is used by the
| Field name | Field type | Field description |
|---|
adGroupId |
long |
The ID of the ad group associated with this criterion.
This field is not mutable. |
criterionType |
CriterionType |
The concrete type of this criterion. Generally, this attribute is
read only, but may be set by scripting languages to indicate a concrete
type.
Values are:
|
destinationUrl |
string |
The destination URL associated with this criterion. Optional.
If absent, the destination URL associated with the Ad will be
used instead. |
exemptionRequest |
string |
Optional field that specifies a reason for allowing submission of
an ad or criterion that violates the ad policies described by
Google's AdWords Editorial Guidelines. Maximum length of the
exemptionRequest string is 300 characters.
If you want to submit an ad or criterion that violates an
ad policy, you can specify a string explaining
why you want an exemption to the policy in question.
Specifying an exemptionRequest prevents an operation that adds
a policy-violating criterion or ad from throwing an exception,
but does not guarantee that the ad will ultimately be approved.
For more information about Ad Violation policies, see the
Google
AdWords Editorial Guidelines. |
id |
long |
The numeric ID associated with this criterion.
This is set by CriterionService when the criterion is
created and it is not mutable. |
language |
string |
The language for this criterion.
This field is not mutable. |
maxCpc |
long |
The maximum cost-per-click you are willing to pay for this keyword.
If zero, the CPC bid associated with the ad group is used instead.
This value is interpreted as micro-units of the currency associated
with the account. |
minCpc |
long |
The minimum cost-per-click required for this keyword to be active
in live advertising, represented as micro-units of the currency associated
with the account.
This field is read only, and its value depends on a
variety of factors, such as how many advertisers are bidding
for this keyword and how effective the keyword is.
For more information about the factors that affect the minCpc of a
keyword, see
New Keyword States and Quality-Based Minimum Bids. |
negative |
boolean |
Whether the criterion is "negative".
A negative criterion means that the adgroup will not
be triggered by queries that match this criterion. |
paused |
boolean |
The pause status of the criterion |
proxyMaxCpc |
long |
When present, this read only field indicates that there is a proxy
bid that is active for this keyword. This will be the case, for instance,
when budget optimizer is turned on for the campaign that this keyword
is a part of. |
status |
CriterionStatus |
This criterion's status.
Values are:
- Active -- the criterion is active. This indicates
that the maxCpc is greater than the minCpc, and there is nothing about the
criterion that would prevent it from triggering the ad group.
- InActive -- Applies only to Keyword criterion, not
website. The keyword is inactive. The Keyword criterion is currently
not being used to trigger the ad group. A Keyword becomes inactive,
for example, when the maxCpc is less than the required minCpc.
- Disapproved -- the criterion has been disapproved, most likely
because it violates Google's editorial policy.
This status corresponds to "Disapproved" in the
Google AdWords web-based interface.
- Deleted -- the criterion has been deleted.
This status corresponds to "Deleted" in the
Google AdWords web-based interface.
For more information about the meaning of status values, see
New Keyword States and Quality-Based Minimum Bids. |
text |
string |
The text of this keyword.
This is not mutable after being set the first time.
The text can contain up to ten words, with a total maximum of 80 characters.
The text may contain letters and digits and the following special
characters:
space # $ & _ - " [ ] ' + . / : |
type |
KeywordType |
The type of keyword, indicating how it is targeted.
This is not mutable after being set the first time.
Values are:
|
API Reference
