Build your own campaign manager

If you have UI requirements specific to your business/application domain, you can build a custom campaign manager application on top of Moloco’s Management API. The management API allows you to perform ad campaign-related operations such as creating/updating ad campaigns and pulling report data for campaigns.

Prerequisites

The Management API requires authentication, please review the Management API usage page for information on generating an authorization token to programmatically access the API. This token will be used to perform management operations.

Example workflow for creating a new campaign

🚧

Limitations

The MCM Management API does not provide the following features:

• End-user authentication, authorization, and management: Please use your existing Single Sign On solution to implement these features.
• Notifications: Customers must handle their own user notifications
• Change History: The changed by field cannot be personalized. This field will only display the platform admin user account.

Creative Uploading Methods for Sponsored Banner Campaigns

We provide two ways to upload creatives:

• Upload by File: Using Moloco’s CDN solution
• Upload by CDN URL: Using your own CDN solution.

🚧

Use multipart/form-data Content-type to support sending both File and JSON when making CreateCreative and UpdateCreative API requests. Do not use application/json

Supported image formats

• JPG/JPEG
• PNG
• GIF

Image File Size

✏️

Maximum image file size is configurable at the platform level, if you require a larger image file size or additional image formats please contact your Moloco representative.

Option 1: Upload by File

There are two keys named file, and creative.

• The file must be uploaded in the key namedfile. If the key file is not used, the request will fail to parse the upload properly.
• The creative asset’s metadata must be included as json value in the key named creative. There are additional fields for the request, such as ad_account_id, title, and type (IMAGE). See the CreateCreative API reference for more details.

Option 2: Upload by CDN URL

When using your own CDN solution, use only the creative key with JSON format.

🚧

Use only one option when uploading creatives: either file or creative.image_source (json content). These methods cannot be used together in the same request.

Include the fields: ad_account_id, title, type(IMAGE), and most importantly image_source. The image_source field should contain the image's CDN URL. See the CreateCreative API reference for more details.

{
  "ad_account_id": "test_ad_account",
  "title": "test_title",
  "type": "IMAGE",
  "image_source": {
    "url": "https://storage.googleapis.com/rmp-cdn-test/platform/MOLOCO_PORTAL_DEMO/images/lalrq0mi_xys1xwo.jpeg",
    "size": 40000,
    "width": 200,
    "height": 200,
    "file_name": "test_filename" 
  }
}