|
|
Getting Started Guide: ForecastService Overview
The ForecastService provides operations that enable you to perform forecasts for ad groups, keywords, sets of keywords, a batch of individual keywords or historical data for keywords for a given date range.
About Forecasts
Use the ForecastService to help determine what kind of results, such as impressions, clicks, cost, and other performance metrics, that you might expect from your ads. You can use this service to forecast for either the web Sponsored Search or the Mobile Sponsored Search application. This information can be used to help create more effective campaigns or to help set appropriate budgets.
Note:The forecast returns results on a daily basis. Note that the forecast results are estimates only and are not guaranteed.
Perform Forecasts
ForecastService provides operations that enable you to perform forecasts for ad groups, keywords, or a set of keywords.
Ad Groups
To generate a forecast for an ad group, specify the ad group ID and supply the forecast request data - account, market, geographic target, and bids for Sponsored Search or Content Match®. The forecast request data defines the scenario you are interested in forecasting. The response returns the forecasted performance metrics for an ad group and an ad group bid landscape, taking into account the average quality index for that ad group.
Keywords
To generate a forecast for a keyword, specify the keyword and supply the forecast request data. If you optionally specify ad group ID, the forecast is performed as if the keyword were in that ad group. Your forecast may vary depending on the quality index of the ads in the specified ad group. The response returns the forecasted performance metrics for the keyword and keyword bid landscape.
Sets of Keywords
To generate a forecast for a set of keywords, supply the default forecast request data as well as the customized keyword forecast data. If you optionally specify an ad group ID, the forecast is performed within the context of that ad group. The response returns forecasted performance metrics for the keywords and keywords bid landscape.
Batch of Individual Keywords
To generate a batch forecast for individual keywords in a set, supply the forecast request data, and the set of keywords to include in the batch. The response returns forecasted performance metrics for each of the keywords in that batch.
Historical Data for Keywords
To retrieve historical data for a given set of keywords, provide the account ID, market ID, match types, start and end date. The response returns historical performance metrics for the specified keywords in the given date range and other requested attributes.
Targeting Dimensions
To generate forecasting information using targeting dimensions, provide the targeting attributes and/or the targeting profile in your request data object. If you specify both (targeting profile and targeting attributes), we will combine the list and provide a forecast. For example, if you specify some geo targets, you will get a forecast data based on clicks and impressions coming from those geo targets.
Note that bid premiums(except in the case of Network Targets) and preference targets will not affect forecast response. Preference targets (Age, Gender) will not change the forecast data as it is just a hint to be used for matching and advertisers will participate in all available auctions.