/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 Countly SDK to your project

Gradle users:

Add Maven Central repository:

repositories {
    mavenCentral()
}

Add Countly SDK dependency:

dependencies {
    compile 'ly.count:sdk-android:+'
}

Maven users:

<dependency>
    <groupId>ly.count</groupId>
    <artifactId>sdk-android</artifactId>
    <version>13.10</version>
</dependency>

Eclipse users:

Download Latest JAR and put it into your lib folder.

###2. 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>

###3. Set up SDK

  • Call Countly.sharedInstance().init(context, "https://YOUR_SERVER", "YOUR_APP_KEY") in onCreate, which requires your App key and the URL of your Countly server (use https://cloud.count.ly for Countly Cloud).
  • 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.

Note: Call init only once during onCreate of main activity. After that, for each onStart and onStop for each activity, call Countly onStart and onStop.

###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.