Use this service to request traffic estimates for proposed or existing campaigns, ad groups, and keywords.
To simply retrieve estimates for a list of proposed keywords, create a
campaign estimate request and a child
ad group estimate request with null
IDs,
and then set the
keywordEstimateRequests
to contain the keywords.
You can refine the traffic estimates by setting campaign targeting options in the request. If an ad group ID is provided, all creatives from that ad group will be loaded and used to improve estimates.
The maximum number of keyword estimate requests across all campaign estimate requests and ad group estimate requests is 2500.
The maximum number of adgroup estimate requests across all campaign estimate requests is 50.
Note that the API returns intervals whereas the Traffic Estimator UI displays averages. Estimates are account specific since they are based on creatives already in the account. When comparing numbers, use the same account for the API and UI.
- Production WSDL
-
https://adwords.google.com/api/adwords/o/v201809/TrafficEstimatorService?wsdl
- Namespace
-
https://adwords.google.com/api/adwords/o/v201809
- Operations
- Errors
-
- AdxError
- AuthenticationError
- AuthorizationError
- ClientTermsError
- CollectionSizeError
- CurrencyCodeError
- DatabaseError
- DateError
- DistinctError
- EntityAccessDenied
- EntityNotFound
- IdError
- InternalApiError
- NotEmptyError
- NullError
- OperationAccessDenied
- OperatorError
- QuotaCheckError
- RangeError
- RateExceededError
- ReadOnlyError
- RegionCodeError
- RejectedError
- RequestError
- RequiredError
- SizeLimitError
- StringFormatError
- StringLengthError
- TrafficEstimatorError
get
Returns traffic estimates for specified criteria.
Parameters
Field | Type | Description |
---|---|---|
selector
|
|
Campaigns, ad groups and keywords for which traffic should be estimated. |
Response
Field | Type | Description |
---|---|---|
rval
|
|
Traffic estimation results. |
Errors
Error | Reasons |
---|---|
AdxError
|
Errors that are thrown when a non-AdX feature is accessed by an AdX customer.
Enumerations
|
AuthenticationError
|
Errors returned when Authentication failed.
Enumerations
|
AuthorizationError
|
Errors encountered when trying to authorize a user.
Enumerations
|
ClientTermsError
|
Error due to user not accepting the AdWords terms of service.
Enumerations
|
CollectionSizeError
|
Errors associated with the size of the given collection being
out of bounds.
Enumerations
|
CurrencyCodeError
|
Errors for currency codes.
Enumerations
|
DatabaseError
|
Errors that are thrown due to a database access problem.
Enumerations
|
DateError
|
Errors associated with invalid dates and date ranges.
Enumerations
|
DistinctError
|
Errors related to distinct ids or content.
Enumerations
|
EntityAccessDenied
|
Reports permission problems trying to access an entity.
Enumerations
|
EntityNotFound
|
An id did not correspond to an entity, or it referred to an entity which does not belong to the
customer.
Enumerations
|
IdError
|
Errors associated with the ids.
Enumerations
|
InternalApiError
|
Indicates that a server-side error has occured. InternalApiError s
are generally not the result of an invalid request or message sent by the
client.
Enumerations
|
NotEmptyError
|
Errors corresponding with violation of a NOT EMPTY check.
Enumerations
|
NullError
|
Errors associated with violation of a NOT NULL check.
Enumerations
|
OperationAccessDenied
|
Operation not permitted due to the invoked service's access policy.
Enumerations
|
OperatorError
|
Errors due to the use of unsupported operations.
Enumerations
|
QuotaCheckError
|
Encapsulates the errors thrown during developer quota checks.
Enumerations
|
RangeError
|
A list of all errors associated with the Range constraint.
Enumerations
|
RateExceededError
|
Signals that a call failed because a measured rate exceeded.
Enumerations
|
ReadOnlyError
|
Errors from attempting to write to read-only fields.
Enumerations
|
RegionCodeError
|
A list of all errors associated with the @RegionCode constraints.
Enumerations
|
RejectedError
|
Indicates that a field was rejected due to compatibility issues.
Enumerations
|
RequestError
|
Encapsulates the generic errors thrown when there's an error with user
request.
Enumerations
|
RequiredError
|
Errors due to missing required field.
Enumerations
|
SizeLimitError
|
Indicates that the number of entries in the request or response exceeds the system limit.
Enumerations
|
StringFormatError
|
A list of error code for reporting invalid content of input strings.
Enumerations
|
StringLengthError
|
Errors associated with the length of the given string being
out of bounds.
Enumerations
|
TrafficEstimatorError
|
Base error class for TrafficEstimatorService.
Enumerations
|