Ads API .NET library
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Events Macros
Google.Api.Ads.AdManager.v202308.IForecastService Interface Reference

Provides methods for estimating traffic (clicks/impressions) for line items. Forecasts can be provided for LineItem objects that exist in the system or which have not had an ID set yet. More...

Inheritance diagram for Google.Api.Ads.AdManager.v202308.IForecastService:
Google.Api.Ads.AdManager.v202308.ForecastServiceInterface Google.Api.Ads.AdManager.v202308.ForecastService

Public Member Functions

Google.Api.Ads.AdManager.v202308.DeliveryForecast getDeliveryForecast (Google.Api.Ads.AdManager.v202308.ProspectiveLineItem[] lineItems, Google.Api.Ads.AdManager.v202308.DeliveryForecastOptions forecastOptions)
 
System.Threading.Tasks.Task
< Google.Api.Ads.AdManager.v202308.DeliveryForecast
getDeliveryForecastAsync (Google.Api.Ads.AdManager.v202308.ProspectiveLineItem[] lineItems, Google.Api.Ads.AdManager.v202308.DeliveryForecastOptions forecastOptions)
 
Google.Api.Ads.AdManager.v202308.DeliveryForecast getDeliveryForecastByIds (long[] lineItemIds, Google.Api.Ads.AdManager.v202308.DeliveryForecastOptions forecastOptions)
 
System.Threading.Tasks.Task
< Google.Api.Ads.AdManager.v202308.DeliveryForecast
getDeliveryForecastByIdsAsync (long[] lineItemIds, Google.Api.Ads.AdManager.v202308.DeliveryForecastOptions forecastOptions)
 
- Public Member Functions inherited from Google.Api.Ads.AdManager.v202308.ForecastServiceInterface
Google.Api.Ads.AdManager.v202308.AvailabilityForecast getAvailabilityForecast (Google.Api.Ads.AdManager.v202308.ProspectiveLineItem lineItem, Google.Api.Ads.AdManager.v202308.AvailabilityForecastOptions forecastOptions)
 
System.Threading.Tasks.Task
< Google.Api.Ads.AdManager.v202308.AvailabilityForecast
getAvailabilityForecastAsync (Google.Api.Ads.AdManager.v202308.ProspectiveLineItem lineItem, Google.Api.Ads.AdManager.v202308.AvailabilityForecastOptions forecastOptions)
 
Google.Api.Ads.AdManager.v202308.AvailabilityForecast getAvailabilityForecastById (long lineItemId, Google.Api.Ads.AdManager.v202308.AvailabilityForecastOptions forecastOptions)
 
System.Threading.Tasks.Task
< Google.Api.Ads.AdManager.v202308.AvailabilityForecast
getAvailabilityForecastByIdAsync (long lineItemId, Google.Api.Ads.AdManager.v202308.AvailabilityForecastOptions forecastOptions)
 
Wrappers.ForecastService.getDeliveryForecastResponse getDeliveryForecast (Wrappers.ForecastService.getDeliveryForecastRequest request)
 
System.Threading.Tasks.Task
< Wrappers.ForecastService.getDeliveryForecastResponse
getDeliveryForecastAsync (Wrappers.ForecastService.getDeliveryForecastRequest request)
 
Wrappers.ForecastService.getDeliveryForecastByIdsResponse getDeliveryForecastByIds (Wrappers.ForecastService.getDeliveryForecastByIdsRequest request)
 
System.Threading.Tasks.Task
< Wrappers.ForecastService.getDeliveryForecastByIdsResponse
getDeliveryForecastByIdsAsync (Wrappers.ForecastService.getDeliveryForecastByIdsRequest request)
 
Google.Api.Ads.AdManager.v202308.TrafficDataResponse getTrafficData (Google.Api.Ads.AdManager.v202308.TrafficDataRequest trafficDataRequest)
 
System.Threading.Tasks.Task
< Google.Api.Ads.AdManager.v202308.TrafficDataResponse
getTrafficDataAsync (Google.Api.Ads.AdManager.v202308.TrafficDataRequest trafficDataRequest)
 

Detailed Description

Provides methods for estimating traffic (clicks/impressions) for line items. Forecasts can be provided for LineItem objects that exist in the system or which have not had an ID set yet.

Test network behavior

Test networks are unable to provide forecasts that would be comparable to the production environment because forecasts require traffic history. For test networks, a consistent behavior can be expected for forecast requests, according to the following rules:

Inputs
(LineItem Fields)
Outputs
(Forecast Fields)
lineItemType unitsBought availableUnits forecastUnits (matchedUnits) deliveredUnits Exception
Sponsorship 13 #x2013;#x2013; #x2013;#x2013; #x2013;#x2013; NO_FORECAST_YET
Sponsorship 20 #x2013;#x2013; #x2013;#x2013; #x2013;#x2013; SERVER_NOT_AVAILABLE
Sponsorship 50 1,200,000 6,000,000 600,000 #x2013;#x2013;
Sponsorship != 20 and
!= 50
1,200,000 1,200,000 600,000 #x2013;#x2013;
Not Sponsorship <= 500,000 3 * unitsBought / 2 unitsBought * 6 600,000 #x2013;#x2013;
Not Sponsorship > 500,000 and <= 1,000,000 unitsBought / 2 unitsBought * 6 600,000 #x2013;#x2013;
Not Sponsorship > 1,000,000 and <= 1,500,000 unitsBought / 2 3 * unitsBought / 2 600,000 #x2013;#x2013;
Not Sponsorship > 1,500,000 unitsBought / 4 3 * unitsBought / 2 600,000 #x2013;#x2013;

Member Function Documentation

System.Threading.Tasks.Task<Google.Api.Ads.AdManager.v202308.DeliveryForecast> Google.Api.Ads.AdManager.v202308.IForecastService.getDeliveryForecastAsync ( Google.Api.Ads.AdManager.v202308.ProspectiveLineItem[]  lineItems,
Google.Api.Ads.AdManager.v202308.DeliveryForecastOptions  forecastOptions 
)
Google.Api.Ads.AdManager.v202308.DeliveryForecast Google.Api.Ads.AdManager.v202308.IForecastService.getDeliveryForecastByIds ( long[]  lineItemIds,
Google.Api.Ads.AdManager.v202308.DeliveryForecastOptions  forecastOptions 
)
System.Threading.Tasks.Task<Google.Api.Ads.AdManager.v202308.DeliveryForecast> Google.Api.Ads.AdManager.v202308.IForecastService.getDeliveryForecastByIdsAsync ( long[]  lineItemIds,
Google.Api.Ads.AdManager.v202308.DeliveryForecastOptions  forecastOptions 
)

The documentation for this interface was generated from the following file: