type AlternativeUnitTypeForecast (v202508)

  • AlternativeUnitTypeForecast provides a view of the forecast in terms of an alternative unit type, such as impressions or clicks.

  • It includes the number of matched, available, and possible units for the specified unit type.

  • Supported unit types include Impressions, Clicks, various CPA conversions, Viewable Impressions, In-target Impressions, and Completed Views.

  • The namespace for this service is https://www.google.com/apis/ads/publisher/v202508.
Service
ForecastService
Dependencies
AvailabilityForecast
▼
AlternativeUnitTypeForecast

A view of the forecast in terms of an alternative unit type.

For example, a forecast for an impressions goal may include this to express the matched, available, and possible viewable impressions.

Namespace
https://www.google.com/apis/ads/publisher/v202508

Field

unitType

UnitType

The alternative unit type being presented.

Enumerations
IMPRESSIONS
The number of impressions served by creatives associated with the line item. Line items of all LineItemType support this UnitType.
CLICKS
The number of clicks reported by creatives associated with the line item. The LineItem.lineItemType must be LineItemType.STANDARD, LineItemType.BULK or LineItemType.PRICE_PRIORITY.
CLICK_THROUGH_CPA_CONVERSIONS
The number of click-through Cost-Per-Action (CPA) conversions from creatives associated with the line item. This is only supported as secondary goal and the LineItem.costType must be CostType.CPA.
VIEW_THROUGH_CPA_CONVERSIONS
The number of view-through Cost-Per-Action (CPA) conversions from creatives associated with the line item. This is only supported as secondary goal and the LineItem.costType must be CostType.CPA.
TOTAL_CPA_CONVERSIONS
The number of total Cost-Per-Action (CPA) conversions from creatives associated with the line item. This is only supported as secondary goal and the LineItem.costType must be CostType.CPA.
VIEWABLE_IMPRESSIONS
The number of viewable impressions reported by creatives associated with the line item. The LineItem.lineItemType must be LineItemType.STANDARD.
IN_TARGET_IMPRESSIONS
The number of in-target impressions reported by third party measurements. The LineItem.lineItemType must be LineItemType.STANDARD.
COMPLETED_VIEWS
The number of completed views reported by creatives associated with the line item. A completed view is defined as having watched the entirety of the in-stream video ad and is only supported for standard reservation video line items. The LineItem.lineItemType must be LineItemType.STANDARD.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.

matchedUnits

xsd:long

The number of units, defined by unitType, that match the specified targeting and delivery settings.

availableUnits

xsd:long

The number of units, defined by unitType, that can be booked without affecting the delivery of any reserved line items. Exceeding this value will not cause an overbook, but lower-priority line items may not run.

possibleUnits

xsd:long

The maximum number of units, defined by unitType, that could be booked by taking inventory away from lower-priority line items.