Build your own campaign manager

If you have UI/UX 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.

Prerequisites

The Management API requires an API key, please review the API Key and SSO credential management guide for information on generating an API key to programmatically access the API. This API key will be used to perform all management operations.

Limitations

End-user authentication, authorization, and management:

• Please use your existing Single Sign On solution to implement these features.

Notifications:

• Platform owners must handle their own user notifications.

Change History:

• The changed by field cannot be personalized. This field will only display the System 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
• WEBP

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.

{
  "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" 
  }
}