Create Creative

The ID of the Advertiser.

The ad size's ID. More info here.

Specifies whether creative is eligible to serve.

A short description of creative (in UI, it is called 'Friendly Name'). Max 500 characters.

The file name as it is stored in our database. It is not needed to create a creative, but it will be passed back in the result view. If the string is manually entered, it will result in a null string.

This is the body text associated with AdType 1 (in UI it's called "Text"). If AdType1 is not being used, pass an empty string: "".

The click URL. Max length is 2000 characters. Must not contain leading or trailing spaces.

Alt text. The maximum length is 500 characters after HTML-encoding the value.

Specifies whether creative is deleted.

Specifies whether to override image with HTML or JavaScript ad. If true = the ScriptBody field should have value.

If IsHTMLJS = true, then this field needs to be filled with a HTML/JavaScript ad.

Adds custom metadata to your creative. Note that this should be a JSON object in a string, for example: { ... "Metadata": "{ \"foo\":1234 }" } The entire Metadata string must be url encoded to support URLs and special characters that can break the JSON object. Maximum character limit of 1000 characters.

The URL of an image hosted remotely. Use if you are serving an image file without uploading it to Kevel's CDN or calling it in the ScriptBody

If set to true, this allows you to save or update a creative that contains no ScriptBody or Metadata. Note that SaveEmptyCreative is not a database field on the creative object, but is instead an option when creating or updating creatives. This means that the SaveEmptyCreative parameter will always be returned as null once a creative has been created.

Indicates that a creative originating from a third-party (i.e. it uses third-party ad tags) is EFF Do Not Track compliant. Can only be used if DNT is enabled for your account.

Indicates that a creative originates from a third-party source (such as an ad network) that will serve multiple ads. (BETA)

If you are using a creative template, specifies which template to use. IDs can be retrieved from the Creative Template API.

If you are using a creative template, sets the values for the fields in the creative. Fields must match the TemplateId and the object must be wrapped in a string. For example: "{\"ctString\":\"A string goes here\",\"ctExternalFile\":\"http://cdn.com/ad.gif\"}"