Create a new CreativeGroup.

Create a new CreativeGroup of the Product.

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

The AdAccount ID to which the CreativeGroup belongs to.

string
required

The Product ID to which the CreativeGroup belongs to.

Body Params

The CreativeGroup data to be created.

CreativeGroup is a group of Creatives that may serve with the same purpose, to be referenced by a Campaign.

string

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

string
required

A descriptive name of the CreativeGroup.

string

An optional description about this CreativeGroup.

string
enum
Defaults to UNSPECIFIED

Whether this CreativeGroup is enabled by the AdAccount. If this field is unset or set to UNSPECIFIED, the server will change it to ENABLED automatically by default.

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

Allowed:
creative_ids
array of strings

List of Creative ids in this CreativeGroup.

creative_ids
string
enum
Defaults to UNKNOWN_STATUS

The current status of the CreativeGroup. This state is readonly to the client after it gets into a SUBMITTED state.

When a new CreativeGroup is created, it will be created in "SUBMITTED" state by default and it requires all the validations to pass. However, the client can specify "DRAFT" as the state in the creation request to request the CreativeGroup be saved as a draft without mandating all the required data. But any user entered data still need to pass their own validation individually for them to be accepted by the Moloco Ads backend.

The client can switch a "DRAFT" Creative to "SUBMITTED" by specifying "SUBMITTED" as the state value in an update request later after all required data are entered, and full validation will be invoked on this state switch.

After a CreativeGroup gets out of the DRAFT state, the state will be fully managed by the Moloco Ads backend and the state value will become readonly to the client. Any state value specified by the client in the future update requests will be ignored.

Allowed:
string
string

CreativeGroup specific landing URL. Optional for CreativeGroup which has WEB type Product, not allowed for APP type Product.

string

CreativeGroup specific final landing URL. Optional for CreativeGroup which has WEB type Product, not allowed for APP type Product. Deprecated. v1.3 would be the last version supporting this field. Use landing_url field instead.

string

Name of the mmp side reporting tag. mmp_tag should be URL-safe string.

audience
object

Creative group level audience.

feature
object

CreativeFeature and its configuration.

date-time

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

publisher_properties
object
Responses

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