/countly-sdk-android

Countly Mobile Analytics - Android SDK

Primary LanguageJavaMIT LicenseMIT

##What's Countly? Countly is an innovative, real-time, open source mobile analytics application. It collects data from mobile devices, and visualizes this information to analyze mobile application usage and end-user behavior. There are two parts of Countly: the server that collects and analyzes data, and mobile SDK that sends this data. Both parts are open source with different licensing terms.

This repository includes the SDK for Android.

##Installing Android SDK

Installing Android SDK requires two very easy steps. Countly Android SDK uses OpenUDID (which comes ready with the zip file). First step is about OpenUDID requirement and second step is integrating Countly SDK to your project:

###1. Add this to your manifest:

  • Add OpenUDID_manager.java and OpenUDID_service.java to your project under Eclipse.
<service android:name="org.openudid.OpenUDID_service">
    <intent-filter>
        <action android:name="org.openudid.GETUDID" />
    </intent-filter>
</service>

###2. Add main Countly SDK to your project using steps below:

  • Add Countly.java to your project under Eclipse.
  • Call Countly.sharedInstance().init(...) in onCreate. init(...) function requires your App key and the URL of your Countly server
  • Call Countly.sharedInstance().onStart() in onStart.
  • Call Countly.sharedInstance().onStop() in onStop.

Additionally, make sure that INTERNET permission is set if there's none in your manifest file.

Note: Make sure you use App Key (found under Management -> Applications) and not API Key. Entering API Key will not work.

###4. Other

Check Countly Server source code here:

There are also other Countly SDK repositories below:

##How can I help you with your efforts? Glad you asked. We need ideas, feedbacks and constructive comments. All your suggestions will be taken care with upmost importance.

We are on Twitter and Facebook if you would like to keep up with our fast progress!

For community support page, see http://support.count.ly.