get
https://sandbox-api.viantinc.com/{basePath}/campaign//creatives
Get Creatives for a Campaign
Request
GET /campaign/<campaign ID>/creatives
Response
| JSON Fields | Type | Description |
|---|---|---|
| messages | Object Array | An array of any error messages. |
| messages[].level | String | Error level. |
| messages[].code | String | Error code. |
| messages[].message | String | Error message. |
| entity | Object Array | An array of creative objects. |
| entity[].id | Number | Creative ID. |
| entity[].status | String | Status of the creative. It can be one of the following values:
|
| entity[].name | String | Creative name. |
| entity[].type | Object | |
| entity[].type.id | Number | Creative type ID as shown in the UI. |
| entity[].type.vendor | String | Creative type vendor as shown in the UI. |
| entity[].type.mediaType | String | Can be one of the following values:
|
| entity[].type.videoType | String |
Will be null for non-video creative types. Can be on of the following values:
|
| entity[].externalCreativeid | String | |
| entity[].crawlableUrl | String | Crawlable URL for what the creative is advertising. |
| entity[].landingPageUrl | String | Clickthrough URL. May not be final destination. |
| entity[].impressionTrackingPixel_1 | String | URL of first tracking pixel. |
| entity[].impressionTrackingPixel_2 | String | URL of second tracking pixel. |
| entity[].impressionTrackingPixel_3 | String | URL of third tracking pixel. |
| entity[].impressionTrackingPixel_4 | String | URL of fourth tracking pixel. |
| entity[].size | Object | |
| entity[].size.width | Number | Width of creative (if applicable). |
| entity[].size.height | Number | Height of creative (if applicable). |
| entity[].channels | String Array | Channels selected:
|
| entity[].adTagId | String | AdTag identifier. Varies by vendor. Only for AdTag creatives. |
| entity[].duration | Number | Creative duration in seconds (video creatives only). |
| entity[].bitRate | Number | Bitrate of creative (video creatives only). |
Example
Request to get creatives
curl -u <user>:<password> https://sandbox-api.viant.com/v1/campaign/91/creatives
Response
{
"messages":[],
"entity":
[
{
"id":662692,
"name":"Viant Creative 300x250.gif",
"type":
{ "id":1,
"vendor":"Generic",
"mediaType":"BANNER",
"videoType":null
},
"status":"APPROVED"
"externalCreativeid": null,
"crawlableUrl": null,
"impressionTrackingPixel_1": null,
"impressionTrackingPixel_2": null,
"impressionTrackingPixel_3": null,
"impressionTrackingPixel_4": null,
"size": {
"width": 300,
"height": 250
},
"channels": [
"MOBILE"
],
"landingPageUrl": null,
"adTagId": null,
"duration": null,
"bitRate": null
}
]
}