Set Up On-Page Tags for Outstream Video
For select use cases, AST can also be defined, loaded, and shown in the page body.
How It Works
An outstream video ad unit can be added to a web page in the following page positions:
- At the start of an article
- In between paragraphs of text in an article
- At the end of an article
In each of the scenarios outlined above, the outstream video ad unit is included as a hidden <div> element in the page body. The <div> element in the page body refers to the video ad unit using a Target Identifier, which corresponds to a definition of that Target Identifier in the page header. When the container comes into view, the outstream video ad unit is activated for playback and expands on the page to show the content.
AST lets you define the tag (placement) you intend to call. When defining an outstream placement, you can pass additional options to specify how the player should be displayed on the page and how it should behave. The following example shows a call to defineTag for an outstream placement.
Implementing SafeFrame with Outstream Video
For video creatives, SafeFrame is currently available only for Outstream video.
To enable SafeFrame for Outstream, set the
enableSafeFrame option in the
apntag definition, as shown in the following example:
Defining Player Size for SafeFrame
autoInitialSize is not yet supported for SafeFrame, you need to set the exact dimensions for the final player in
apntag, as shown in the previous example. Typically, you'll need to set up mobile and desktop placements differently to accommodate different player sizes.
You can calculate the necessary width and height of the player as shown in the following example.
When your target width = 640 and the aspectRatio=16:9:
- 640 / (16/9) = 360px player height
- 24px = top bar adds 24px to height
- 30px = if control position set to below (and not over), add 30px to height
In this example, the sum of the heights adds up to 414 for a size of [640, 414].