RTB
RTB v2.5
Backed with RTB v2.5, we provide seamless S2S integration with bare minimum requirement.
- RTB End Point (given below)
- Cookie Sync URL
- adUnitId (to be added as custom RTB field)
- publisherId (to be added as custom RTB field)
If web property, use - https://ex.ingage.tech/v1/openrtb
If app property, use - https://aex.ingage.tech/v1/openrtb
For cookie sync URL, publisherId & adUnitId, our publisher success team ([email protected]) will help you. We have also provided a sample request with our supported params as an example at the end of the article with comments.
Requirement
- We will require RTB JSON body to verify the signals correctly and avoid any future anomaly.
- Request header: x-forwarded-for: xx.xx.xx.xx [IP Address]
Quality guidance:
We recommend following the quality guidance to improve monetization outcomes.
Additional resources:
Reporting: https://documentation.insticator.com/docs/analytics-date-range
Sample Request
{
"id": "16b4e419b7ee9b1", // should be generated uniquely per request
"tmax": 4000,
"source": {
"fd": 1,
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "insticator.com", // replace with partner's schain node
"sid": "XXXXX-XXXXXX-XXXXXX-XXXXXX",
"hp": 1,
"rid": "16b4e419b7ee9b1"
}
]
}
}
},
"site": {
"domain": "domain.com", // should be generated uniquely per request
"page": "https://domain.com/blog/article-1234", // should be generated uniquely per request
"ref": "https://domain.com/",
"publisher": {
"id": "XXXXX-XXXXXX-XXXXXX-XXXXXX" // required to be the same as sellerId provided by Insticator.
}
},
"device": { // should be generated uniquely per request
"w": 982,
"h": 910,
"js": true,
"ext": {
"localStorage": true,
"cookies": true
},
"dnt": 0,
"ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
"language": "en",
"sua": {
"source": 1,
"platform": {
"brand": "macOS"
},
"browsers": [
{
"brand": "Not/A)Brand",
"version": [
"8"
]
},
{
"brand": "Chromium",
"version": [
"126"
]
},
{
"brand": "Google Chrome",
"version": [
"126"
]
}
],
"mobile": 0
}
},
"regs": { // needs to include all privacy platforms like coppa, gpp, gdpr, gdpr consent string etc
"ext": {
"gppSid": []
},
"coppa": 0
},
"user": {
"id": "XXXX-XXXX-XXXXX-XXXXX", // should be generated uniquely per request
"ext": {
"eids": [
{
"source": "id5-sync.com",
"uids": [
{
"id": "0",
"atype": 1,
"ext": {
"linkType": 0,
"pba": "aWGIYhgL92NqeuTTJqP1pA=="
}
}
]
},
{
"source": "crwdcntrl.net",
"uids": [
{
"id": "66eb4375d2148e8bea1620b3848c4945a70259667c96b5c4f7d6913aced934d0",
"atype": 1
}
]
},
{
"source": "pubcid.org",
"uids": [
{
"id": "9297531e-1b69-45d8-a78a-84163a98900b",
"atype": 1
}
]
},
{
"source": "liveramp.com",
"uids": [
{
"id": "AtOT90ZagQL9LYXXlEaIcvci5VHqU1U97apGAjNLUfDgv143gzyWy8llgLg",
"atype": 3
}
]
}
]
}
},
"imp": [
{
"id": "17363ae75035c56", // should be generated uniquely per impression per request
"tagid": "div-insticator-ad-3", // should be generated uniquely ad unit identifier on the page
"secure": 1,
"ext": {
"insticator": {
"adUnitId": "XXXXX-XXXXXX-XXXXXX-XXXXXX" // required to be the same as ad-unit id provided by Insticator. Will be used in Ad Unit Level reporting breakdown
}
},
"video": {
"delivery": [
"2"
],
"linearity": "1",
"h": "171",
"skip": "1",
"playbackmethod": [
"6"
],
"skipmin": "5",
"minduration": "5",
"mimes": [
"video/mp4",
"application/javascript"
],
"skipafter": "5",
"plcmt": "4",
"maxduration": "15",
"pos": "1",
"w": "304",
"placement": "2",
"api": [
"1",
"2",
"7"
],
"protocols": [
"2",
"3",
"5",
"6",
"7",
"8"
]
}
}
]
}
{
"id": "16b4e419b7ee9b1", // should be generated uniquely per request
"tmax": 4000,
"source": {
"fd": 1,
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "insticator.com", // replace with partner's schain node
"sid": "XXXXX-XXXXX-XXXXX-XXXXXX",
"hp": 1,
"rid": "16b4e419b7ee9b1"
}
]
}
}
},
"site": {
"domain": "domain.com", // should be generated uniquely per request
"page": "https://domain.com/blog/article-1234", // should be generated uniquely per request
"ref": "https://domain.com/",
"publisher": {
"id": "XXXXX-XXXXX-XXXXX-XXXXX" // required to be the same as sellerId provided by Insticator.
}
},
"device": { // should be generated uniquely per request
"w": 982,
"h": 910,
"js": true,
"ext": {
"localStorage": true,
"cookies": true
},
"dnt": 0,
"ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
"language": "en",
"sua": {
"source": 1,
"platform": {
"brand": "macOS"
},
"browsers": [
{
"brand": "Not/A)Brand",
"version": [
"8"
]
},
{
"brand": "Chromium",
"version": [
"126"
]
},
{
"brand": "Google Chrome",
"version": [
"126"
]
}
],
"mobile": 0
}
},
"regs": { // needs to include all privacy platforms like coppa, gpp, gdpr, gdpr consent string etc
"ext": {
"gppSid": []
},
"coppa": 0
},
"user": {
"id": "XXXXX-XXXXX-XXXXX-XXXXX", // should be generated uniquely per request
"ext": {
"eids": [
{
"source": "id5-sync.com",
"uids": [
{
"id": "0",
"atype": 1,
"ext": {
"linkType": 0,
"pba": "aWGIYhgL92NqeuTTJqP1pA=="
}
}
]
},
{
"source": "crwdcntrl.net",
"uids": [
{
"id": "66eb4375d2148e8bea1620b3848c4945a70259667c96b5c4f7d6913aced934d0",
"atype": 1
}
]
},
{
"source": "pubcid.org",
"uids": [
{
"id": "9297531e-1b69-45d8-a78a-84163a98900b",
"atype": 1
}
]
},
{
"source": "liveramp.com",
"uids": [
{
"id": "AtOT90ZagQL9LYXXlEaIcvci5VHqU1U97apGAjNLUfDgv143gzyWy8llgLg",
"atype": 3
}
]
}
]
}
},
"imp": [
{
"id": "17363ae75035c56", // should be generated uniquely per impression per request
"tagid": "div-insticator-ad-3", // should be generated uniquely ad unit identifier on the page
"secure": 1,
"ext": {
"insticator": {
"adUnitId": "XXXXXXXXXXXXXXX" // required to be the same as ad-unit id provided by Insticator. Will be used in Ad Unit Level reporting breakdown
}
},
"banner": {
"format": [
{
"w": 728,
"h": 90
},
{
"w": 468,
"h": 60
}
]
}
},
{
"id": "1809f7ed1652a52",
"tagid": "div-insticator-ad-10",
"secure": 1,
"ext": {
"insticator": {
"adUnitId": "XXXXXXXXXXXXXXX"
}
},
"banner": {
"format": [
{
"w": 728,
"h": 90
},
{
"w": 468,
"h": 60
}
]
}
}
]
}
Updated 18 days ago