type Targeting (v202411)

AI-generated Key Takeaways

• The Targeting object contains targeting criteria for LineItem objects and is used to define which inventory a LineItem should target.

• Targeting criteria include geographical locations, inventory, time, technology, custom criteria, user domains, content, video positions, mobile applications, and more.

• Some targeting criteria are optional while others are required depending on the LineItem type.

• The customTargeting field allows for complex targeting expressions with up to three levels of criteria sets and criteria.

• This documentation provides detailed information on each targeting field and its usage within the ForecastService.

Service

AdRuleService AdjustmentService ForecastService LineItemService NativeStyleService ProposalLineItemService ProposalService PublisherQueryLanguageService TargetingPresetService YieldGroupService

Dependencies

CreativeTargeting ForecastBreakdownTarget LineItem ProposalLineItem TrafficDataRequest

▼

Targeting

Contains targeting criteria for LineItem objects. See LineItem.targeting.

---

Namespace

https://www.google.com/apis/ads/publisher/v202411

Field
geoTargeting	GeoTargeting Specifies what geographical locations are targeted by the LineItem. This attribute is optional.
inventoryTargeting	InventoryTargeting Specifies what inventory is targeted by the LineItem. This attribute is required. The line item must target at least one ad unit or placement.
dayPartTargeting	DayPartTargeting Specifies the days of the week and times that are targeted by the LineItem. This attribute is optional.
dateTimeRangeTargeting	DateTimeRangeTargeting Specifies the dates and time ranges that are targeted by the LineItem. This attribute is optional.
technologyTargeting	TechnologyTargeting Specifies the browsing technologies that are targeted by the LineItem. This attribute is optional.
customTargeting	CustomCriteriaSet Specifies the collection of custom criteria that is targeted by the LineItem. Once the LineItem is updated or modified with custom targeting, the server may return a normalized, but equivalent representation of the custom targeting expression. customTargeting will have up to three levels of expressions including itself. The top level CustomCriteriaSet i.e. the customTargeting object can only contain a CustomCriteriaSet.LogicalOperator.OR of all its children. The second level of CustomCriteriaSet objects can only contain CustomCriteriaSet.LogicalOperator.AND of all their children. If a CustomCriteria is placed on this level, the server will wrap it in a CustomCriteriaSet. The third level can only comprise of CustomCriteria objects. The resulting custom targeting tree would be of the form:
userDomainTargeting	UserDomainTargeting Specifies the domains or subdomains that are targeted or excluded by the LineItem. Users visiting from an IP address associated with those domains will be targeted or excluded. This attribute is optional.
contentTargeting	ContentTargeting Specifies the video categories and individual videos targeted by the LineItem.
videoPositionTargeting	VideoPositionTargeting Specifies targeting against video position types.
mobileApplicationTargeting	MobileApplicationTargeting Specifies targeting against mobile applications.
buyerUserListTargeting	BuyerUserListTargeting Specifies whether buyer user lists are targeted on a programmatic LineItem or ProposalLineItem. This attribute is readonly and is populated by Google.
inventoryUrlTargeting	InventoryUrlTargeting Specifies the URLs that are targeted by the entity. This is currently only supported by YieldGroup.
verticalTargeting	VerticalTargeting Specifies the verticals that are targeted by the entity. The IDs listed here correspond to the IDs in the AD_CATEGORY table of type VERTICAL.
contentLabelTargeting	ContentLabelTargeting Specifies the content labels that are excluded by the entity. The IDs listed here correspond to the IDs in the CONTENT_LABEL table.
requestPlatformTargeting	RequestPlatformTargeting Specifies the request platforms that are targeted by the LineItem. This attribute is required for video line items and for ProposalLineItem. This value is modifiable for video line items, but read-only for non-video line items. This value is read-only for video line items generated from proposal line items.
inventorySizeTargeting	InventorySizeTargeting Specifies the sizes that are targeted by the entity. This is currently only supported on YieldGroup and TrafficDataRequest.