widgets for websites

Recommended apps widgets
About this Document
This document provides information required to embed appnext’s widgets to recommend mobile apps on
websites. The widgets are available in the following versions:
1. Iframe – displaying In-Stream Widget within your website content.
2. JS Tag – displaying Sticky Widget placed statically at the screen bottom.
The app recommendations are based on the GEO, platform and device type.
Target Audience
Website owners who look for the optimal mobile traffic monetization solutions. The widgets are
optimized for both responsive and non-responsive websites.
Create an appnext account
You must be registered to appnext to be able to use the API features. If you do not have an appnext
account, please copy the following URL to your browser: https://www.appnext.com and sign up.
Unique ID
A unique ID, called “Placement ID”, is required for all inbound requests. Placement ID is a 32-character
string generated by appnext for every registered app/website.
Get Unique ID
To get started perform the following steps:
1) add a new Web App at appnext’s self-serve platform
2) copy the Placement ID to the respective JS/Iframe Tag. The Placement ID can be found under
your account at: MyApps -> Settings&Placements -> Placement ID (tip: make sure to copy the
Placement ID for both Android and iOS apps).
Updated: 25-Aug-2014
Page | 1
Recommended apps widgets
Sticky Widget – a highly effective unit that rests statically at the screen bottom
offering several apps your users can scroll through to choose; adaptable to
different screen sizes / both responsive and non-responsive website views
Embed one of the following JS Tags:
Option 1 – With Jquery
<script language="javascript" type="text/javascript">
var _sa = _sa || [];
_sa.push(['initialize','<Placement_Android>','<Placement_iOS>','5','<Category>','<pbk>','1','']);
(function() {
var sa = document.createElement('script');
sa.type = 'text/javascript';
sa.async = true;
sa.src = 'https://admin.appnext.com/swidget/online/jq/appnext-banner.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(sa, s);
})();
</script>
Option 2 – Without Jquery
<script language="javascript" type="text/javascript">
var _sa = _sa || [];
_sa.push(['initialize','<Placement_Android>','<Placement_iOS>','5','<Category>','<pbk>','1','']);
(function() {
var sa = document.createElement('script');
sa.type = 'text/javascript';
sa.async = true;
sa.src = 'https://admin.appnext.com/swidget/online/njq/appnext-banner.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(sa, s);
})();
</script>
Updated: 25-Aug-2014
Page | 2
Recommended apps widgets
In-Stream Widget – lives within the website content seamlessly offering the best
and most targeted apps to your mobile users.
Embed one or more of the following iframe Tags:
Option 1
<iframe style="border: 0;"
src="https://offers.appnext.com/widget/online/ver1/index220714.html?cnt=<cnt>&android_id=<placement_Android>&ios_id=<
placement_iOS>&postback_parameters=<pbk>&title=<widget_title>&cat=<app_category,app_category,app_category>"
width="100%" height="252" id='appnext_widget'></iframe><script type='text/javascript'>
window.onload=function(){if(navigator.appVersion.toLowerCase().indexOf("mac
os")<0&&navigator.appVersion.toLowerCase().indexOf("android")<0){var
e=document.getElementById("appnext_widget");e.outerHTML="";delete
e}};window.onresize,window.onorientationchange=function(){document.getElementById("appnext_widget").contentDocument.loc
ation.reload(true)}</script>
Option 2
<iframe style="border: 0;"
src="https://offers.appnext.com/widget/online/ver2/index220714.html?cnt=<cnt>&android_id=<placement_Android>&ios_id=<
placement_iOS>&postback_parameters=<pbk>&title=<widget_title>&cat=<app_category,app_category,app_category>"
width="100%" height="252" id='appnext_widget'></iframe><script type='text/javascript'>
window.onload=function(){if(navigator.appVersion.toLowerCase().indexOf("mac
os")<0&&navigator.appVersion.toLowerCase().indexOf("android")<0){var
e=document.getElementById("appnext_widget");e.outerHTML="";delete
e}};window.onresize,window.onorientationchange=function(){document.getElementById("appnext_widget").contentDocument.loc
ation.reload(true)}</script>
Updated: 25-Aug-2014
Page | 3
Recommended apps widgets
Option 3
<iframe style="border: 0;"src="
https://offers.appnext.com/widget/online/ver3/index220714.html?cnt=3&android_id=<placement_Android>&ios_id=<placement
_iOS>&postback_parameters=<pbk>&title=<widget_title>&cat=<app_category,app_category,app_category>" width="100%"
height="400" id='appnext_widget'> </iframe>
<script type='text/javascript'>
window.onload=function(){if(navigator.appVersion.toLowerCase().indexOf("mac
os")<0&&navigator.appVersion.toLowerCase().indexOf("android")<0){var
e=document.getElementById("appnext_widget");e.outerHTML="";delete
e}};window.onresize,window.onorientationchange=function(){document.getElementById("appnext_widget").contentDocument.loc
ation.reload(true)}
</script>
placement_Android: Android app Placement ID (must)
placement_iOS: iOS app Placement ID (must)
cnt: Number of apps to display (must)
pbk: Postback parameters (optional)
widget_title: The text in the widget title (optional – if not set, default title will be displayed)
cat / category: Apps category (please see last page for category list)
Updated: 25-Aug-2014
Page | 4
Recommended apps widgets
Important Notes:
1. Make sure your remove all <> and non-relevant parameters from the Tag code.
2. When changing the widget title, replace space between words with %20
3. If you are interested in receiving a postback, please send your postback URL to:
[email protected] .
We offer postback with the following parameters: postback-parameter, revenue and apppackage. Please make sure to indicate which parameters you would like us to send.
4. In case of Capping /Geo Targeting/end of banner inventory no landing page will be open.
5. The number of impressions per session will be equal to the apps count (the number of ads
displayed in the widget). For example, if you choose to call the widget with 10 apps, we will
record 10 impressions per session.
Updated: 25-Aug-2014
Page | 5
App Discovery Widgets for Mobile
Websites
App Categories:
make sure to encode (%20) categories with more than 1 word, example: Travel%20&%20Local
Android:
1. Action
2. Adventure
3. Arcade
4. Arcade & Action
5. Board
6. Books & Reference
7. Brain & Puzzle
8. Business
9. Card
10. Cards & Casino
11. Casino
12. Casual
13. Comics
14. Communications
15. Education
16. Educational
17. Entertainment
18. Family
19. Finance
20. Health & Fitness
21. Libraries & Demo
22. Lifestyle
23. Live Wallpaper
24. Media & Video
25. Medical
26. Music
27. Music & Audio
28. News & Magazines
29. Personalization
30. Photography
31. Productivity
Updated: 21-Jul-2014
iOS:
32. Puzzle
33. Racing
34. Role Playing
35. Shopping
36. Simulation
37. Social
38. Sports
39. Sports Games
40. Strategy
41. Tools
42. Travel & Local
43. Trivia
44. Weather
45. Word
1. Action
2. Adventure
3. Arcade
4. Board
5. Books
6. Business
7. Card
8. Casino
9. Catalogs
10. Dice
11. Education
12. Educational
13. Entertainment
14. Family
15. Finance
16. Food & Drink
17. Graphics & Design
18. Health & Fitness
19. Kids
20. Lifestyle
21. Medical
22. Music
23. Navigation
24. News
25. Photo & Video
26. Productivity
27. Puzzle
28. Racing
29. Reference
30. Role Playing
31. Simulation
32. Social Networking
33. Sports
34. Strategy
35. Travel
36. Trivia
37. Utilities
38. Weather
Page | 6