Mobile Web Integration Guide

Introduction
This document guides you through the integration of the StartApp JavaScript tag.
Once integrated, the tag enables publishers to present ads in their mobile websites and applications.

Resource Details
In order to start displaying StartApps ads in your mobile website or application, simply add the code snippet below.
Update the content of the parameters according to the table below.
<div id="startappContainer"></div>
<script type="text/javascript">
/* Required parameters. */
var publisherId = '';
var productId ='';
var width =;
var height =;
/* Optional parameters. */
var userId = "";
var packageName = "";
var isp = "";
var contentRating = "";
var gender = "";
var age = "";
var category = "";
var networkType = "";
var geoLongitude = "";
var geoLatitude = "";
var subPublisherId = "";
var subProductId = "";
var domain = "";
var deviceManufacturer = "";
var deviceModel = "";
var userAdvertisingId="";
var noAdUrl= "";
</script>
<script type="text/javascript" src="http://www.startappexchange.com/js/startapp-tag.js"></script>
NOTICE: Please do not change the id of the div element in the tag ("startappContainer").

Adding multiple ads on the same page:

<div id="startappContainer-1"></div>
<script type="text/javascript">
/* Required parameters. */
var publisherId = '';
var productId ='';
var width =;
var height =;
var startappContainerId = "startappContainer-1";
</script>
<script type="text/javascript" src="http://www.startappexchange.com/js/startapp-tag.js"></script>

<div id="startappContainer-2"></div>
<script type="text/javascript">
/* Required parameters. */
var publisherId = '';
var productId ='';
var width =;
var height =;
var startappContainerId = "startappContainer-2";
</script>
<script type="text/javascript" src="http://www.startappexchange.com/js/startapp-tag.js"></script>
NOTICE: You can use optional parameters as well when adding two ads or more to one page by adding them below the required
parameters of each ad.

Request Parameters
Field

Required

Type

Description

publisherId

Yes

String

Your StartApp Account ID, created in the Portal

productId

Yes

String

Your StartApp AppID, created in the Portal

width

Yes

Int

The available width in pixels for the ad. Please choose from the
table in Appendix A.

height

Yes

Int

The available height in pixels for the ad. Please choose from the
table in Appendix A.

userId

No

String

Android ID

packageName

No

String

The package name of the application (relevant to in-app traffic)

isp

No

String

Combination of country MCC + MNC from:

http://en.wikipedia.org/wiki/Mobile_country_code

contentRating

No

int

Content rating maturity level of the product. Please choose from

the list in Appendix B.

gender

No

int

Values: {0,1}
0 - male
1- female

age

No

int

Values: {1-99}

category

No

string

The category of the application or mobile website. Please choose

from the list in Appendix C.

networkType

No

int

Values: {0-17}. Please choose from the list in Appendix D.

geoLongitude

No

string

GPS location longitude, Example: 44.000000

geoLatitude

No

string

GPS location latitude, Example: -2.000000

subPublisherId

No

string

Identifier of the publisher in your network, for tracking purposes

subProductId

No

string

Identifier of the product in your network, for tracking purposes

domain

No

string

The domain of the website (for mobile web traffic)

deviceManufacturer

No

string

The manufacturer of users device

deviceModel

No

string

The model of the users device

userAdvertisingId

No

string

The users advertising ID (IDFA for iOS or Google Advertising ID for

Android)

noAdUrl

No

string

URL to call when there is no matching ad to show

Example
<div id="startappContainer"></div>
<script type="text/javascript">
/*Required parameters.*/
var publisherId = '156974125';
var productId ='25437653';
var width =320;
var height =480;
/*Optional parameters.*/
var userId = "";
var packageName = "";
var isp = "";
var contentRating = "";
var gender = "";
var age = "";
var category = "";
var networkType = "";
var geoLongitude = "";
var geoLatitude = "";
var subPublisherId = "";
var subProductId = "";
var domain = "";
var deviceManufacturer = "";
var deviceModel = "";
var userAdvertisingId="";
var noAdUrl= "";
</script>
<script type="text/javascript" src="http://www.startappexchange.com/js/startapp-tag.js"></script>

Appendix A
Creative Types and Dimensions
Ad Type

Dimensions

Comments

Full page interstitial

320x480

Portrait

Full page interstitial

480x320

Landscape

Banner

320x50

Banner

300x50

Banner

300x250

Full page interstitial

768x1024

Tablet Portrait

Full page interstitial

1024x768

Tablet Landscape

Banner

728X90

Tablet

Banner

1024X90

Tablet

Appendix B
Content Rating Values
Content rating maturity level of the product. When used, the response ad must be in the same level or lower. For more information on
the android content rating, check http://goo.gl/IPKKqw. As for iOS, the ratings are age based. From 4+ for everyone, 9+, 12+ and 17+ for
high maturity.
0 - Everyone
1 - Low maturity
2 - Medium maturity
3 - High maturity

Appendix C
Application Category Values
A1 - Books&Reference
A2 - Business
A3 - Comics
A4 - Communication
A5 - Education
A6 - Entertainment
A7 - Finance
A8 - Health&Fitness
A9 - Libraries&Demo
A10 - Lifestyle
A11 - LiveWallpaper
A12 - Media&Video
A13 - Medical
A14 - Music&Audio
A15 - News&Magazines
A16 - Personalization
A17 - Photography
A18 - Productivity
A19 - Shopping
A20 - Social
A21 - Sports
A22 - Tools
A23 - Transportation
A24 - Travel&Local
A25 - Weather
A26 - Widgets
A27 - Game Action
A28 - Game adventure
A29 - Game arcade
A30 - Game board
A31 - Game card
A32 - Game casino
A33 - Game casual
A34 - Game educational

A35 - Game family

A36 - Game wallpaper
A37 - Game music
A38 - Game puzzle
A39 - Game racing
A40 - Game role playing
A41 - Game simulation
A42 - Game sports
A43 - Game strategy
A44 - Game trivia
A45 - Game widgets
A46 - Game word
I1 - Books
I2 - Business
I3 - Catalogs
I4 - Education
I5 - Entertainment
I6 - Finance
I7 - Food & Drink
I8 - Games
I9 - Health & Fitness
I10 - Lifestyle
I11 - Medical
I12 - Music
I13 - Navigation
I14 - News
I15 - Newsstand
I16 - Photo & Video
I17 - Productivity
I18 - Reference
I19 - Social Networking
I20 - Sports
I21 - Travel
I22 - Utilities
I23 - Weather

Appendix D
Network Type Values
0 - Unknown
1 - GPRS
2 - EDGE
3 - UMTS
4 - CDMA
5 - EVDO revision 0
6 - EVDO revision A
7 - 1xRTT
8 - HSDPA
9 - HSUPA
10 - HSPA
11 - iDen
12 - EVDO revision B
13 - LTE
14 - eHRPD
15 - HSPA+
16 - WIFI
17 - NOT_WIFI