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 will be disabled.

Follow
  • Creative > Assets Library

Amazon Ad Server (AAS) supports two ways to manage creative assets:

  • Uploading the assets as a part of workspace

  • Adding the files as additional assets in your ads

Additional assets are useful when an ad contains dynamic elements for Dynamic Creative Optimization (DCO); it is recommended to store all images and videos as additional assets. A best practice to keep your workspace optimized is to include essential files such as the .config file, default image, and HTML file in your workspace, and store all other files in separate folders, but in the same directory as your Workspace.

Additional assets can be any file that a browser can display, such as images, videos, CSS, JavaScript, JSON, XML, or font files. A ad can have up to 100 additional assets.

Adding additional assets

Procedure

Note

Note: Before you begin, locate the assets and workspace that you want to use.

  1. Select Creative > Assets Library.

  2. Click Upload to upload your workspace and assets.

  3. Create a new ad.

  4. In the Creative Assets section, select the Main Assets tab and define the workspace folder and default image.

  5. In the Creative Assets section, select the Additional Assets tab.

  6. Click Add Asset.

  7. Navigate to the folder where your assets are located.

  8. Select a file to add as an additional asset.

  9. Click Assign.

additionalAssets_panel.png

Calculating size for ads with additional assets

K-weight of ads are defined based on its workspace. When the ad has additional assets, those assets are also counted as a part of K-weight. AAS picks up the largest file among the additional assets and then combines its weight to the K-weight of the workspace. If the selected asset is a video and larger than any videos in the workspace, the video will be defined as the largest video in the workspace when K-weight is calculated. If additional assets are stored in a workspace, the total K-weight of all assets will count against the weight of the ad.

Ad Type

Ad Size Calculation

Regular ads with no videos

The size of the workspace and the largest additional asset.

Rich Media ads with a video

All of the non-video assets plus the largest video in the workspace. If there are additional assets, and one of them is larger than the largest workspace video, it will replace the video in the workspace.

DCO ads

The sum of the non-video assets plus the largest video in the workspace.

Methods for additional assets

EB.getAssetProps(local Path, asset ID):Object

Returns an object with information about the asset. In local mode (before uploading), it will return null.

//returns information about the asset assigned with id No.1 as Additional Assets
var assetProps = EB.getAssetProps("",1);
  
//Get the width and height of the asset:
var assetWidth = assetProps.width;
var assetHeight = assetProps.height;

Parameters

Name

Type

Description

localPath

String

Path of the file relative to your ad's main index.html. For additional assets, this parameter should be empty.

assetID

Integer

ID of the additional asset file in AAS.

Return object properties

Name

Type

Description

assetID

Number

Unique ID for the asset in AAS.

bitRate

Number

Bitrate of videos. Value is -1 where bitRate does not apply.

dsPath

String

Relative path to the asset in AAS.

height

Number

Height of the asset, if relevant.

width

Number

Width of the asset, if relevant.

ordinalNum

Number

ID of the file in the additional assets list. Value is 0 for workspace assets.

type

Number

EB.getAssetUrl(reference of asset location, asset id):String

Returns the absolute URL of the asset. Returns an empty string if the asset was not located.

//returns absolute path of the asset assigned with id No.1 as Additional Assets
var imagePath = EB.getAssetUrl("",1);
  
// put the url in ‘image1’ element
document.getElementById('image1').setAttribute('src', imagePath);

Parameters

Name

Type

Description

Reference of asset location

String

File name or URL of the asset to search. This parameter is ignored when the second parameter contains IDs of additional assets.

assetID

String

ID of the additional asset file in AAS.

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

Comments