My favorites | English | Sign in

More personalization in Google Friend Connect New!

Documentation for the requested version is not available.Documentation for the requested diff is not available.

AdGroupRequest

Link to this version

Represents an ad group whose keywords are to be estimated.

To get traffic estimates for keywords in one or more ad groups, create an AdGroupRequest object for each ad group whose keywords are to be estimated. See TrafficEstimatorService for details of how to submit the request for estimation.

The results of the estimation are returned as AdGroupEstimate objects which each contain KeywordEstimate objects.

Fields

id long
The id of the ad group to be estimated. All keywords in the ad group will be estimated. Optional - if omitted indicates a new ad group.
keywordRequests KeywordRequest[]
The keywords to be estimated. This list must contain at least one KeywordRequest.

If this is a new ad group, all KeywordRequest instances must represent new keywords (that is, the id of each KeywordRequest must be unspecified.)

If this is an existing ad group, the KeywordRequests can be for new keywords or for keywords that already exist in the ad group.

maxCpc long
The bid for this ad group in micros. See Monetary Units for information about micros.

The maxCpc for the AdGroupRequest is required unless an existing ad group id has been specified.

The rules determining which value of maxCpc the TrafficEstimatorService uses in the estimation calculation are (in order of preference):

  • maxCpc on the KeywordRequest is used, if any
  • maxCpc on the existing keyword is used, if any
  • maxCpc on the AdGroupRequest is used, if any
  • maxCpc on the existing AdGroup is used as the last resort