Do you want to buy traffic using XML/JSON feeds? Then this article is for you! Here we will explain how to configure your own feeds in order to buy traffic using XML/JSON from 3rd-party ad servers. If you would like to sell traffic using XML/JSON feeds, you might want to check out this article.
XML/JSON feeds (or server-side tags) are helpful if you need to establish communication between different ad servers in order to exchange ads.
Currently, Adserver.Online supports XML/JSON feeds for Direct Link, Popup, Push Notification, and Native ad formats.
How to configure XML/JSON feeds to buy traffic
Firstly, you must enable server tag mode for a particular zone in its Publisher / SSP options. Otherwise, feeds won't be working.
Also, you need to set up a revenue model for this zone.
After that, you will find an XML/JSON endpoint available on the zone page.
Finally, you need to send the endpoint to your SSP partner for them to configure it in their ad system. Also, you must provide SSP partner with the information you find below.
Endpoint for Direct link, Popup, Push notification, and Native
https://srv.aso1.net/feed/bidder?zid={zone_id}&type={type}&ip={ip}&referrer={referrer}&ua={user_agent}
Parameters
- zid – Required. Zone ID.
- type – Required. Feed type: link, popup, push, native
- ip – Required. IP address of the visitor.
- ua – Required. User-Agent header from the visitor's HTTP request. It should be URL encoded.
- page – Optional. URL of the page where ads from this zone will be displayed. You can use it to target an Ad. Should be URL encoded
- referrer – Optional. URL of the page from where a visitor has come. You can use it to target an Ad. Should be URL encoded
- uid – Optional but highly recommended. User's unique identifier.
- lang – Optional. The language of the visitor. You should send it in an Accept-Language header format.
- refid – Optional. Reference ID (subid). Up to 50 alphanumeric and special characters are allowed. You will be able to view statistics for each refid.
- refid1 … refid9 – passthrough parameters. Therefore, no stats.
- format – Optional. xml, xml_ak, or json. xml by default. If you specify xml_ak then the response format will be compatible with AdKernel.
- pmodel – Optional. Pricing model filter. Possible values: 1 – CPM, 2 – CPC. By default, 1 (CPM).
Response codes
- 200 – Successful response
- 204 – Empty response. No ads were found
- 400 – Required parameters are missing
- 404 – Zone is inactive or server tag is not enabled
How to buy traffic using XML – Examples
Please note, since Direct link and Popup are almost identical formats, we only made examples for Direct link.
Direct link endpoint with replaced placeholders
https://srv.aso1.net/feed/bidder?zid=34921&type=link&ip=82.131.34.62&referrer=http%3A%2F%2Fexample.com&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_14_2%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F71.0.3578.98+Safari%2F537.36
Response
<?xml version="1.0" encoding="UTF-8"?>
<result>
<clickUrl>https://track.aso1.net/link?_d=UllSCgdRAwAABWVwGVQJcVgMDAAZRVQ%3D%3D&r=4033348884&clk=</clickUrl>
<idad>87033</idad>
<bid>1.2345</bid>
</result>
Direct link endpoint in AdKernel format
https://srv.aso1.net/feed/bidder?zid=34921&type=link&format=xml_ak&ip=82.131.34.62&referrer=http%3A%2F%2Fexample.com&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_14_2%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F71.0.3578.98+Safari%2F537.36
Response
<?xml version="1.0" encoding="UTF-8"?>
<result>
<listing url="https://track.aso1.net/link?_d=UllSCgdRAw8DFVNZVg8JABVB14AV1NUUA%3D%3D&r=654711959&clk=" bid="1.2345"/>
</result>
Popup endpoint with replaced placeholders
https://srv.aso1.net/feed/bidder?zid=35128&type=popup&ip=82.131.34.62&referrer=http%3A%2F%2Fexample.com&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_14_2%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F71.0.3578.98+Safari%2F537.36
Response
<?xml version="1.0" encoding="UTF-8"?>
<result>
<clickUrl>https://track.aso1.net/pop?_d=UllSCgdRAw8DFVUAVRAwQBWwBV&r=4668199820&clk=</clickUrl>
<idad>87291</idad>
<bid>1.2345</bid>
</result>
Push Notification endpoint with replaced placeholders
https://srv.aso1.net/feed/bidder?zid=44418&type=push&ip=82.131.34.62&referrer=http%3A%2F%2Fexample.com&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_14_2%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F71.0.3578.98+Safari%2F537.36
Response
<?xml version="1.0" encoding="UTF-8"?>
<result>
<title>Test Push #1</title>
<description>Check out knowledge base for details</description>
<iconUrl>https://track.aso1.net/wtf.gif?cid=54182&aid=106199&sid=1342&zid=44418&chk=1&uid=aeba455d2423ed4d58eb867adfdb3480a3e1dd78&_t=1624980530&_h=2ceead839cbf1c9409043621be330d5975b2c3f5&r=2380325445&imageUrl=https%3A%2F%2Fmedia.aso1.net%2Fstorage%2Fb%2F4%2F8%2Fb4833c1f9dc5be9d5b97ed7e1c4e414db97de536.png</iconUrl>
<imageUrl></imageUrl>
<clickUrl>https://track.aso1.net/click?_d=BAAICQRbXQdQA1k%3D&r=4481445403&clk=</clickUrl>
<pixelUrl></pixelUrl>
<idad>106199</idad>
<bid>0.01</bid>
</result>
Native endpoint with replaced placeholders
https://srv.aso1.net/feed/bidder?zid=36078&type=native&ip=82.131.34.62&referrer=http%3A%2F%2Fexample.com&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_14_2%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F71.0.3578.98+Safari%2F537.36
Response
<?xml version="1.0" encoding="UTF-8"?>
<result>
<title>Vertical template with image</title>
<description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt.</description>
<imageUrl>https://track.aso1.net/wtf.gif?cid=46489&aid=88505&sid=2114&zid=36078&chk=1&uid=aeba455d2423ed4d58eb867adfdb3480a3e1dd78&_t=1624548958&_h=a6d00fb73bbf613333ab7d29cba1dfc854e9ab2f&r=9296768801&imageUrl=https%3A%2F%2Fmedia.aso1.net%2Fstorage%2Ff%2F6%2F2%2Ff62630361ec1a5e5b47da9c30e7333484bac18af.png</imageUrl>
<clickUrl>https://track.aso1.net/click?_d=UllSCgdSAg4IFVNZVgU1RTVVIKAgMBU15VBFdVVwJRCFMGVA%3D%3D&r=4068004179&clk=</clickUrl>
<iconUrl></iconUrl>
<cta>Buy now</cta>
<label>Ads</label>
<idad>88505</idad>
<pixelUrl></pixelUrl>
<bid>0.017</bid>
</result>
This article contains sufficient information on how to set up server-side tags and buy traffic using XML/JSON feeds. This feature might open new opportunities for your online business and may help you scale up.
IMPORTANT: If you plan to buy traffic using the XML/JSON feeds, you should completely understand that you're about to participate in an auction. Each XML/JSON request generates an ad server request in this case. But that doesn't necessarily mean that each of your XML/JSON requests will result in an impression. That happens due to the nature of an auction. When only XML/JSON requests that won the auction can result in impressions.
NB: manuals/documentation from your partners are needed when you contact our support with questions about XML/JSON integration.