Ad Assets

You can create and manage additional ad assets, like carousel cards, using these fields.

Fields

The following fields are available for creating and managing ad assets:

Name

Description

Type

Add

Update

Ad ID

The ID of the ad associated with the asset.

long

required

optional

Object ID

The ID of the ad asset.

long

N/A

required

Title

Title text used for the ad asset. Maximum limit is 50 characters. Use {city}, {state}, {state_abbr}, {country} and {country_abbr} macros to add geo locations for user personalized ads. Use the {time} macro for flash sale ads.

string

Required for carousel card assets. Ignored for tile assets.

optional

Description

Description text displayed when your ad asset appears in content streams or in the other eligible native ad positions. Maximum 150 characters. Use {city}, {state}, {state_abbr}, {country} and {country_abbr} macros to add geo locations for user personalized ads. Use the {time} macro for flash sale ads.

string

Required for carousel card assets. Ignored for tile assets.

optional

Ad Image URL

For carousel card asset, a valid URL for a square image. The ideal image size is 627x627; smaller images will not be accepted. Larger images with either the same aspect ratio or with a height and width that are off the ideal dimensions by up to a combined 10% will be accepted and automatically cropped at the center.The maximum size is 7MB.

string

Required for carousel card assets. Ignored for tile assets.

optional

Ad HQ Image URL

For a carousel asset, a valid URL to a high resolution image that will be used. The ideal image size is 1200x627; smaller images will not be accepted. Larger images with either the same aspect ratio or with a height and width that are off the ideal dimensions by up to a combined 10% will be accepted and automatically cropped at the center. The maximum file size is 7MB.

string

Required for carousel card assets. Ignored for tile assets.

optional

Fixed position

The position of the tile asset. Supported for button tile asset only. Values are:
  • NONE

  • BOTTOM (snap globally to bottom. Only one button asset can have this setting for entire tiles ad)

enum

Optional. Default: NONE. Applicable for button tiles only.

optional

Fit to Height

Whether to fit the image tile asset to height (true) or width (false).

boolean

Optional. Default: FALSE (i.e., fit to width). Applicable for image tile only.

optional

Status

The status of the ad asset. Valid values are:
  • Active

Ad assets are defaulted to Active if no status is provided upon creation.

enum

optional

optional

Ad Primary Video URL

For carousel card asset, a valid video URL.

  • Format: .mp4, .mp4v or .mov

  • Max File Size: 1GB

  • Min video length: 5sec

  • Max video length: 30sec (for App Install), 5min otherwise.

  • Min video quality: 480p 500kbps.

  • Min audio quality: If the video has audio, then it must have 2 channel stereo 64kbps.

string

Optional for carousel card assets. Ignored for tile assets.

optional

Ad Asset URL

For image tile asset, a valid image URL. Minimum size is 200x200. Maximum size is 2MB. For video tile asset, a valid video URL.
  • Format: .mp4, .mp4v or .mov

  • Max File Size: 1GB

  • Min video length: 5sec

  • Max video length: 5min

  • Min video quality: 480p 500kbps.

  • Min audio quality: If the video has audio, then it must have 2 channel stereo 64kbps.

For text tile asset, a valid HTML URL. Maximum number of embedded links (hrefs) in the HTML is 3. Whitelisted HTML tags:
  • <a>

  • <br>

  • <div>

  • <p>

  • <section>

  • <span>

  • <strong>

  • <b>

  • <i>

  • <button>

Whitelisted CSS attributes
  • color

  • background-color

  • padding

  • padding-bottom

  • padding-left

  • padding-right

  • padding-top

  • text-align

  • font-family

  • font-size

  • font-style

  • font-weight

  • text-decoration

  • outline

  • outline-color

  • line-height

For button tile asset, a valid HTML URL. No embedded links (hrefs) allowed. Whitelisted HTML tags:

  • <a>

  • <br>

  • <div>

  • <em>

  • <p>

  • <section>

  • <span>

  • <strong>

  • <b>

  • <i>

Whitelisted CSS attributes
  • color

  • background-color

  • padding

  • padding-bottom

  • padding-left

  • padding-right

  • padding-top

  • text-align

  • font-family

  • font-size

  • font-style

  • font-weight

  • text-decoration

  • outline

  • outline-color

  • line-height

string

Required for tile assets. Ignored for carousel card assets.

Video Caption URL

Optional video caption file url to accompany the video url provided for carousel or video tile assets. Maximum url length is 1024 characters. The technical requirements for captions are:
  • Format: .vtt or .srt
    • Maximum File Size: 1MB

    • Maximum 3 lines of text per caption time entry/stamp in the file.

string

Applicable for carousel card or video tile assets.

optional

Video Autoloop

Optional video autoloop flag to accompany the video url provided for carousel or video tile assets.

boolean

optional. Default:false

optional

Call To Action Text

Call to action buttons used to help drive users to take specific actions. The supported call-to-action text values are same as ones defined for Ads

enum

Optional. Not applicable for tile assets.”

optional

Match Type

The type of ad asset. Valid values are:
  • MULTI_IMAGE (carousel card)

  • TILES_IMAGE

  • TILES_VIDEO

  • TILES_TEXT

  • TILES_BUTTON

  • DCO

enum

required

optional

Index

Horizontal index ordering of assets. For carousel assets (type=MULTI_IMAGE) the values must be unique for every active asset and must be between 0 and 4. Minimum 3 assets are required for carousel ad.

For tile assets the pair of horizontal index and vertical index values must be unique for every active asset. Horizontal index must be between 0 and 4. Minimum 3 assets are required for for horizontal tiles. 3-5 image or video tiles grouped with same horizontal index are considered one carousel grouped tile.

No more than 3 carousel grouped tiles per tiles ad. Only image and video tiles are allowed for carousel group.

For DCO (Dynamic Creative Optimization), you can choose 3 specific attributes - Title, Description, and Image - and three variants for each of those 3 attributes (a maximum of 27 combinations in all [3x3x3]). Note that you don’t have to use all 3 attributes included in DCO. For example, you can choose to set 3 options for the Title, 2 options for the Description, and 1 option for the Image. This will make DCO work with 6 ad combinations only (3x2x1).

integer

Required

optional

Vertical Index

Vertical index ordering of assets. Not applicable for carousel assets. For tile assets the pair of horizontal index and vertical index values must be unique for every active asset. Vertical index must be between 0 and 19. Minimum 1 asset are required for for vertical tiles. Maximum 20 total tiles.

integer

Required for tile assets. Ignored for carousel card assets.

optional

Landing URL

The landing URL associated with the asset. The landing URL is the web address that a user is sent to after clicking on the ad. Maximum limit is 2048 characters. The landing URL should include the tracking params provided by the tracking partner that was specified at the campaign level for app installs. Use {city}, {state}, {state_abbr}, {country} and {country_abbr} macros to add geo locations for user personalized carousel ads.

string

Required for carousel card assets. Optional for image and video tile assets. Not applicable for text tiles. Required for button tiles.

optional

Create a Tile Ad Asset

The following example contains the fields required for creating a tile ad asset. All other fields in this spreadsheet are blank and are not shown:

Action

Object Type

Ad ID

Ad Asset URL

Match Type

Index

Vertical Index

Add

Ad Asset

75614

www.imageurl.com

TILES_IMAGE

0

0