Java for Android Instructions

Thank you for choosing Software Statistics Service – a perfect Java for Android analytics tool!

These instructions will help you to install and integrate Software Statistics Service tracker into your Java for Android application within a few minutes. If you experience any problems, please consult online documentation. And please don’t hesitate to contact us – we’re always glad to help.

Please see instructions for other technologies: .NETC++, Java, DelphiMicrosoft SilverlightWindows Phone 7Windows Presentation FoundationMac OS (Xcode)iOS (Xcode).

Technical Requirements

Java 1.5 or higher

Android 2.1

Integration

To integrate Software Statistics Service Tracker include software_statistic.jar in your project’s classpath. Additional permissions required. Edit AndroidManifest.xml, add:

android.permission.
WRITE_EXTERNAL_STORAGEandroid.permission.INTERNET

Usage

To start working with Software Statistics Service Tracker you have to:

  1. Create SoftwareStatisticsInitParams instance as initial parameters for tracker. For example:
    SoftwareStatisticsInitParams statParams = new SoftwareStatisticsInitParams();
    statParams.setProductKey(String yourKey);
    statParams.setProductPackage(String yourPackage);
    statParams.setUseSandbox(String useSandbox);
  2. Set initial parametrs to SoftwareStatisticsManager
    SoftwareStatisticsManager statMgr = new SoftwareStatisticsManager(statParams);
  3. To start working with tracker call statMgr.appStart() method (“Application Start” event will be generated). Now you can add your custom events by calling statMgr.addCustomEvent(myCustomEvent). And do not forget to call statMgr.appFinish() for correct application finish.

* Make sure you have useSandbox property properly set – it should be False for production release. Check demo application included in this package for more information.

Please find demo application inside the package to see how to integrate Software Statistics Service Tracker into your JAVA application and how to use its features. Also check help in Doc directory to get more information about types and functions.

Note: Software Statistics Service Tracker is designed to automatically collect anonymous usage information and transfer it to the Software Statistics Service host server. In addition this service allows you to collect your own custom data that may not be anonymous and violate user level agreement and country laws. You should include prominent option in your software informing users about such behaviour and allowing them to turn this feature off. Usual practice is to show such option during software installation and also add it to the software program options/preferences.

How to Test Your Integration

  1. Signup at software-statistics-service.com and create a new project.
  2. Create a new application and use Software Statistics Service Tracker client module in it as it is described in integration instructions.
  3. Copy Project Key from your account and set Project Key property of tracker module in your application.
  4. Make sure you’ve set UseSandbox property to “True”. When this option is used your data will be posted to our sandbox server which is faster but limited by the number of requests – up to 100 requests per project per day. In case you were trying integration and reached the limit you should create a new project and use another Project Key.

The very simple way to test is to run and then close your application. Software Statistics Service Tracker module will send data when application is about to be closed. If there are delays/troubles with internet connection, it will try to send data next time application is started.

Usually it takes up to 15 minutes between data transfer to the server and the moment when you can see them on the graphs under your account.

By default Tracker module collects such events as application start and shutdown as well as such data as RAM amount, number of CPU cores and CPU frequency, location and operating system i.e. very common usage information. If you want to track your own data e.g. number of times a button was clicked or feature was used you should use Custom Events.

Changelog

Check out our Java for Android changelog from time to time to follow up with our latest updates.

Frequently Asked Questions

See also  Frequently Asked Questions
We are open to your suggestions and ready to discuss your needs and ideas at: support@software-statistics-service.com

Thank you for reading this far. Good luck with your e-business!

This component is copyrighted (c) 2010-2011 MagneticOne, Eleks
All trademarks are property of their respective owners.