XML Feed Documentation
Version: 1.5
Last update: 30th of April 2008
This documentation gives you all the basic information to integrate ExoClick.com XML feed in your pages.
This feed is offered to premium partners only.
1. Enabling XML for your account
The first step is to make sure your account is enabled for XML. You can check that by connecting to the admin panel and look under "PUBLISHERS > Marketing Tools > XML Feed".
2. Integration
URL of the feed: http://syndication.exoclick.com/feeds.php
Parameters:
* keyword: Search term you target. Make sure to separate multi-word terms by a '+' or '%20' (urlencode them). Mandatory.
* login: Your ExoClick login. Mandatory.
* ip: IP address of the end-user. In PHP, use the variable $_SERVER[REMOTE_ADDR]. Mandatory.
* referer: URL of the page where the ad is displayed. In PHP, you can use urlencode($_SERVER["HTTP_HOST"].$_SERVER["REQUEST_URI"]). Mandatory.
* useragent: Browser user-agent of the end-user. In PHP, you can use urlencode($_SERVER["HTTP_USER_AGENT"]). Mandatory.
* n: Number of ads you want to fetch. Optional, default is 5.
* type: Type of the feed. 1=TEXT, 2=XML. Optional, default is 1.
* sub: You can use this parameter to attache subids (or channels) to your clicks. Numeric (integer) value only. Optional, you can leave it empty.
* block_adult: Set to 1 to block adult related ads. Optional, default is 0.
Result:
As a result, you will get a feed in XML or TEXT (following the type you have sent) with the related ads, ordered by bid.
You will get an ad title and description, the gross bid, the URL to display in your page and the URL where to send the surfer.
The results are provided in UTF8 to support ads in all languages. Make sure you support UTF8 to avoid any "strange characters" display.
In case of error, the feed will be a simple text result with an error message.
E.g. ERROR: Missing parameters.
Please note that caching of the result is NOT allowed and the data provided in this feed cannot be manipulated in any way.
Categories: (Optional)
Instead of getting ads targeted by keyword, you may fetch our ads targeting categories.
* cat: Use this parameter with one of our category IDs. Keyword is ignored if a cat value is set.
| ID | Category |
| 2 | Adult |
| 270 | Astrology |
| 414 | Automotive |
| 388 | Blogging |
| 415 | Business |
| 381 | Car Insurance |
| 255 | Dating |
| 413 | Finance |
| 1 | Gambling |
| 311 | Games |
| 368 | Health |
| 410 | Movies & TV |
| 409 | Music |
| 411 | News |
| 244 | Online Booking |
| 263 | PC Health |
| 280 | Pharmacy |
| 391 | Real Estate |
| 225 | Shopping |
| 404 | Social Media |
| 412 | Sports |
| 204 | Sports Betting |
| 392 | Technology |
| 408 | Travel |
| 377 | Webmasters |
| 327 | Women |
PHP Example
3. Traffic
Please, always notify us when you start using our feed or add some sources of traffic.
For more information on ExoClick.com, check http://www.exoclick.com
For support or if you have any questions, send an email to contact@exoclick.com
Thank you.
ExoClick.com Support Team.