Create Asset File

Asset files contain information needed by creatives.

Please refer to Video Asset File Guide for more information about creating asset files for video creatives.

See request examples.

Asset file types

List of asset files and where they are used as well as parameters type and subtype:

typesubtypeParam where located contentUsed in Creatives
imageurlImage, Video (End Card), Native
htmlurlHTML, Video (End Card)
videouploadurlVideo (by using uploaded video file)
videovast_codesourceVideo (your own VAST code)
videovast_urlurlVideo (Vast code located at url)

Required fields for Image asset files

  • type - must be image
  • name
  • url
  • width
  • height
  • mime (e.g image/jpeg for .jpg, image/png for .png)
  • size_bytes

Image asset files can be used to create Image Create, as Video Creative End Card, Native Creative

Required fields for HTML asset files

  • type - must be html
  • name
  • url - url to html code

HTML asset files can be used to create HTML Creative, Video End Card.

Required fields for Video asset files

There are 3 kinds of Video asset files:

  • upload - Vast XML is generated based on the uploaded video file. See File Upload.
  • vast_code - Asset file is created by given Vast XML code. Should contain MediaFile tag in Vast XML.
  • vast_url - Vast XML code is located at the given url. Should contain MediaFile tag in Vast XML.

Required fields for Video Upload asset files

  • type - must be video
  • subtype - must be upload
  • name
  • url - url to uploaded file by using our upload API.
  • duration
  • mime - mime time of video file, eg. video/mp4
  • size_bytes
  • width
  • height

width, height, duration, mime are required params to create correct MediaFile in Vast.

Required fields for Video Vast Code asset files

  • type - must be video
  • subtype - must be vast_code
  • name
  • source - Vast XML code of asset file.

Required fields for Video URL Code asset files

  • type - must be video
  • subtype - must be vast_url
  • name
  • url - url to Vast XML. It should be accessible by url.
Language
Authorization
OAuth2
Click Try It! to start a request and see the response here!