PRODUCT
Follow

If you used a 3rd party authoring tool, such as a code editor or Adobe Animate, to build your Billboard, proceed to set up your ad in Sizmek Ad Suite (SAS) .

Note

Note: If you used Ad Builder to build your Billboard, this set up is not required and you can proceed to sharing your ad. For more information, see Share Your Ads.

Prerequisites

Before uploading your ad to SAS, verify that you have completed these prerequisites:

  • The folder that contains your assets does not include unnecessary files. For example:

    • Unused assets such as images, videos, or fonts.

    • Work files such as .psd, .fla, or .scss.

    • Hidden files such as thumbs.db (Windows) or .DS_Store (Mac).

  • Create a Workspace (zip file) for each ad. It is recommended that the zip file name matches the final name of the ad.

  • Each Workspace contains its default image (named Default or Backup). This image should be optimized and lightweight.

Setting up a Single Ad

Setting up your ad requires that you start by uploading your Workspace to the Assets Library. Then, set up your ad based on the Workspace that you uploaded.

Upload Your Ad

Procedure
  1. Select Creative > Assets Library.

  2. Click New Folder to create a folder into which you will upload your Workspace.

  3. Click Upload.

  4. Perform one of the following actions:

    • Drag your zipped Workspace in the new window.

    • Click Browse Files to locate the Workspace.

  5. Click Done.

Set up Your Ad

Procedure
  1. Select Creative > Ads.

  2. Click New Ad > Blank Ad.

  3. Give your ad a meaningful name.

  4. In the Ad Format list, select Billboard.

    Note

    Note: Your account must have permission to see the Billboard option in the list of available custom formats, If you do not see this format, contact .

  5. In the Creative Assets > Main Assets tab,:

    1. Select the Workspace folder and navigate to an uploaded Workspace.

    2. Select the 1x1 default image, images/backup.jpg.

  6. In the Creative Assets > Panels tab:

    1. Click Add Panel.

      1. For Panel Name, type billboard.

      2. For Asset, select the asset panels/billboard/index.html.

      3. Set the Width to 1272.

      4. Set the Height to 328.

      5. Select the Default check box.

    2. Click Add Panel.

      1. For Panel Name, type leavebehind.

      2. For Asset, select the asset panels/leavebehind/index.html.

      3. Set the Width to 1272.

      4. Set the Height to 31.

  7. In the Creative Assets > Panels > Advanced Panel Settings section, select the expected website behavior. For more information about advanced panel settings, see Expandable Ad Fields.

    Note

    Note: Common recommendations include:

    • Auto-Expand: Overwrite Creative Settings.

    • Panel Frequency: Auto-Expand 1 time per Day for a unique user.

    • Select Show Single Panel at a Time If Ad Contains Multiple Panels.

  8. Click Save.

Advanced

Note

Note: If you defined the config.js file correctly, all values are populated automatically.

You can define or change additional settings using these custom variables.

Variable Name in SAS

(Variable Key in config.js)

Description

Variable Type

Default Value

Billboard Panel Name

(mdBillboardPanelName)

Billboard panel name in SAS.

String

billboard

Collapse Animation Duration

mdCollapseAnimationDuration

Collapse animation duration of the billboard panel in seconds.

Number

1

Expand Animation Duration

mdExpandAnimationDuration

Expand animation duration of the billboard panel in seconds.

Number

1

Auto Expand Animation Duration

mdAutoExpandAnimationDuration

Initial auto-expand animation duration of the billboard panel in seconds.

Number

1

Easing Type

mdEasingType

Easing type for the collapse and expand of the billboard panel: (0 or none, 1 or linear, 2 or ease-in, 3 or ease-out, 4 or ease-in-out)

  • 0: none

  • 1: linear

  • 2: ease-in

  • 3: ease-out

  • 4: ease-in-out

Number

4

EyeDiv Z-Index

mdEyeDivZIndex

Set z-index of the panels on publishers page.

