post https://api.kayzen.io/v1/asset_files
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
:
type | subtype | Param where located content | Used in Creatives |
---|---|---|---|
image | url | Image, Video (End Card), Native | |
html | url | HTML, Video (End Card) | |
video | upload | url | Video (by using uploaded video file) |
video | vast_code | source | Video (your own VAST code) |
video | vast_url | url | Video (Vast code located at url) |
Required fields for Image asset files
type
- must beimage
name
url
width
height
mime
(e.gimage/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 behtml
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 containMediaFile
tag in Vast XML.vast_url
- Vast XML code is located at the given url. Should containMediaFile
tag in Vast XML.
Required fields for Video Upload asset files
type
- must bevideo
subtype
- must beupload
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.
Video Asset files larger than 10MB will be compressed. You cannot use the asset file to create a creative until it has been compressed.
Required fields for Video Vast Code asset files
type
- must bevideo
subtype
- must bevast_code
name
source
- Vast XML code of asset file.
Required fields for Video URL Code asset files
type
- must bevideo
subtype
- must bevast_url
name
url
- url to Vast XML. It should be accessible by url.