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. The maximum size is 2MB. 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 as well as will be automatically cropped at the center. The maximum file size is 2MB. 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
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.

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