String

undefined

Leave Behind Alignment

mdLeaveBehindAlignment

Alignment of the leave behind panel on the publisher page (left, right or center).

String

right

Leave Behind Panel Name

mdLeaveBehindPanelName

Leavebehind panel name in SAS.

String

leavebehind

Animate Clipping

mdAnimateClipping

  • Yes: Billboard panel animates and expands.

  • No: Billboard panel will not animate and just snap and expand.

Boolean

Yes

Close Button Show

mdCloseButtonShow

If set to Yes, the billboard panel will have a Close button and the ability to close the billboard panel.

Boolean

Yes

Does Leave Behind Take Space

mdDoesLeaveBehindTakeSpace

Determines whether the leave behind overlaps elements on the publisher page.

Boolean

Yes

Local Storage Name

mdLocalStorageName

Used to share the expand/collapse state between multiple ads. If multiple ads have the same value, they will share the same state when served. If this is undefined, the ad will not share state with any other ads.

String

undefined

Local Storage Duration

mdLocalStorageDuration

Used to provide the local storage duration in hours. If 0, the duration will be infinite.

Number

12

Never Show Leave Behin

mdNeverShowLeaveBehind

If true, no leave behind will be shown, even when the billboard panel collapses. The billboard panel will be shown every time the ad loads.

Boolean

No

Snap Points Width

mdSnapPointsWidth

Used to provide the creative snap-points between the maximum and minimum width.

If the publisher container for the ad drops below the minimum width that you set, the ad will be removed so it does not display incorrectly. Make sure you set your lowest width low enough to display in the smallest size that your design supports.

If you set mdSnapPointsAnimation to Yes, the ad will scale up to fit the page content.

String

620,824,945,1119,1272

Snap Points Animation

mdSnapPointsAnimation

  • Yes: Billboard will animate fluidly between the snap-points upon browser resize.

  • No: Billboard will snap without animation on resize.

Boolean

No

Backup Image Path

mdBackupImgPath

Used to provide the image path for the down-level image.

String

images/billboard.jpg

Parent Levels To Resize

mdParentLevelsToResize

Only used when the ad is serving a default image. When set to any value greater than 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.

Integer

0

Is Prog. Enabled?

mdIsProgEnabled

Determines whether to load the programmatic settings.

Boolean

No

Prog. Settings Folder Pat

mdProgSettingsFolderPath

Location from which to load the programmatic settings files.

String

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

Interactions Cancel AutoCollapse

mdInteractionsCancelAutoCollapse

Only used when there is an auto-expand panel. When there is a user interaction, the panel will not be closed.

Boolean

No

Auto Collapse Timer

mdAutoCollapseTimer

If there is an auto-expand panel, it will be closed after "n" milliseconds.

Number

0

mdAutoRepositionInterval

Ad resize/reposition interval. 0 to turn off the interval. Ad attempts to resize itself every "n" milliseconds. Even with this value set to 0, the ad will always attempt to resize itself upon browser resize, browser scroll, or orientation change. This variable adds an interval by which to attempt to resize/reposition also.

Number

0

Previewing and Testing

After you finish creating your ad, make sure that you preview and test it. For more information, see Preview Your Ads and Test Your Ads.

Loading Modes

You can set your Billboard to serve in one of these loading modes:

  • Instant: The entire unit loads immediately. This is the default behavior.

  • Polite: A lightweight image loads first. The full ad loads after the publisher's page finishes loading.

For more information about polite loading, see Add Polite Load to your HTML Ads.

Custom Script Notice

The Billboard format is an HTML custom format; therefore, there is no need to attach a custom script. The appropriate custom script will be included automatically. This is shown as the pre-entered value PL_HTML5ResponsiveBillboard.js for the Preload Script custom variable. For example: https://secure-ds.serving-sys.com/BurstingRes/CustomScripts/PL_HTML5ResponsiveBillboard.js.

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

Comments