The terms creative components and native components may be used interchangeably. The front part of the endpoint is:
QA API Base: https://t1qa1.mediamath.com/component_creatives/v1.0/ (or whichever QA server is being used)
Prod API Base: https://t1.mediamath.com/component_creatives/v1.0
Component Creatives are uploaded in the "Creatives Tab" within the Creatives Module, and is where creatives for native campaigns are uploaded.
curl -i -X GET \
'https://apidocs.mediamath.com/_mock/apis/component-creatives/component_creatives/v1.0/creatives?advertiser_id=0&page_limit=20&page_offset=0&sort_by=atomic_creative_id&status=1'{ "data": [ { … }, { … } ], "meta": { "code": 200, "count": 2, "next_page": "http://component-creative-api.prod.cbe.mediamath.com/v1.0/creatives?page_offset=2&page_limit=2", "offset": 0, "status": "success", "total_count": 864, "type": "creatives" } }
curl -i -X POST \
https://apidocs.mediamath.com/_mock/apis/component-creatives/component_creatives/v1.0/creatives \
-H 'Content-Type: application/json'{ "data": { "advertiser_id": 100178, "advertiser_name": "Brooklyn Bubblegum Co.", "assets": [ … ], "atomic_creative_id": 3200795, "created_at": "2016-11-17T17:29:39.607Z", "creative_id": 261, "creative_name": "test creative", "end_date": "2016-11-30T00:00:00", "external_identifier": "NA", "last_modified": "2016-11-17T17:30:55", "last_published": "2016-11-17T17:29:39.607Z", "start_date": "2016-09-30T00:00:00", "status": "1", "unpublished": false, "updated_at": "2016-11-17T17:29:39.607Z" }, "meta": { "code": 201, "status": "created", "type": "creative" } }
curl -i -X GET \
https://apidocs.mediamath.com/_mock/apis/component-creatives/component_creatives/v1.0/versioncurl -i -X GET \
'https://apidocs.mediamath.com/_mock/apis/component-creatives/component_creatives/v1.0/approvals?atomic_creative_ids=string'{ "data": [ { … }, { … }, { … } ], "meta": { "code": 200, "status": "success", "type": "approvals" } }
Note about image assets:
Base64 encoded image assets can be uploaded via this endpoint. This new image asset is represented in the assets param as an object containing an encoded_image_file and image_name properties. Example assets: "[{"encoded_image_file": base64_data_here, "image_filename":"logo.png"}]"
Note about subtitle assets:
Base64 encoded subtitle assets can be uploaded via this endpoint. This new subtitle asset is represented in the assets param as an object containing an encoded_subtitle_file and subtitle_filename properties. Example assets: "[{"encoded_subtitle_file": base64_data_here, "subtitle_filename":"test.srt"}]"
Header should be of format: Cookie: adama_session={adama_session}
See below
curl -i -X POST \
https://apidocs.mediamath.com/_mock/apis/component-creatives/component_creatives/v1.0/approvals \
-H 'Content-Type: application/json' \
-H 'adama_session: string'{ "data": { "advertiser_id": 100178, "advertiser_name": "Brooklyn Bubblegum Co.", "assets": [ … ], "atomic_creative_id": 3200795, "created_at": "2016-11-17T17:29:39.607Z", "creative_id": 261, "creative_name": "test creative", "end_date": "2016-11-30T00:00:00", "external_identifier": "NA", "fb_status": "UNKNOWN", "last_modified": "2016-11-17T17:30:55", "start_date": "2016-09-30T00:00:00", "status": "1", "updated_at": "2016-11-17T17:29:39.607Z" }, "meta": { "code": 201, "status": "created", "type": "creative" } }
curl -i -X GET \
'https://apidocs.mediamath.com/_mock/apis/component-creatives/component_creatives/v1.0/creatives/{atomic_creative_id}/eligibility'{ "data": [ { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … }, { … } ], "meta": { "code": 200, "status": "success", "type": "creative_eligibility" } }