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 publishers 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 the position within an ad pod or targeting a custom ad spot using its ID.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eVideoPositionTarget\u003c/code\u003e utilizes fields like \u003ccode\u003evideoPosition\u003c/code\u003e, \u003ccode\u003evideoBumperType\u003c/code\u003e, \u003ccode\u003evideoPositionWithinPod\u003c/code\u003e, and \u003ccode\u003eadSpotId\u003c/code\u003e to define the desired ad placement.\u003c/p\u003e\n"],["\u003cp\u003eThe namespace for \u003ccode\u003eVideoPositionTarget\u003c/code\u003e is \u003ccode\u003ehttps://www.google.com/apis/ads/publisher/v202408\u003c/code\u003e, indicating its place within the Google Ad Manager API.\u003c/p\u003e\n"]]],["The `VideoPositionTarget` defines targetable positions within a video, with required `videoPosition`. It also uses the `videoBumperType`, specifying bumper positions like `BEFORE` or `AFTER` an ad pod. The `videoPositionWithinPod` targets positions inside a pod, while `adSpotId` targets custom ad spots. Each of these fields is mutually exclusive, meaning if one is specified the other needs to be null. They are used within AdRule, Adjustment, Forecast, LineItem, NativeStyle, ProposalLineItem, Proposal, TargetingPreset and YieldGroup Services.\n"],null,["# type VideoPositionTarget (v202408)\n\n**Service** \n[AdRuleService](/ad-manager/api/reference/v202408/AdRuleService.VideoPositionTarget) [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** [TargetingPresetService](/ad-manager/api/reference/v202408/TargetingPresetService.VideoPositionTarget) [YieldGroupService](/ad-manager/api/reference/v202408/YieldGroupService.VideoPositionTarget) **Dependencies** \n[VideoPositionTargeting](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.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/PublisherQueryLanguageService.VideoPosition)` ` The video position to target. This attribute is required. |\n| ### `videoBumperType` | ` `[VideoBumperType](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.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/PublisherQueryLanguageService.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. |"]]