PRODUCT

Amazon Ad Server will be sunset in Q4 2024, please visit this page (AAS offboarding information) for offboarding support resources and sunset FAQs. Details shared on that page represent the most up to date information in the Help Center, if you find disparate information in other resources please default to the information in the AAS offboarding information page accordingly.

Please note that on October 1, 2024, the ability to create new campaigns, placements and tag managers was disabled.

Follow

If you used a code editor to build your interstitial, proceed to set up your ad in Amazon Ad Server (AAS) .

Note

Note: If you used Ad Builder to build your interstitial , 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 AAS, 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. For an interstitial, the image must be a 1x1 image.

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 interstitial.

  5. In the Creative Assets > Main Assets tab:

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

      Tip

      Tip: AAS will default to this folder for the next step.

    2. Select the default image.

  6. To add the default panel, under Creative Assets, click Panels and do the following actions.

    For this setting

    Do this

    Panel Name

    Enter default.

    Asset

    Select panels/default/index.html file.

    X

    Enter 0.

    Y

    Enter 0.

    Width

    Enter 1.

    Height

    Enter 1.

    Default

    Make sure this check box is selected.

    Other Properties

    • In the Position Types box, select Page Relative (px).

    • Select Expand on Mouse Over.

    • In the Retractions box, select Never.

    • Select Transparency.

  7. Under Advanced Panel Settings, do the following:

    1. Under Auto-Expand, click Overwrite Creative Settings: Always auto-expand.

    2. Under Panel Frequency, click Unlimited.

    3. Select the Show Single Panel at a Time If Ad Contains Multiple Panels check box.

  8. (Optional) Under Advanced Features, modify any of the settings. For more information, see Advanced features.

  9. Click Save.

  10. (Optional) The format settings such as, ad name, default banner, banner settings, clickthrough and custom interactions can be modified if needed in the Ad Settings. For more information, please visit Work with custom interactions.

Loading modes

You can set your interstitial 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.

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.

Advanced features

Variable name in AAS

(Variable Key in config.js)

Type

Description

Default Value

Remove Ad After Collapsed

(mdRemoveAdAfterCollapsed)

Boolean

Removes the ad after panel collapses.

Note

Note: Enabling this feature will cause conflict with other expandable ads where elements of the other ads are unloaded.

Yes

Lock Scrolling When Expanded

(mdLockScrollingWhenExpanded)

Boolean

Locks the page scroll when panel expands.

Yes

EyeDiv Z-Index

mdEyeDivZIndex

Integer

Determines Z-index for the eye div.

1000

Enable SDK Default Close Button

mdEnableSDKDefaultCloseButton

Boolean

Displays the MRAID default close button.

Note

Note: By default, the MRAID default close button is not displayed, because the custom close button from the template is in use. Setting this variable to true enables you to use the MRAID default button.

No

Auto Play Video

mdAutoPlayVideo

Boolean

Automatically plays the video when the video loads.

Note

Note: Auto Play may not work on mobile or tablet. In addition, this variable has no effect when an ad serves in MRAID apps.

No

Parent Levels To Resize

mdParentLevelsToResize

Integer

This variable is only used when the ad is serving a default image.

When set to any value over 0, the number of publisher parent elements of our tag resizes to the default image size, if they are smaller than the default image serving.

0

Backup Image Path

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 variable is set to images/300x250_Default.jpg, a file will attempt to load from the images folder. You must be sure this file exists in the workspace.

When set to undefined, the normal 1x1 fallback occurs.

undefined

Auto Reposition Interval

mdAutoRepositionInterval

Integer

Repositions all panels every N milliseconds. If set to 0, automatic repositioning is deactivated.

0

Is Domain Config Enabled

mdIsDomainConfigEnabled

Boolean

Determines whether to load the domain configuration settings.

No

Prog Settings Folder Path

mdIsDomainConfigEnabled

String

Location from which to load the programmatic settings files.

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

Auto Collapse timer

mdAutoCollapseTimer

Integer

Display duration, in milliseconds, for the panel before automatically collapsing. Setting this variable to 0 deactivates the auto collapse.

7000

Cancel Auto Collapse On User Interaction

mdInteractionsCancelAutoCollapse

Boolean

Determines whether to cancel auto collapse for the panel when the user interacts with the ad's contents. Available options are:

  • Yes: Cancels auto collapse for the panel when the user interacts with the ad's contents.

  • No: Always auto collapses the panel regardless of whether the user interacts with the ad's contents.

Yes

Preload Script

String

Script file needed to load before ad execution.

PL_Interstitial.js

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

Comments