You are on page 1of 5

Hi, Developer! This guide will help you to integrate your adserver or application with the MobFox AdServer.

AD REQUEST You can request an advertisement by posting a HTTP POST to our adserver. The following variables are relevant for requesting ads. Please only request an ad if you intend to show it!

API POST URL Variable Name Type

http://my.mobfox.com/request.php Content Description

rt u i h
o p m s

required,static required,dynamic required,dynamic required,dynamic


required,dynamic optional required,dynamic required,dynamic

rt=api u=insert useragent u=10.10.10.10 h[headername]=


o= P=http://www. m=live/test s=

Request Type Client User Agent Client IP Address Multiple Headers


Unique Device ID* Page where called** Test / Live Mode Publisher Site ID

Variable Name longitude

Type optional,dynamic

Content longitude=48.2

Description Device Longitude

latitude int_cat

optional,dynamic optional,dynamic
*Category ID
1 2 3 4 5 6 7 8

latitude=16.3 int_cat
Category Name
Finance IT Business Entertainment News Auto&Motor Sport Travel

Device Latitude App Category ID*

9
10 11

Information
Community Women

* For iPhone / Android, this should be the unique device identifier. For mobile web, it should be the value of the cookie. ** Mobile Web only

XML RETURN Once our server has received an ad request, there is a set of different XML Strings that can be returned.

AD AVAILIBLE DISPLAY IMAGE AD <request type="imageAd"> <bannerwidth>[Width of the banner]</bannerwidth> <bannerheight>[Height of the banner]</bannerheight> <clicktype>[inapp/safari -> Open the page inside the app or external]</clicktype> <clickurl>[Url of the clickthrough page]</clickurl> <imageurl>[Url of the banner]</imageurl> <urltype>[web/other Defines if the clickthrough page is a website or not]</urltype> <refresh>[Time in seconds until you should request and display a new ad]</refresh> <scale>[yes/no Allow Scaling of the clickthrough page]</scale> <skippreflight>[yes/no If the clickthrough url no web url, you need to check in which external app the url should be opened]</skippreflight> </request>

AD AVAILIBLE DISPLAY TEXT / HTML AD <request type="textAd"> <htmlString>[Html String of the ad to be displayed]</htmlString> <clicktype>[inapp/safari -> Open the page inside the app or external]</clicktype> <clickurl>[Url of the clickthrough page]</clickurl> <urltype>[web/other Defines if the clickthrough page is a website or not]</urltype> <refresh>[Time in seconds until you should request and display a new ad]</refresh> <scale>[yes/no Allow Scaling of the clickthrough page]</scale> <skippreflight>[yes/no If the clickthrough url no web url, you need to check in which external app the url should be opened]</skippreflight> </request> NO AD AVAILIBLE <request type="noAd"> </request>

World Headquarters Zieglergasse 2, 2. Stock Vienna, AT 1070 Europe T +43 (1) 92110 1010 M support@mobfox.com

About MobFox MobFox is one of Europe's leading mobile advertising & marketing companies, empowering Advertisers, Publishers, Agencies and Developers to reach and engage their target audiences across mobile web & applications. Using our powerful, dynamic ad targeting technology, we are able to optimize every single ad impression, delivering superior results for our network of mobile websites and applications. Learn more at http://www.mobfox.com

2010 MobFox. All rights reserved.

You might also like