How to Create a Push Endpoint (XML feed)

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}&user_id={userid}&iab_category={iab_category}&domain={domain}&subscription_timestamp={subscription_timestamp}

Europe Data Center
http://sspname.xml.4armn.com/?pubid={publisher-id}&feedid={feed-id}&ip={ip}&lang={language}&useragent={useragent}&user_id={userid}&iab_category={iab_category}&domain={domain}&subscription_timestamp={subscription_timestamp}


Ads API Request URL Example (with substituted macros):

http://1111.xml.adx1.com/?pubid=1234&feedid=1234&ip=178.219.186.122&lang=ru&useragent=Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/67.0.3396.99%20Safari/537.36&user_id=123456789&iab_category=IAB3-1&domain=google.com&subscription_date=2018-12-12


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
user_id Optional User ID (ID of a subscriber) in string format
iab_category Optional Integer value representing IAB category of your traffic if applicable
domain Required A website where the subscribers’ base was collected from
subscription_timestamp Required Unix timestamp (seconds since Jan 01 1970. (UTC))
format Optional, Technical If you need need to CHANGE the default response from JSON to XML you should add the parameter &format={xml}
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):

[
{
    "description": "Offer description",
    "title": "Offer title",
    "cpc": 0.03,
    "link": "<a href="
Parameter Required/ Optional Description
description Required Description of the promoted offer
title Required Title of the promoted offer
cpc Required Cost per click in $
link Required URL that is called to notify about a click
image Required Main image of the promoted offer
icon Required Logo image of the promoted offer
id Required ID of the creative (promoted offer)

Multi Bid response (XML):


<?xml version="1.0" encoding="UTF-8"?>
<result>
 <record>
   <strid>0</strid>
   <title>Title</title>
   <url>myland.com</url>
   <description>Message</description>
   <bid>0.003</bid>
   <click><![CDATA[<a href="">


Multi Bid response (JSON):
">[
 {
   "id": "32390_1211",
    "title": "Title",
    "description": "Message",
    "icon": "<a href="https://our.domain.com/postback/click?key=v2-1623386188973-7-1683-387295-aec81058-b863-4c59-8531-43e8c3fb1e40">

Contact Us

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