type VideoPositionTarget (v202411)

  • VideoPositionTarget allows you to target specific positions within a video content for ad placements.

  • It provides options to target pre-roll, mid-roll, post-roll, bumper positions, and even custom ad spots using their IDs.

  • You can refine targeting by specifying positions within ad pods or selecting specific bumper types like pre- or post-pod bumpers.

  • To use the standard video positions (pre-roll, mid-roll, post-roll) the videoPosition field needs to be populated while the other position targeting fields must be null.

  • For targeting bumper positions, only videoPosition and videoBumperType should be set, other position targeting fields must be null.
Service
AdRuleService AdjustmentService ForecastService LineItemService NativeStyleService ProposalLineItemService ProposalService PublisherQueryLanguageService TargetingPresetService YieldGroupService
Dependencies
VideoPositionTargeting
▼
VideoPositionTarget

Represents the options for targetable positions within a video.

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

Field

videoPosition

VideoPosition

The video position to target. This attribute is required.

videoBumperType

VideoBumperType

The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null.

Enumerations
BEFORE
Represents the bumper position before the ad pod.
AFTER
Represents the bumper position after the ad pod.

videoPositionWithinPod

VideoPositionWithinPod

The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null.

adSpotId

xsd:long

A custom spot AdSpot to target. To target a video position, a bumper type or a video position within a pod this value must be null.