PRODUCT
Follow

Introduction

Overview

The Adhesion is an ad format that continually adheres to the bottom of the display while the user scrolls through the page. The Adhesion is an upgrade to the Sizmek format “IAB Mobile Adhesionand expands the support matrix to cover the desktop in addition to tablet and mobile devices.  This format should be used in lieu of “IAB Mobile Adhesion” going forward.

The Ad Builder - Adhesion is the Ad Builder version of the Adhesion. The workspace version is a separate custom format and has added functionality that can be found by referencing the table below. If interested please check the workspace's build guide. Workspace templates give you greater flexibility to adapt the code and program additional customizations while Ad Builder templates provide ease of use. The templates available within these alternate environments may be slightly different, so make sure you use the one based on your needs. The different templates are described below, but check back frequently since new templates are expected to be added.

Ad Builder Templates

There are four flavors of the Adhesion format that are currently available on Ad Builder - Basic Mobile Banner, Basic Desktop Banner, Basic Mobile Expandable, and Basic Desktop Expandable.

Template Name

Video

Banner

Dimension

Banner Panel Dimension

Expand Panel

Dimension

Adhesion Basic Mobile Banner

No

1x1

320x50

n/a

Adhesion Basic Mobile Expandable

Yes

1x1

320x50

Full Screen with 300x250 overlay

Adhesion Basic Desktop Banner

No

1x1

728x90

n/a

Adhesion Basic Desktop Expandable

Yes

1x1

728x90

Full Screen with 600x600 overlay

The Basic Mobile Banner and Basic Mobile Expandable are design for small screen like mobile phone with banner only and expandable options. The Basic Desktop Banner and Basic Desktop Expandable are design for large screen such as desktop and tablet with banner only and expandable options. Unlike the Workspace version, the expandable will display a fixed size (300x250 for mobile, 600x600 for desktop) overlay centered in a full screen lightbox. The illustrations below show you the Basic Mobile Banner and Basic Mobile Expandable.

Basic Mobile Banner

banner.png 

Basic Mobile Expandable (collapsed)

 

Basic Mobile Expandable (expanded)

 

Apple_iPhone-8_Jan_12_2018_18_40_09.png Apple_iPhone-8_Jan_12_2018_18_41_48.png

The templates available may be slightly different, Below table shows functionality difference between different Ad Builder templates and workspace templates 

Adhesion Functionality

Ad Builder 

Workspace

Full width banner

Option to use MRAID default close button 

*

**

Responsive full-screen panel, Panel content resize on browser resize.

Restrict page scroll when full-screen panel is expanded

Sizmek Advertising Suite Support


* via Ad Settings from Ad Builder

** via Custom JS Var mdEnableSDKDefaultCloseButton.

This format includes a fully “domain configurable” / "Liquid Framework" solution. For more information on the domain configurable formats in general, and how to preview the different certified settings, please see Domain Config Solution for Custom Formats

Demos

The following table provides links to the demos for the Adhesion format.

Demo

Supported Platforms

Platform

Supported Versions

Windows

Internet Explorer 10+, Microsoft Edge, Firefox, Chrome, Safari

Mac

Safari, Firefox, Chrome

iPhone

iOS 9.0 and later

iPad

iOS 9.0 and later

Android

Android 6.0 and later (including Tablet)

Note: This format supports in App function such as expand and video playing, however, the adhesion function may or may not work properly depends on the design of the App.

Format Properties

Listed below are common properties available to the format.

Feature Supported
Polite Loading
Safeframe Support
MRAID (in APP Support)
AdKit-ready
Liquid Framework (One-Tag Solution)
Secure Serving
Sizmek Advertising Suite Support
Workspace Template Available

 

Implementing Adhesion using Ad Builder

Setting up new ad in Ad Builder

Adhesion format is available on Ad Builder.

  1. To access the Adhesion format template in Ad Builder, click Template Gallery from the Ad Builder Welcome screen.
    template_gallery_button.png
  2. Click the Format tab. You should be able to find Adhesion format from the template list.adbuilder.png
  3. To create a new ad, simply select a template and then click Create. The new ad will start with the template you selected. The left section of Ad Builder show default panel and banner.adbuilder2.jpg
  4. Adhesion is served from 1x1 banner and you don't have to edit anything in 1x1 banner.
  5. Select one of the panels appearing below 1x1 banner to edit. You can edit panel by changing, removing, or adding components based on your requirements. After you done with editing, you can click on Save to save the ad to Sizmek platform and preview your ad. 

Customizing the Adhesion in Ad Builder

You may remove or replace any existing component in the template with your own creative assets. However, there are some things you need to be aware of:

  • Removing the video: If you wish to remove the video component, please make sure you go to the Actions & Animations for each button and remove ”Pause: video-container” action from Tap/Click event.
  • Changing the close button: With Ad Builder, you should be able to style your own close button by using component Properties, but if you are removing the close button that come with the template and adding your own close button, please make sure you go to the Actions & Animations and add the following action to Tap/Click event.
  • Expandable – Collapse, and select a panel target (banner, expand, or the other name if you have made change to the panel name).
    If your ad contains video, it is recommended to add the following action prior to the Collapse action so the video can be paused when the panel collapses. Normally we will also make the Collapse action start 200ms after the Pause action.
  • Video Action – Pause, and select a video target (video-container or the one you create)

Restrictions & Important Notes

  • The auto expand and frequency capping option from ad settings on MDX platform is not working properly with the ad builder templates, please avoid to use those options.

