ADNUNTIUS
Search…
/reachestimate
Reach estimates will tell you if a line item will be able to deliver or not as well as estimate the number of impressions it can get during the time it is active.

POST

Example POST object:
1
{
2
"targeting": {
3
"adUnitTarget": {
4
"adUnits": [],
5
"negated": false
6
},
7
"siteTarget": {
8
"sites": ["<site-ID>"],
9
"negated": false
10
},
11
"siteGroupTarget": {
12
"siteGroups": []
13
},
14
"userSegmentTargets": [],
15
"namedLocationTarget": {
16
"locations": [],
17
"negated": false
18
},
19
"deviceTargets": [],
20
"dateTarget": {
21
"dateRanges": [],
22
"timeZoneSetting": "USER"
23
},
24
"adUnitMatchingLabelTargets": [],
25
"categoryTargets": [],
26
"keywordTargets": [],
27
"keyValueTargets": [],
28
"retargetingTargets": [],
29
"dayPartingTargets": [],
30
"domainNameTarget": {
31
"names": [],
32
"negated": false
33
},
34
"ipAddressTarget": {
35
"addresses": []
36
}
37
},
38
"dimensions": [
39
[
40
980,
41
240
42
],
43
[
44
980,
45
120
46
]
47
],
48
"startDate": "2021-03-15T23:00:00.000Z",
49
"endDate": "2021-03-23T22:59:59.999Z",
50
"cpm": {
51
"currency": "NOK",
52
"amount": 100
53
},
54
"tier": "<tier-ID>"
55
}
Copied!
Name
Required
Restriction
Description
targeting
A list of targeting options to run your reach estimation against.
dimensions
Yes
Array
An array of size arrays of the sizes of the line item you wish to run a reach estimation for.
startDate
Yes
Date String
The start date of the reach estimate.
endDate
Yes
Date String
The end date for the reach estimate.
cpm
Yes
Array
The CPM price to use for the estimation.
tier
Yes
String
The id of the tier you wish to run the estimate against.

Example responses object.

1
{
2
"numSamples": 60449,
3
"matchedSamples": 0,
4
"totalTraffic": 1630297,
5
"reach": 0,
6
"reachUpperBound": 54,
7
"reachLowerBound": 0,
8
"competitors": {},
9
"uncontestedReach": 0,
10
"uncontestedReachUpperBound": 54,
11
"uncontestedReachLowerBound": 0,
12
"clickReach": 0,
13
"clickReachUpperBound": 54,
14
"clickReachLowerBound": 0,
15
"visibleReach": 0,
16
"visibleReachUpperBound": 54,
17
"visibleReachLowerBound": 0,
18
"viewableReach": 0,
19
"viewableReachUpperBound": 54,
20
"viewableReachLowerBound": 0,
21
"renderedReach": 0,
22
"renderedReachUpperBound": 54,
23
"renderedReachLowerBound": 0
24
}
Copied!
Name
Description
numSamples
Number of samples that were used to derive the reach estimate.
matchedSamples
Number of samples that matched the provided targeting
totalTraffic.
The maximum amount of traffic, regardless of targeting.
reach
The estimated number of impressions that the targeting will match.
reachUpperBound
An upper limit for the estimated number of impressions the targeting will match.
reachLowerBound
A lower limit for the estimated number of impressions the targeting will match.
competitors
A list of line-items that also compete against impressions that match the provided targeting.
uncontestedReach
The estimation of number of impressions that match the provided targeting and that are not allocated to existing line-items.
uncontestedReachUpperBound
Upper limit for the uncontested reach estimate.
uncontestedReachLowerBound
Lower limit for the uncontested reach estimate.
The values provided for clickReach, visibleReach, viewableReach and renderedReach provide similar information as the reach values, except for those specific event types rather than for impressions.
Last modified 6mo ago