enum UnitType (v202411)

  • UnitType within ProposalLineItemService indicates how a reservation is defined, typically by impressions, clicks, or conversions.

  • While UnitType often aligns with how an ad is billed (CostType), they can differ (e.g., impression goal but billed by clicks).

  • UnitType options include impressions, clicks, various CPA conversions, viewable impressions, and in-target impressions, each with specific requirements and limitations.

  • Certain UnitType options like CPA conversions are only supported as secondary goals and require specific CostType settings on the line item.

  • Line item types like STANDARD, BULK, or PRICE_PRIORITY are often necessary for specific UnitType options to be valid.
Service
ForecastService LineItemService ProposalLineItemService
Dependencies
Goal
▼
UnitType

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.