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/v202408
Enumeration
Description
IMPRESSIONS
The number of impressions served by creatives associated with the line
item. Line items of all LineItemType support this UnitType.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eUnitType\u003c/code\u003e indicates how a reservation is defined, such as by impressions or clicks, and can differ from how it's billed (\u003ccode\u003eCostType\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003eCostType\u003c/code\u003e and \u003ccode\u003eUnitType\u003c/code\u003e often align, an ad might aim for impression goals but be charged based on clicks.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eUnitType\u003c/code\u003e options include standard metrics like impressions and clicks, as well as CPA conversions and viewability metrics.\u003c/p\u003e\n"],["\u003cp\u003eCertain \u003ccode\u003eUnitType\u003c/code\u003e values like clicks and viewable impressions have restrictions on the applicable \u003ccode\u003eLineItemType\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSome \u003ccode\u003eUnitType\u003c/code\u003e options like CPA conversions are specifically designated for secondary goals and require a CPA \u003ccode\u003eCostType\u003c/code\u003e.\u003c/p\u003e\n"]]],["`UnitType` defines reservation units, which can differ from `CostType`. Available units include `IMPRESSIONS`, `CLICKS`, `CLICK_THROUGH_CPA_CONVERSIONS`, `VIEW_THROUGH_CPA_CONVERSIONS`, and `TOTAL_CPA_CONVERSIONS`. Other options include `VIEWABLE_IMPRESSIONS`, `IN_TARGET_IMPRESSIONS`, and `UNKNOWN`. Specific `LineItemType` restrictions apply to some unit types. `CPA` cost type must be used with specific unit types. Some unit types are only supported as a secondary goal. The namespace for these features is `https://www.google.com/apis/ads/publisher/v202408`.\n"],null,["**Service** \n[ForecastService](/ad-manager/api/reference/v202408/ForecastService.UnitType) **LineItemService** [ProposalLineItemService](/ad-manager/api/reference/v202408/ProposalLineItemService.UnitType) **Dependencies** \n[Goal](/ad-manager/api/reference/v202408/LineItemService.Goal) \n▼\n**UnitType**\n\nIndicates the type of unit used for defining a reservation. The\n[CostType](/ad-manager/api/reference/v202408/LineItemService.CostType) can differ from the [UnitType](/ad-manager/api/reference/v202408/LineItemService.UnitType) - an\nad can have an impression goal, but be billed by its click. Usually\n[CostType](/ad-manager/api/reference/v202408/LineItemService.CostType) and [UnitType](/ad-manager/api/reference/v202408/LineItemService.UnitType) will refer to the\nsame unit.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\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/v202408/LineItemService.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/v202408/LineItemService.LineItem#lineItemType) must be [LineItemType.STANDARD](/ad-manager/api/reference/v202408/LineItemService.LineItemType#STANDARD), [LineItemType.BULK](/ad-manager/api/reference/v202408/LineItemService.LineItemType#BULK) or [LineItemType.PRICE_PRIORITY](/ad-manager/api/reference/v202408/LineItemService.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/v202408/LineItemService.LineItem#costType) must be [CostType.CPA](/ad-manager/api/reference/v202408/LineItemService.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/v202408/LineItemService.LineItem#costType) must be [CostType.CPA](/ad-manager/api/reference/v202408/LineItemService.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/v202408/LineItemService.LineItem#costType) must be [CostType.CPA](/ad-manager/api/reference/v202408/LineItemService.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/v202408/LineItemService.LineItem#lineItemType) must be [LineItemType.STANDARD](/ad-manager/api/reference/v202408/LineItemService.LineItemType#STANDARD). |\n| `IN_TARGET_IMPRESSIONS` | The number of in-target impressions reported by third party measurements. The [LineItem.lineItemType](/ad-manager/api/reference/v202408/LineItemService.LineItem#lineItemType) must be [LineItemType.STANDARD](/ad-manager/api/reference/v202408/LineItemService.LineItemType#STANDARD). |\n| `UNKNOWN` | The value returned if the actual value is not exposed by the requested API version. |"]]
