enum UnitType (v202411)
Stay organized with collections
Save and categorize content based on your preferences.
Indicates the type of unit used for defining a reservation. The
CostType can differ from the UnitType - an
ad can have an impression goal, but be billed by its click. Usually
CostType and UnitType will refer to the
same unit.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202411
Enumeration |
Description |
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.
|
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\u003eUnitType\u003c/code\u003e in Google Ad Manager defines the unit used for reservation, like impressions or clicks, often aligning with billing but can differ.\u003c/p\u003e\n"],["\u003cp\u003eIt supports various unit types, including impressions, clicks, CPA conversions, and viewable impressions, each with specific requirements and usage.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCostType\u003c/code\u003e can differ from \u003ccode\u003eUnitType\u003c/code\u003e as an ad may have an impression goal but be billed by clicks; however, they usually refer to the same unit.\u003c/p\u003e\n"],["\u003cp\u003eSome unit types have restrictions based on the \u003ccode\u003eLineItemType\u003c/code\u003e and \u003ccode\u003eCostType\u003c/code\u003e associated with the line item.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eUnitType\u003c/code\u003e helps in forecasting and understanding how reservations are defined and measured within Google Ad Manager.\u003c/p\u003e\n"]]],["The `ForecastService` utilizes `UnitType` to define reservation units, which may differ from the `CostType`. Available `UnitTypes` include `IMPRESSIONS`, `CLICKS`, `CLICK_THROUGH_CPA_CONVERSIONS`, `VIEW_THROUGH_CPA_CONVERSIONS`, `TOTAL_CPA_CONVERSIONS`, `VIEWABLE_IMPRESSIONS`, `IN_TARGET_IMPRESSIONS`, and `UNKNOWN`. Specific `LineItemTypes` and `CostTypes` are required for some `UnitTypes`; for example, `CPA` cost type is required for any `CPA_CONVERSIONS` unit types. `LineItemService` and `ProposalLineItemService` are linked to this service.\n"],null,["# enum UnitType (v202411)\n\n**Service** \n**ForecastService** [LineItemService](/ad-manager/api/reference/v202411/LineItemService.UnitType) [ProposalLineItemService](/ad-manager/api/reference/v202411/ProposalLineItemService.UnitType) **Dependencies** \n[AlternativeUnitTypeForecast](/ad-manager/api/reference/v202411/ForecastService.AlternativeUnitTypeForecast) [AvailabilityForecast](/ad-manager/api/reference/v202411/ForecastService.AvailabilityForecast) [Goal](/ad-manager/api/reference/v202411/ForecastService.Goal) [LineItemDeliveryForecast](/ad-manager/api/reference/v202411/ForecastService.LineItemDeliveryForecast) \n▼\n**UnitType**\n\nIndicates the type of unit used for defining a reservation. The\n[CostType](/ad-manager/api/reference/v202411/ForecastService.CostType) can differ from the [UnitType](/ad-manager/api/reference/v202411/ForecastService.UnitType) - an\nad can have an impression goal, but be billed by its click. Usually\n[CostType](/ad-manager/api/reference/v202411/ForecastService.CostType) and [UnitType](/ad-manager/api/reference/v202411/ForecastService.UnitType) will refer to the\nsame unit.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202411`\n\n| Enumeration | Description |\n|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `IMPRESSIONS` | The number of impressions served by creatives associated with the line item. Line items of all [LineItemType](/ad-manager/api/reference/v202411/ForecastService.LineItemType) support this `UnitType`. |\n| `CLICKS` | The number of clicks reported by creatives associated with the line item. The [LineItem.lineItemType](/ad-manager/api/reference/v202411/ForecastService.LineItem#lineItemType) must be [LineItemType.STANDARD](/ad-manager/api/reference/v202411/ForecastService.LineItemType#STANDARD), [LineItemType.BULK](/ad-manager/api/reference/v202411/ForecastService.LineItemType#BULK) or [LineItemType.PRICE_PRIORITY](/ad-manager/api/reference/v202411/ForecastService.LineItemType#PRICE_PRIORITY). |\n| `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](/ad-manager/api/reference/v202411/ForecastService.LineItem#costType) must be [CostType.CPA](/ad-manager/api/reference/v202411/ForecastService.CostType#CPA). |\n| `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](/ad-manager/api/reference/v202411/ForecastService.LineItem#costType) must be [CostType.CPA](/ad-manager/api/reference/v202411/ForecastService.CostType#CPA). |\n| `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](/ad-manager/api/reference/v202411/ForecastService.LineItem#costType) must be [CostType.CPA](/ad-manager/api/reference/v202411/ForecastService.CostType#CPA). |\n| `VIEWABLE_IMPRESSIONS` | The number of viewable impressions reported by creatives associated with the line item. The [LineItem.lineItemType](/ad-manager/api/reference/v202411/ForecastService.LineItem#lineItemType) must be [LineItemType.STANDARD](/ad-manager/api/reference/v202411/ForecastService.LineItemType#STANDARD). |\n| `IN_TARGET_IMPRESSIONS` | The number of in-target impressions reported by third party measurements. The [LineItem.lineItemType](/ad-manager/api/reference/v202411/ForecastService.LineItem#lineItemType) must be [LineItemType.STANDARD](/ad-manager/api/reference/v202411/ForecastService.LineItemType#STANDARD). |\n| `UNKNOWN` | The value returned if the actual value is not exposed by the requested API version. |"]]