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.
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.
[[["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\u003eVideoPositionTarget\u003c/code\u003e allows you to target specific positions within a video, such as pre-roll, mid-roll, post-roll, or bumper positions.\u003c/p\u003e\n"],["\u003cp\u003eThis targeting can be further refined by specifying positions within ad pods or by targeting custom ad spots using their IDs.\u003c/p\u003e\n"],["\u003cp\u003eTargeting options include \u003ccode\u003evideoPosition\u003c/code\u003e, \u003ccode\u003evideoBumperType\u003c/code\u003e, \u003ccode\u003evideoPositionWithinPod\u003c/code\u003e, and \u003ccode\u003eadSpotId\u003c/code\u003e, providing flexibility in ad placement.\u003c/p\u003e\n"],["\u003cp\u003eFor bumper positions, you must specify the \u003ccode\u003evideoBumperType\u003c/code\u003e as either \u003ccode\u003eBEFORE\u003c/code\u003e or \u003ccode\u003eAFTER\u003c/code\u003e the ad pod, while line items need a corresponding bumper type.\u003c/p\u003e\n"],["\u003cp\u003eTo target positions within an ad pod, utilize \u003ccode\u003evideoPositionWithinPod\u003c/code\u003e, while \u003ccode\u003eadSpotId\u003c/code\u003e allows for targeting custom ad spots directly.\u003c/p\u003e\n"]]],["The `VideoPositionTarget` defines targetable positions within a video, relying on `VideoPositionTargeting`. Key attributes include: `videoPosition`, specifying the targeted position; `videoBumperType`, indicating bumper positions (BEFORE/AFTER); `videoPositionWithinPod`, for positions inside a pod; and `adSpotId`, for targeting a custom ad spot. Targeting a video or pod position requires a null `videoBumperType`, while bumper positions necessitate a populated `videoBumperType`. Each targeting type also requires specific attributes to be null or populated.\n"],null,["# type VideoPositionTarget (v202408)\n\n**Service** \n**AdRuleService** [AdjustmentService](/ad-manager/api/reference/v202408/AdjustmentService.VideoPositionTarget) [ForecastService](/ad-manager/api/reference/v202408/ForecastService.VideoPositionTarget) [LineItemService](/ad-manager/api/reference/v202408/LineItemService.VideoPositionTarget) [NativeStyleService](/ad-manager/api/reference/v202408/NativeStyleService.VideoPositionTarget) [ProposalLineItemService](/ad-manager/api/reference/v202408/ProposalLineItemService.VideoPositionTarget) [ProposalService](/ad-manager/api/reference/v202408/ProposalService.VideoPositionTarget) [PublisherQueryLanguageService](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.VideoPositionTarget) [TargetingPresetService](/ad-manager/api/reference/v202408/TargetingPresetService.VideoPositionTarget) [YieldGroupService](/ad-manager/api/reference/v202408/YieldGroupService.VideoPositionTarget) **Dependencies** \n[VideoPositionTargeting](/ad-manager/api/reference/v202408/AdRuleService.VideoPositionTargeting) \n▼\n**VideoPositionTarget**\n\nRepresents the options for targetable positions within a video.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `videoPosition` | ` `[VideoPosition](/ad-manager/api/reference/v202408/AdRuleService.VideoPosition)` ` The video position to target. This attribute is required. |\n| ### `videoBumperType` | ` `[VideoBumperType](/ad-manager/api/reference/v202408/AdRuleService.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. \u003cbr /\u003e |\n| ### `videoPositionWithinPod` | ` `[VideoPositionWithinPod](/ad-manager/api/reference/v202408/AdRuleService.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. |\n| ### `adSpotId` | ` `xsd:`long` A custom spot [AdSpot](/ad-manager/api/reference/v202408/AdRuleService.AdSpot) to target. To target a video position, a bumper type or a video position within a pod this value must be null. |"]]
