Create a new Creative.

Create a new creative of the product. One and only one of the sources must be specified for the Creative.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

The AdAccount ID which the Creative belongs to.

string
required

The Product ID which the Creative belongs to.

Body Params

The Creative to create.

Creative contains all data and assets required to visually render an ad.

One and only one of the sources must be specified for the Creative.

string

Unique identifier of the Creative. Automatically set by server on creation.

string
required

A descriptive name of the Creative.

string
enum
Defaults to UNSPECIFIED

Whether this Creative is enabled by the AdAccount.

If the value of this field is unset or set to UNSPECIFIED in the Creative creation request, it will be set to ENABLED by default by the server.

A disabled Creative will still get reviewed, but won't be served automatically after approval.

An active serving Creative can be paused at any time by setting this field to DISABLED.

Allowed:
string
enum
Defaults to UNKNOWN_TYPE

Type of the Creative.

string
required

Original Creative filename given by user.

int64

Estimated size of the Creative in bytes.

custom_key_values
object

Custom key/values managed by the Moloco Ads client platform. It's up to the client ads platform to define the schema for the values and their optionality.

The keys are recommended, but not required, to be prefixed with the reversed internet domain of the AdCloud client platform company. For example, keys defined by the client ads platform company "example.com" should have "com.example." as the prefix.

For complex values, JSON payload is recommended.

Moloco doesn't interpret these data in any way for ads serving. Upon serving, the custom key/values in the AdAccount, Campaign, and Creative models will be combined into the serving Creative proto in the order of precedence, with Creative's value having the highest precedence on the same key.

image
object

Source of image Creative.

Supported formats: JPEG, PNG, GIF. Maximum file size: 500KB (5MB for GIF).

Banner dimensions:

  • 100x21, 300x50, 300x100, 320x48, 320x50, 320x100
  • 360x56, 375x50, 375x59, 392x61, 411x64, 414x50, 414x65, 468x60
  • 481x56, 640x100, 640x200, 667x56, 711x88, 800x50
  • 970x250, 994x250, 1029x258

Full screen dimensions:

  • 300x600, 320x416, 320x480, 320x568, 360x592, 360x604, 360x640
  • 360x718, 360x724, 360x728, 375x667, 384x787, 412x790, 414x736
  • 428x846, 480x320, 640x360

Medium dimensions:

  • 160x600, 200x200, 250x250, 300x250, 320x240, 320x267, 336x280, 600x500

Tablet dimensions:

  • 728x90, 768x1024, 1024x90, 1024x768, 1280x90
video
object

Source of video Creative.

Supported format: MP4. Maximum file size: 300MB (before transcoding). At least one of width or height must be ≥ 640px. Duration: 6–180 seconds.

vast_video
object

Source of VAST (Video Ad Serving Template) video Creative.

native
object

Source of native Creative.

custom_html
object

(Will be supported soon) Creative source based on custom html.

template_html
object

(Will be supported soon) Creative source based on MRAID template.

rich_custom_html
object

Creative source based on arbitrary HTML. An instance of this is typically used for a playable Creative from AdAccounts. You can create RichCustomHtmlSrc by one of two methods:

  1. Upload FB style html file using CreateAssetUploadSession API(PLAYABLE_AD_SOURCE_TYPE_URL)
  2. Use Creative template third parties: tresensa or spaceback(PLAYABLE_AD_SOURCE_TYPE_TAG).
dynamic_html
object

(Will be supported soon) Dynamic Creative. An instance of this would be used for Creatives to be rendered when the Creative is shown to user, i.e. an impression takes place, unlike bid-time rendering for static images.

string
enum
Defaults to UNKNOWN_CREATIVE_FEATURE_TYPE

CreativeFeatureType.

Allowed:
string

Creator tag to identify who is the resource creator.

date-time

Last updated time. Should not modify on the client side.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json