Mobile Web
Search
⌃K

Thumbnail Ad

Tag based integration of the Thumbnail format into publisher's web pages

Ad Tag Creation

For all the pages where you want to display an Ogury ad, copy the following snippet on the placement of your choice inside the page's body.
<script type='text/javascript'>
window.top.OG_ad_units = window.top.OG_ad_units || [];
window.top.OG_ad_units.push({
ad_unit_id: '$OGURY_AD_UNIT',
asset_key: '$OGURY_ASSET_KEY'
});
</script>
<script src="https://mwtw.presage.io/v1/tag.js" async></script>
You need to replace $OGURY_AD_UNIT and $OGURY_ASSET_KEY by the values you received during the configuration in the platform. These values are mandatory for the tag execution.

Parameter Configuration Details

Below you'll find a list of parameters for the Thumbnail format, that can be used to customize the rendering of the ad. Those parameters have to be defined in the params object.

max_width

Description
The desired maximum width in pixels the ad may take on the page
Prebid.js Notation
n/a
Required
no
Type
Number
Default Value
180
Example Value
180

max_height

Description
The desired maximum height in pixels the ad may take on the page
Prebid.js Notation
n/a
Required
no
Type
Number
Default Value
180
Example Value
180

gravity

Description
The area of the screen where the Thumbnail Ad will be placed
Prebid.js Notation
gravity
Required
no
Type
String
Default Value
'BOTTOM_RIGHT'
Values
'TOP_LEFT | TOP_RIGHT | TOP_CENTER | BOTTOM_LEFT | BOTTOM_RIGHT | BOTTOM_CENTER | CENTER'

y_margin

Description
The vertical distance to the border of the screen in pixel depending on the chosen gravity
Prebid.js Notation
yMargin
Required
no
Type
Number
Default Value
20

x_margin

Description
The horizontal distance to the border of the screen in pixel depending on the chosen gravity
Prebid.js Notation
xMargin
Required
no
Type
Number
Default Value
20

Example Configurations

Customizing the Thumbnail Ad Size

Please adapt the max_width and max_height to best fit your needs.
By default, this format uses max_width= 180 and max_height= 180 to improve the readability of the content of ad.
Example: when given max_width= 180 and max_height= 180, the Ogury Exclusive Demand Tag may decide to display a 16:9 ad inside. In this case the Thumbnail Ad size will be 180x102 to match the ratio of the 16:9 ad. Display ads will have a ratio of 4:3 which leads to a creative size of 180x135px.
The following constraints apply on the values you can pass to these parameters:
  • max_width and max_height must not be greater than the size of the viewport.
  • max_width and max_height must be greater than or equal to 101.
  • longest side, either max_width or max_height, must be greater than or equal to 180.

Customizing the Thumbnail Ad Position

To customize the Thumbnail Ad position, set params fields with gravity, x_margin and y_margin parameters:
params:{
gravity: 'BOTTOM_RIGHT',
x_margin: 20,
y_margin: 20
}
  • gravity : the area based on which the thumbnail will be positioned and it can have the following values:
    • 'TOP_LEFT'
    • 'TOP_RIGHT'
    • 'TOP_CENTER'
    • 'BOTTOM_LEFT'
    • 'BOTTOM_RIGHT'
    • 'BOTTOM_CENTER'
    • 'CENTER'
Default value: 'BOTTOM_RIGHT'
  • x_margin: distance on the x axis from the gravity area to thumbnail. Value must be in px.
Default value : 20
This value is ignored if the gravity is set to 'CENTER', 'TOP_CENTER' or 'BOTTOM_CENTER'
  • y_margin: distance on the y axis from the gravity corner to thumbnail. Value must be in px.
Default value : 20
This value is ignored if the gravity is set to 'CENTER'
You cannot configure the time until the closing button for the ad appears. The default value is set to 8 seconds or 80% of the video duration.
​
Ad Server Setup - Previous
Xandr
Next - Ad Formats
Header Ad
Last modified 2mo ago