Setting up Adhesion on the Sizmek Platform

Setting Adhesion on MDX2.0 Platform

Once you have saved the ad to the platform, you can now use the settings from the Platform to setup your ad.

  1. Go to Ad Settings on platform.
  2. Do required updates if any.
  3. Save the ad.
  4. Create a new placement for the ad.
  5. Fill out the form. Set the Placement type to In Banner and the Banner size to 1x1.
    After you’ve saved your placement, you can then generate preview tags to test on your web site.

Custom Script Notice:

Since the Interstitial format is a HTML5 Custom Format, there is no need to attach a custom script since the appropriate one will be pulled in automatically. For reference, the following custom script is being used:

PL_AdBuilderAdhesion.js

Setting Adhesion in Sizmek Advertising Suite

Once you have saved the ad to the platform, you can now use the settings from the Platform to setup your ad.

  1. Go to Ad Settings on platform.
  2. Do required updates if any.
  3. Save the ad.
  4. Create a new placement for the ad.
  5. Fill out the form. Set the Placement type to In Banner and the Banner size to 1x1.
    After you’ve saved your placement, you can then generate preview tags to test on your web site.

Custom Script Notice:

Since the Interstitial format is a HTML5 Custom Format, there is no need to attach a custom script since the appropriate one will be pulled in automatically. For reference, the following custom script is being used:

PL_AdBuilderAdhesion.js

Custom Variables

Variable Name

Type

Description

Default Value

mdBannerPanelName

String

Name of the banner panel.

banner

mdExpandPanelName

Integer

Name of the expand panel.

expand

mdHideBannerOnUserScroll

Boolean

Decides if the banner will need to be hidden while user scroll the publisher page.

Yes

mdRestrictPageScrollWhenExpand

Boolean

Decides if user be able to scroll the publisher page while the ad expanded.

Note: User may still be able to scroll on some devices, but our ad will try to scroll the page back to the previous position when the ad expands. Alternatively if using the banner template, the ad will scroll to the top of the page on ad load; you can set the value of this variable to "No" to cancel scrolling to the top of the page on ad load. 

Yes

mdEyeDivZIndex

Number

The z-index of the eye div.

2147483647

mdIsDomainConfigEnabled

Boolean

Set ad to load with domain configuration.

No

mdProgSettingsFolderPath

String

Path to the folder of the settings files, not including protocol

//services.serving-sys.com/programmatic/DomainList/

mdAutoRepositionInterval

Number

Repositions all panels every N milliseconds. if set to 0, automatic repositioning is disabled.

0

mdBackupImgPath

String

Relative path to the backup image, if a custom image is desired. This allows a fallback experience to display an image that is not a 1x1 even though the tag is a 1x1 tag. For example, if this custom var were set to "images/300x250_Default.jpg," then a file would attempt to be loaded from the images folder. You must be sure this file exists in the workspace. When set to undefined, the normal 1x1 fallback occurs.

undefined

mdParentLevelsToResize

Integer

This variable is only used when the ad is serving a default image. When set to any value over 0, this number of publisher parent elements of our tag will be resized to the default image size, if they are smaller than the default image serving.

0

Reported Custom Interactions

Besides the standard HTML5 ad interactions, the following are the custom interactions reported by this format and can be reviewed in Sizmek reporting.

Custom Interactions

Description

closeAd

Sent when user click the close icon on the top right corner.

UserAction

Send when user click the UserAction button.

Known Issues

  • The video may not play full screen in native video player, the full screen video will plays within the full browser instead.
  • The page may zoomed out when rotate the device on Native Android browser on some Android 4.x devices.
  • On IE11 panel may shift from left to center during page resize.
  • When using the Adhesion Desktop formats and the Mobile Expandable, users cannot upload assets without saving the ad first. It also does not display format image in the template gallery.
 

Change Log

January 8, 2018 (v 1.3.0)

  • Created new custom format "Ad Builder - Adhesion" only for Ad Builder template. "Adhesion" support workspace only.
  • Ad Builder template re-created under new format name "Ad Builder - Adhesion"
  • Expandable template, Banner panel will not collapse completely instead the visibility is changed when full screen panel expand or collapse.
  • Added full MRAID support.
  • Workspace related custom variable has been removed

September 12, 2017

  • Custom format renamed from HTML5 Adhesion to Adhesion
  • Ad Builder templates re-released with new custom format name.

July 17, 2017 (v 1.2.0)

  • Updated to support the liquid framework.
  • Modified interaction tracking - previously interactions were coming from the banner, but since banner was a 1x1 that was never displayed, all interactions are now assigned to the panel that is acting as the banner.
  • Fixed issue where the page would incorrectly snap back to the top if the user put in a delay when showing the adhesion banner or if the user had to scroll the page to see the adhesion banner.

Feburary 2, 2017

  • Released Ad Builder templates in Sizmek Advertising Suite

July 6, 2016 (v 1.1.0)

  • Add Ad Builder templates on MDX2.0 Platform
  • Support polite loading

 

 

 

Notice

The information contained in this document is proprietary and confidential to Sizmek and/or any of its affiliated companies. Disclosure, copying, reproduction, storing or any use of this document or any part thereof without the express prior, written consent of Sizmek or its authorized representatives is strictly prohibited. The information furnished in this document is believed to be accurate and reliable. However no responsibility is assumed by Sizmek for the use of this information. Sizmek reserves the right to make changes to the information included in this document at any time and without notice.

 

Copyright © 2017 Sizmek. All rights reserved.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments