Assets are files that can be used in various advertising formats, such as expandable, floating, or video ads. Assets can include different types of files, like audio, fonts, images, video, generic, or HTML and XML files.
Tip
For more information about assets, see Manage Assets.
You can create assets and use them to build different types of ads.
With Assets API, you can manage assets based on their type. Each asset type has its own dedicated API endpoints within Assets API. Depending on the asset type, you can create new assets, rename, retrieve, or delete them. You can also update asset files. In addition to managing assets by specific types, the Assets API provides sections for operations that apply to all assets, regardless of their type.
|
Asset Type |
Supported Files |
|---|---|
|
Image |
.gif, .jpe, .jpeg (.jpg), .png, .bmp |
|
Video |
.mp4, .webm, .ogv, .wmv, .mov, .mpg, .mpeg, .3gp, .m4v, .mkv |
|
XML |
.xml |
|
Audio |
.mp3, .wav, .ogg, .flac, .wma, .gsm |
|
Fonts |
.tff, .eot, .woff, .woff2, .otf |
|
Generic |
.xls, .xlsx, .obj |
|
HTML |
.zip (for the compressed files) |
To authenticate and use Adform APIs, your user account must have the necessary permissions and your OAuth client must have the required scopes assigned to it.
To create an asset, Adform DSP and Ad Server user account must have this permission assigned by the business account admin:
-
Manage Assets & Banners
You also need the following scope assigned to your OAuth client by Adform Support (technical@adform.com):
-
https://api.adform.com/scope/eapi: Grants access to Assets API.
Note
If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.
To create an asset with API, you must use the following IDs in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the advertiser to which the campaign belongs |
Note
Additional IDs might be used, but the listed one is required to pass a request.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To create an asset with API, use these endpoints:
-
POST endpoints in AudioAssets, FontAssets, GenericAssets, HtmlAssets, ImageAssets, VideoAssets, XmlAssets sections in Assets API: To create assets for your ads.
Once you have the assets created, you can use them to create ads.
[{"api":"Assets","titles":"AssetFiles, Assets, AudioAssets, FontAssets, GenericAssets, HtmlAssets, ImageAssets, OperationResults, Package, VideoAssets, XmlAssets"}]