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.


If you used a third-party authoring tool, such as a code editor or Adobe Animate to build your simple skin, proceed to set up your ad in Amazon Ad Server (AAS).


Note: If you used Ad Builder to build your simple skin, this setup is not required and you can proceed to sharing your ad. For more information, see Share your ads.


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.


Note: Naming the workspace and the default image are especially useful when using the ad wizard tool to bulk upload your work; the Ad Name field and the Default field will be filled in automatically. For more information, see Set up multiple ads using Ad Creation Wizard.

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 you uploaded.

Upload your ad

  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

  1. Select Creative > Ads.

  2. Click New Ad > Blank Ad.

  3. Give your ad a meaningful name.

  4. In the Ad Format list, select simple skin.

  5. In the Creative Assets > Main Assets tab:

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


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

    2. Select the default image.

  6. If you included and filled the config.js file according to the build guide in Create a simple skin in a code editor, all settings will be entered for you. You can change any pre-entered settings as you find appropriate.

  7. Add the following panels to the Panels List:

    1. Add left gutter panel, set panel name as leftGutter and select index.html from panels/left_gutter folder. Set position type to Page Relative-Pixels and Auto retract to Never.

    2. Add right gutter panel, set panel name as rightGutter and select index.html from panels/right_gutter folder. Set position type to Page Relative-Pixels and Auto retract to Never.

    3. Add header panel (optional), set panel name as header and select index.html from panels/header folder. Set position type to Page Relative-Pixels and Auto retract to Never.

    4. Uncheck Show single panel at a time.

  8. Click on Additional Assets to add an image for each panel (ID:1 for the Header, ID:2 for the LeftGutter, ID:3 for the RightGutter).

  9. In the Settings section, under Advanced Features, customize the variables according to your needs, and the needs of your publishers.

  10. Click Save.

  11. (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.

Setting up multiple ads

You can upload and set up multiple ads in a single process using the Ad Creation Wizard. For more information, see Set up multiple ads using Ad Creation Wizard.

Previewing and testing

After you finish creating your ad, make sure that you preview and test it. For more information, see Preview ads in the Amazon Ad Server and Test your ads.

Additional information

Loading modes

You can set your simple skin 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 simple skin format is an HTML5 custom format; therefore, there is no need to attach a custom script. The appropriate custom script will be pulled in automatically. This is shown as the auto-populated value PL_ImmersiveTakeover.js for the Preload Script custom variable. For reference, the following custom script is being used:

Known limitations

  • It is not possible to use "fixed" property on the background when you use mdPageBackground variable or the mediaQueries option or changePageBackground function on iPad and iPhone. "Fixed" will be changed to "scroll" only for iPad and iPhone devices.

  • AAS preview is not very precise and you only will see the basic behavior of the format.

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