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.v202305.ForecastService:

Public Member Functions
	ForecastService ()
	Creates a new instance of the ForecastService class. More...

	ForecastService (string endpointConfigurationName)
	Creates a new instance of the ForecastService class. More...

	ForecastService (string endpointConfigurationName, string remoteAddress)
	Creates a new instance of the ForecastService class. More...

	ForecastService (string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress)
	Creates a new instance of the ForecastService class. More...

	ForecastService (System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress)
	Creates a new instance of the ForecastService class. More...

virtual Google.Api.Ads.AdManager.v202305.AvailabilityForecast	getAvailabilityForecast (Google.Api.Ads.AdManager.v202305.ProspectiveLineItem lineItem, Google.Api.Ads.AdManager.v202305.AvailabilityForecastOptions forecastOptions)
	Gets the availability forecast for a ProspectiveLineItem. An availability forecast reports the maximum number of available units that the line item can book, and the total number of units matching the line item's targeting. More...

virtual System.Threading.Tasks.Task < Google.Api.Ads.AdManager.v202305.AvailabilityForecast >	getAvailabilityForecastAsync (Google.Api.Ads.AdManager.v202305.ProspectiveLineItem lineItem, Google.Api.Ads.AdManager.v202305.AvailabilityForecastOptions forecastOptions)

virtual Google.Api.Ads.AdManager.v202305.AvailabilityForecast	getAvailabilityForecastById (long lineItemId, Google.Api.Ads.AdManager.v202305.AvailabilityForecastOptions forecastOptions)
	Gets an AvailabilityForecast for an existing LineItem object. An availability forecast reports the maximum number of available units that the line item can be booked with, and also the total number of units matching the line item's targeting. More...

virtual System.Threading.Tasks.Task < Google.Api.Ads.AdManager.v202305.AvailabilityForecast >	getAvailabilityForecastByIdAsync (long lineItemId, Google.Api.Ads.AdManager.v202305.AvailabilityForecastOptions forecastOptions)

virtual Google.Api.Ads.AdManager.v202305.DeliveryForecast	getDeliveryForecast (Google.Api.Ads.AdManager.v202305.ProspectiveLineItem[] lineItems, Google.Api.Ads.AdManager.v202305.DeliveryForecastOptions forecastOptions)
	Gets the delivery forecast for a list of ProspectiveLineItem objects in a single delivery simulation with line items potentially contending with each other. A delivery forecast reports the number of units that will be delivered to each line item given the line item goals and contentions from other line items. More...

virtual System.Threading.Tasks.Task < Google.Api.Ads.AdManager.v202305.DeliveryForecast >	getDeliveryForecastAsync (Google.Api.Ads.AdManager.v202305.ProspectiveLineItem[] lineItems, Google.Api.Ads.AdManager.v202305.DeliveryForecastOptions forecastOptions)

virtual Google.Api.Ads.AdManager.v202305.DeliveryForecast	getDeliveryForecastByIds (long[] lineItemIds, Google.Api.Ads.AdManager.v202305.DeliveryForecastOptions forecastOptions)
	Gets the delivery forecast for a list of existing LineItem objects in a single delivery simulation. A delivery forecast reports the number of units that will be delivered to each line item given the line item goals and contentions from other line items. More...

virtual System.Threading.Tasks.Task < Google.Api.Ads.AdManager.v202305.DeliveryForecast >	getDeliveryForecastByIdsAsync (long[] lineItemIds, Google.Api.Ads.AdManager.v202305.DeliveryForecastOptions forecastOptions)

virtual Google.Api.Ads.AdManager.v202305.TrafficDataResponse	getTrafficData (Google.Api.Ads.AdManager.v202305.TrafficDataRequest trafficDataRequest)
	Returns forecasted and historical traffic data for the segment of traffic specified by the provided request. More...

virtual System.Threading.Tasks.Task < Google.Api.Ads.AdManager.v202305.TrafficDataResponse >	getTrafficDataAsync (Google.Api.Ads.AdManager.v202305.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;