ADNUNTIUS
Search…
/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:
1
GET https://api.adnuntius.com/api/v1/adunits?context=<context>
Copied!
in order to see HIDDEN objects you will need to send includeHidden=true as a parameter to the GET query

POST

Example POST object:
1
{
2
"objectState": "ACTIVE",
3
"name": "demo.adnuntius.com - 980x240 - Panorama 02",
4
"site": { "id": "6vjwynnz2ptrvdcc" },
5
"floorPrice": {
6
"currency": "NOK",
7
"amount": 1}
8
"labels": [
9
"Label1",
10
"Label2"
11
],
12
"matchingLabels": [
13
"Label1",
14
"Label2"
15
],
16
"width": 980,
17
"height": 600,
18
"notes": [
19
{ "id": "qjv2dkfctxlrmcdp" }
20
],
21
"minWidth": 0,
22
"minHeight": 120,
23
"pageSize": 1,
24
"urlAsCategory": true,
25
"sspConfigurations": [
26
{
27
"sspConnection": { "id": "xxxxxxxxxxxxxxxx" },
28
"enabled": true,
29
"sspAdUnitId": "123456",
30
"sspSiteId": "123456",
31
"sspAdType": "MIXED",
32
"width": 980,
33
"height": 360
34
}
35
]
36
},
Copied!
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
Last modified 6mo ago