type VideoPosition (v202408)
Represents a targetable position within a video. A video ad can be targeted
to a position (pre-roll, all mid-rolls, or post-roll), or to a specific mid-roll index.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
Field
|
positionType
|
VideoPosition.Type
The type of video position (pre-roll, mid-roll, or post-roll).
Enumerations
-
UNKNOWN
- The value returned if the actual value is not exposed by the requested API version.
-
ALL
- This position targets all of the above video positions.
-
PREROLL
- The position defined as showing before the video starts playing.
-
MIDROLL
- The position defined as showing within the middle of the playing video.
-
POSTROLL
- The position defined as showing after the video is completed.
|
midrollIndex
|
xsd:int
The index of the mid-roll to target. Only valid if the positionType is
VideoPositionType.MIDROLL , otherwise this field will be ignored.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-20 UTC.
[null,null,["Last updated 2024-08-20 UTC."],[[["VideoPosition allows targeting ads within videos, such as pre-roll, mid-roll, or post-roll."],["It uses `positionType` to define the ad's placement (pre-roll, mid-roll, post-roll, or all)."],["For mid-roll placements, `midrollIndex` specifies the targeted mid-roll's index within the video."],["This feature enables precise ad placement within video content for optimal viewer engagement and campaign performance."]]],["The core content details video ad targeting within a video. Key actions involve targeting `VideoPosition`, defined by `positionType` (pre-roll, mid-roll, post-roll, or all). `midrollIndex`, an integer, specifies the mid-roll's position when `positionType` is `MIDROLL`. Several services, including `AdRuleService`, `AdjustmentService`, `LineItemService`, and others, leverage this `VideoPosition` information to manage ad placement. This namespace is used for all the listed services: `https://www.google.com/apis/ads/publisher/v202408`.\n"]]