Beruflich Dokumente
Kultur Dokumente
Contents
Introduction.......................................................................................................................... 3 Prerequisites ......................................................................................................................... 3 Wrapping Steps .................................................................................................................... 3 Appendix A ............................................................................................................................ 6 Appendix B .......................................................................................................................... 11
Page | 2
Introduction
The Vserv AppWrapper enables you to wrap your Android Apps with Vserv Premium Ads in One Click without any coding.
Prerequisites
Ensure that Java Development Kit (JDK) 1.6 or higher is installed on the PC and the PATH environment variable is properly set for JDK. You can find more details on Java path setup from below download link. http://vserv.mobi/docs/extras/JavaPathSetup.pdf
Wrapping Steps
1. Place all the application APK files to be wrapped in the RawApps folder. 2. Modify config.txt in conf folder as required. You can find all the configuration parameters listed in the next section. 3. Run VservAppWrapper.exe This will wrap the apk files and place processed apk files in the WrappedApps folder. Configuration Options
Option
zoneId
Required
Description
A zone defines the type of ads, targeting etc that will be used to shown Ads in your app. A default zoneId is generated at time of registration. This is available in the registration email, as well as in the Vserv.mobi online interface (Inventory > Zones). Values for both should be same, unless you need different targeting for start & end. In most cases the value for both is same Specifies at what stage the ad is to be shown
Values
<string>
Default
zoneId_end
Required
showAt
both
viewMandatory
Specifies if the user can or cannot proceed with the application in case of non-availability of data connection to fetch the ad Enables caching for post app advertisement
false
cache
true
Page | 3
Description
Specifies if ad is to be shown only after specified counts of session. Specifies the orientation of the Ad Screen. If its not specified then the launcher orientation will be considered (if available) else the Ad orientation would default to portrait Used to block ads after certain event. For eg. You may want to block ads once end users have upgraded their application from free to paid version. To block both pre and post ads you need to create SharedPreferences with name specified in preferenceName and set flags specified in preAdFlagName and postAdFlagName with data type as mentioned in flagDataType Indicates Shared preference name in which flags are set Indicates name of flag to check for blocking pre ads Indicates name of flag to check for blocking post ads Indicates data types of flags mentioned in preAdFlagName and postAdFlagName Flag value to compare for blocking ads. Whether to show ads in case no flags are available in shared preference Indicates whether location based ads are allowed Specifies if Vserv Premium ads are need and should be wrapped. Specifies the internal version number. The value must be set as an integer.
Values
<integer > landscape/portrait/re verseLandscape/rever sePortrait/sensorLand scape/sensorPortrait <string>
Default
portrait
blockAds
false
wrapAd versionCode
versionName
You can modify the version number shown to the user by modifying this attribute.
<string> NA If blockAds=false <string> NA If blockAds=false <string> NA If blockAds=false <string> NA If blockAds=false <string> NA If blockAds=false <string> NA If blockAds=false <string> true [Allowed] false [Not Allowed] <string> true/false <integer > NA If versionIncrement=fal se <string> NA If versionIncrement=fal se
true
versionIncrement mccExclusionList
Indicates whether version increment should be done post wrapping Specifies comma separated list of Mobile Country Codes (MCC) for which ads would be disabled. Appendix A enlists the required MCCs Specifies whether test mode should be enabled Sets the partner id Sets the id for the storefront on which app
false <string>
<string> <string>
false
Page | 4
Description
Specifies if google analytics are needed and should be wrapped. This will be your Web Property Id from google analytics account. Specifies the display name under which you can find your analytics data.
Values
<string> true/false <string> <string>
Default
false
analyticsName
Midlet Name
Description
Specifies if first launch notifier are to be wrapped Specifies url to be hit when the app is started for the first time. Also on response code 200(HTTP OK) launch will be recorded on client side
Values
<string> true/false <string>
Default
false
firstLaunchUrl
(Mandatory)
Description
Specifies whether/how code signing should be done after wrapping. You have option to sign with your certificate or Vserv certificate. For codeSigning=self , you need to put your keystore file inside CodeSigning folder and also fill in relevant details inside conf.txt For codeSigning=vserv ,wrapper tool will give vserv signed binaries as output For codeSigning=none , wrapper tool will give unsigned apk as output Specifies your key store file name Specifies your alias name Specifies your store password Specifies your key password
Values
<string> none/vserv/self
Default
none
Page | 5
Description
Specifies if raw apps to be deleted after successful wrapping Specifies if non apk resources such as screenshots, game material if present inside RawApps folder to be moved to output folder WrappedApps
Values
<string> true / false <string> true / false
Default
false false
Appendix A
Country Name Afghanistan Albania Algeria American Samoa Andorra Angola Anguilla Antigua and Barbuda Argentina Armenia Aruba Australia Austria Azerbaijan Bahamas Bahrain Bangladesh Barbados Belarus Belgium Belize Benin Bermuda Bhutan Bolivia Bosnia and Herzegovina Botswana Brazil Code AF AL DZ AS AD AO AI AG AR AM AW AU AT AZ BS BH BD BB BY BE BZ BJ BM BT BO BA BW BR MCC 412 276 603 544 213 631 365 344 722 283 363 505 232 400 364 426 470 342 257 206 702 616 350 402 736 218 652 724
Page | 6
Page | 7
Page | 8
Page | 9
Page | 10
Appendix B
Storefront ID allows you to segregate your reporting by the various stores you have uploaded your app to. To use this feature you need to make individual builds for each store with the respective StoreFront IDs specified.
Store Getjar Djuzz Mobango Nokia Ovi Appia Opera Mobango Paid Appia paid Google Play Opera Paid ChinaMobile UC Browser CanvasM tekciz.com Zapak Ibibo Amazon Mobilerated appzmob Slideme Samsung Flypp ID 51 52 54 55 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
Page | 11