/adunits

GET

A GET request can always be filtered by the get parameters defined in the introduction section of the api documentation.

Example GET request:

GET https://api.adnuntius.com/api/v1/adunits?context=<context>

in order to see HIDDEN objects you will need to send includeHidden=true as a parameter to the GET query

POST

Example POST object:

{
"objectState": "ACTIVE",
"name": "demo.adnuntius.com - 980x240 - Panorama 02",
"site": { "id": "6vjwynnz2ptrvdcc" },
"floorPrice": {
"currency": "NOK",
"amount": 1}
"labels": [
"Label1",
"Label2"
],
"matchingLabels": [
"Label1",
"Label2"
],
"width": 980,
"height": 600,
"notes": [
{ "id": "qjv2dkfctxlrmcdp" }
],
"minWidth": 0,
"minHeight": 120,
"pageSize": 1,
"urlAsCategory": true,
"sspConfigurations": [
{
"sspConnection": { "id": "xxxxxxxxxxxxxxxx" },
"enabled": true,
"sspAdUnitId": "123456",
"sspSiteId": "123456",
"sspAdType": "MIXED",
"width": 980,
"height": 360
}
]
},

Name

Required

Restriction

Description

objectState

​

ACTIVE, INACTIVE, HIDDEN (String)

State of the object, will disable or delete the object.

name

Yes

String

The name of the site group

site

​

Object

An object with a Key id for the id of the site that the ad unit is a belonging to.

floorPrice

​

Object

Specify the floor price of the ad unit. It has to be an object containing a currency and the amount.

labels

​

Array

For searching purposes.

matchingLabels

​

Array

Labels used for line item targeting.

width

​

Number

The maximum width of the ad unit.

height

​

Number

The maximum height of the ad unit.

notes

​

Array

An array of objects with a Key id for the id of the note to be bound to the ad unit.

minWidth

​

Number

The minimum width of the ad unit.

minHeight

​

Number

The minimum height of the ad unit.

pageSize

​

Number

Number of ads that can be shown imultaniously in the adunit.

sspConfigurations

​

Array

Array of objects listed below.

If pageSize is set to 2 or higher, the adunit will fill ads from the bottom first and never left to right. Ex: if you trying to fill an ad unit with two creatives of the size 300 x 250, you will have to st the min width to 300, max width 300. Min height 250, max height 500. it will not work if you set the height to 250 and maximum width to 600. Read more here.​

sspConfigurations object

Name

Required

Restriction

Description

sspConnection

yes

Object

An array of objects with a Key id for the id of the note to be bound to the ad unit.

enabled

yes

Boolean

Can disable the SSP connection if set to false.

sspAdUnitId

yes

String

Defines the ad unit id that is set in the SSP.

sspSiteId

yes

String

Defines the site id that is set in the SSP.

sspAdType

yes

HTML, TEXT, VIDEO, FLASH, IMAGE, MIXED (String)

Defines what type of content that is accepted from the bid request.

width

yes

Number

Width of the creative that will be collected from the SSP

height

yes

Number

Height of the creative that will be collected from the SSP