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 one of the following snippets on the placement of your choice inside the page's body.

Custom Code

If you can't or don't want to create the tags by yourself, Ogury can provide a so called Ad Tag. This means that all configuration is done in the Ogury Interface and you don't need to worry about anything. A custom code would look like the tag below and you can use it like any other ad tag:

<script type="text/javascript" data-ccid="CC-SOME-ID" src="https://mwtw.presage.io/v1/tag.js"></script>

CC-SOME-ID corresponds to a unique custom code id that Ogury creates for you and will be automatically replaced for you when providing the Ad Tag

Regular Tag

<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 type="text/javascript" src="https://mwtw.presage.io/v1/tag.js"></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.

For more customisation options, please refer to the common configuration.

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 180x101 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.