The BannersIn2 solution enables insertion of non-linear ads around or over video streams using SIMID creatives. Templates define the necessary information for generating and correctly displaying these SIMID creatives.
This document outlines the templates for SIMID creatives available in broadpeak.io, the types of ad units they enable, and the information required for each template.
We focus specifically on the required raw data; information about how the ad server should return this data is documented elsewhere.
Template: base-static-v1
This template is used for display of a single full-frame image, shown for the full duration of the ad, around or over the video content.
The creative is static and does not offer any interactive mechanism.
Ad units
This template enables most ways to present full-frame static non-linear ads, such as
Required parameters
The data needed to use this template is the following:
A single image
An indication of whether the image already uses transparency or not
The coordinates and dimensions of the media area within that image
Media area
A transparent area (called the media area) is defined within the bounds of the image, within which the video player is positioned.
The coordinate of that area, given in pixels, are defined by:
An anchor point: (x, y) - the point (0, 0) is the top left corner of the image, in line with conventions by most image editing tools.
Dimensions: width and height
⚠️ All points of the media area must fall within the original image dimensions, or the creative will refuse to display itself
An example of 1920x1080 image with media area in the top-left corner
If the image does not have transparency (whether detected or stated), broadpeak.io will use the media area dimensions supplied to carve a transparent rectangle within which the video player will be positioned.
❗️
Aspect ratio
You should ensure that the aspect ratio of the media area matches the aspect ratio of your content. Otherwise black banners may appear between the video and the sides of the media area. This may not be avoidable if your content varies in aspect ratio.
A creative meant to be used with 16:9 content will show 4:3 content centered in the media area
Resolution
A SIMID creative based on this template takes its size from the image supplied. It automatically scales itself to fit on the device or viewport (using the available dimensions reported by the application), whilst respecting the aspect ratio of the image.
If necessary, it centers itself horizontally or vertically, in case the aspect ratio of the device does not match the image.
Left: A 16:9 creative fills a 16:9 display (eg. TV)
Right: on the other hand, that creative on a 20:9 display (eg. smartphone) will be centered to fit
To ensure the creative fills the entire screen, make sure your image dimensions match the target viewport or display.
A 20:9 creative (eg. 2400x1080) fills a 20:9 display (eg. smartphone)
❗️
Multiple displays
If you target multiple devices with different aspect ratios, you may have to provide multiple versions of the image and associated dimensions. Your ad server will have to be able to return the appropriate information based on the device streaming the content.
Examples
Classic L-banner / L-shape
A very standard use case is to wrap the video with an L-shaped image, which strictly does not overlay the content
image: 1920x1080 \ media area: x=320, y=0, width=1600, height=900
Wrapper / Frame ad
The media area does not necessarily need to be situated at the edges of the image, allowing for a more “wrapping” effect
image: 1920x1080 \ media area: x=94, y=213, width=1280, height=720
Using transparency
Using images that already contains transparency allows for some more “creative” use cases.
A full overlay ad can be achieved by using an image that features transparency across most of its surface, with the media area dimensions precisely matching the image dimensions
image: 1920x1080 \ media area: x=0, y=0, width=1920, height=1080
Partial overaly can be done by using an image that features a mostly transparent area for the video player while placing certain elements as overlays on top of the content.
image: 1920x1080 \ media area: x=0, y= 0, width=1440, height=810
Call to action
While only a single image can be used, its design can include calls to action, such as QR codes. However, these elements cannot be dynamic or personalized with this template.
image: 1920x1080 | media area: x=640, y=0, width=1280, height=720
Custom templates
📞
Should you have specific requirements not met by the templates described above, bespoke creative templates can be designed.
