type AlternativeUnitTypeForecast (v202411)
Stay organized with collections
Save and categorize content based on your preferences.
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/v202411
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.
-
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eAlternativeUnitTypeForecast\u003c/code\u003e provides an alternative view of a forecast, such as viewable impressions for an impressions goal.\u003c/p\u003e\n"],["\u003cp\u003eIt includes metrics like \u003ccode\u003ematchedUnits\u003c/code\u003e, \u003ccode\u003eavailableUnits\u003c/code\u003e, and \u003ccode\u003epossibleUnits\u003c/code\u003e for the alternative unit type.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eunitType\u003c/code\u003e field specifies the alternative unit being forecasted (e.g., impressions, clicks, viewable impressions).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ematchedUnits\u003c/code\u003e represent units matching targeting and delivery, while \u003ccode\u003eavailableUnits\u003c/code\u003e are bookable without affecting reserved line items.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003epossibleUnits\u003c/code\u003e indicate the maximum bookable units, potentially taking inventory from lower-priority line items.\u003c/p\u003e\n"]]],["The `AlternativeUnitTypeForecast` provides a forecast based on an alternative unit type, such as viewable impressions within an impressions goal. Key fields include `unitType` (e.g., impressions, clicks, CPA conversions, viewable impressions), `matchedUnits` (units matching targeting), `availableUnits` (bookable units without impacting existing reservations), and `possibleUnits` (maximum bookable units, potentially impacting lower-priority items). The `unitType` options depends on `LineItemType` and `costType`. This forecast is a component of `ForecastService` and its dependency `AvailabilityForecast`.\n"],null,[]]