Ads API Request URL Example:
Ads API Request URL Example (with substituted macros):
http://1111.xml.adx1.com/?pubid=123456&feedid=123456&ip=5.149.248.30&lang=ru&useragent=Mozilla/5.0%20(Windows%20NT%206.2)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/41.0.2272.89%20Safari/537.36%20OPR/28.0.1750.48&&iab_category=IAB3-1&domain=http://loveloves.ru/&q=text&impression-number=5
| Parameter | Required/ Optional | Description |
| sspname | Required | Issued by DSP |
| pubid | Required | Integer value representing publisher id number (substituted from the publisher’s side) |
| feedid | Optional | Integer value representing site id number (substituted from the publisher’s side) |
| ip | Required | Actual IP address of the USER. NOTE: This is not the IP address of the server making the request. Format: XXX.XXX.XXX.XXX Obtain from REMOTE_ADDR |
| lang | Optional | User language in alpha-2 |
| useragent | Required | UserAgent from HTTP header of the USER. Obtain from USER-AGENT UA Reduction sec-ch-ua sec-ch-ua-mobile sec-ch-ua-full-version sec-ch-ua-full-version-list sec-ch-ua-platform sec-ch-ua-platform-version sec-ch-ua-arch sec-ch-ua-wow64 sec-ch-ua-bitness sec-ch-ua-model |
| iab_category | Optional | Integer value representing IAB category of your traffic if applicable. |
| domain | Required | Full URL of the page where the ads are being displayed. NOTE: Should be exactly the same as the USER's click referer. URL-encoded. |
| q | Optional | keyword |
| impression-number | Optional | Serial number of the impression which should be sent to the certain unique user during 24 hour. Format: Integer value from 1 to infinity. |
| source-type | Required | Serial number 1 or 2 1- mainstr / 2 - adult. |
| bidfloor | Optional | Bidfloor parameter - minimal bid |
| format | Optional | If you need need to CHANGE the default response from XML to JSON you should add the parameter &format=json |
| max-banners | Optional Technical |
If you are able to accept multi responses to 1 request you should add the parameter &max-banners to indicate the number of ads you want to get. For example, max-banners={5} means we will send 5 responses to 1 your request. |
We can send a bid response in default or non-default format:
Default bid response (XML):
<result>
<record>
<strid>993852</strid>
<title>2086690</title>
<url>erdecisesgeorg.info</url>
<description>2086690</description>
<bid>0.00001375</bid>
<click>
</click>
</record>
</result>
Example:
\1287877\mpo777power.com\0.00033
Non-default bid response (JSON):
[
{
"id": "2113726_1705510228",
"title": "2098308",
"description": "2098308",
"link": "https://us.postbacks.net/log?action=click&key=v2-1614040555353-4-6826-1002821-a81ef923-99ae-4928-837c-5c079e0e7b29&strategy=1002821&",
"cpc": 0.0000308
}
]
Optional
Multi Bid response (XML):
<result>
<record>
<strid>0</strid>
<title>Title</title>
<url>myland.com</url>
<description>Message</description>
<bid>0.003</bid>
<click></click>
</record><record>
<strid>0</strid>
<title>Title 2</title>
<url>otherland.com</url>
<description>Message 2</description>
<bid>0.004</bid>
<click></click>
</record>
</result>
Multi Bid response (JSON):
[
{
"id": "323901211",
"title": "Title",
"description": "Message",
"icon": "http://cdn.example/icon",
"image": "http://cdn.example/image",
"link": "https://our.domain.com/postback/click?key=v2-1623386188973-7-1683-387295-aec81058-b863-4c59-8531-43e8c3fb1e40",
"cpc": 0.003
},
{
"id": "323901211",
"title": "Title 2",
"description": "Message 2",
"icon": "http://cdn.example/icon",
"image": "http://cdn.example/image",
"link": "https://our.domain.com/postback/click?key=v2-1625225766643-7-1387-982352-c93da27a-6884-463d-9de7-647e0b29b2ac",
"cpc": 0.004
}
]