Pop XML Feed Integration

Ads API Request URL Example:

US Data Center
http://sspname.xml.adx1.com/?pubid={publisher-id}&feedid={feed-id}&ip={ip}&lang={language}&useragent={useragent}&sec-ch-ua={sec-ch-ua}&sec-ch-ua-mobile={sec-ch-ua-mobile}&sec-ch-ua-full-version={sec-ch-ua-full-version}&sec-ch-ua-full-version-list={sec-ch-ua-full-version-list}&iab_category={iab_category}&domain={domain}&q={keyword}&impression-number={impression-number}&source-type={source-type}&bidfloor={bidfloor}

Europe Data Center
http://sspname.xml.4armn.com/?pubid={publisher-id}&feedid={feed-id}&ip={ip}&lang={language}&useragent={useragent}&sec-ch-ua={sec-ch-ua}&sec-ch-ua-mobile={sec-ch-ua-mobile}&sec-ch-ua-full-version={sec-ch-ua-full-version}&sec-ch-ua-full-version-list={sec-ch-ua-full-version-list}&iab_category={iab_category}&domain={domain}&q={keyword}&impression-number={impression-number}&source-type={source-type}&bidfloor={bidfloor}

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": "32390
1211",
    "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
 }
]

Contact Us

Not finding what you're looking for? Contact Us Directly