How to Create a Pop Endpoint (XML feed)

To create a new Pop SSP Endpoint, please click RTB Endpoints tab --> Add SSP Endpoint.

Please select XML API / XML Direct Integration Type and Pop Channel in a new window. 

Click Save SSP Endpoint.

Traffic should be sent to the endpoint URL which will be generated automatically, and the below mentioned request parameters should be added. 

Request parameters:

The XML Request should contain the parameters listed below:

Parameter  Type  Description
endpoint String Corresponds to the type of traffic sent to the feed. NOTE: The endpoint is issued by the system automatically. No changes are needed.
pubid Numeric Integer value representing your publisher id number.
subid String Sub affiliate id to track traffic sub sources / sub affiliates.
feedid Numeric Integer value representing a feed id (site id) number.
ip String Actual IP address of the USER. NOTE: This is not the IP address of the server making the request. Format: XXX.XXX.XXX.XXXObtain from REMOTE_ADDR
q String (URL encoded) Query keyword requested by the USER.
num Numeric Number of ads returned by the feed. Default: 10
ref String (URL encoded) 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.
useragent String (URL encoded) Useragent from HTTP header of the USER. Obtain from USER-AGENT
iab_category Numeric Integer value representing IAB category of your traffic if applicable. Non-obligatory parameter

Request URL:

http://%ENDPOINT%.xml. adxml.click/?pubid=%PUBLISHER_ID%&subid=%SOURCE_ID%&feedid=%FEED_ID%&q=%KEYWORD%&useragent=%USERAGENT%&ip=%REMOTE_IP_ADDRESS%&ref=%HTTP_REFERRER%&num=%NUMBER_OF_ADS%&=iab_category=%IAB_CATEGORY%

Example request:

http://newssp.xml.adxml.click/?pubid=28082&subid=1&feedid=497&q=test&useragent=Mozilla/5.0(Macintosh; Intel Mac OS X 10_8_3) AppleWebKit/537.31 (KHTML, like Gecko) Chrome/26.0.1410.65 Safari/537.31 &ip=161.55.44.133&ref=http://testsite.com&num=10&iab_category=39

Making a Request:

Replace the above parameters with valid user request details and perform a GET request.

Example response:

<result>

<record>

<title><![CDATA[ Test Ad Title ]]></title>

<url>domain.com</url>

<description><![CDATA[ Some description goes here ]]></description>

<bid>0.01</bid>

<click><![CDATA[ http://domain.com/?utm_source=platform ]]></click>

</record>

</result>

Still need help? Contact Us Contact Us