Documentation

Analytics Android-SDK for EPICA

We use the excellent Analytics for Android library to make dead simple to send your data to EPICA and other analytics or marketing tools from Android devices. Utilizing this tool you don’t have to learn, test or implement a new API every time.
Since the library has a very useful documentation here we describe only the first steps and few differences.

Install the SDK

The recommended way to install the library for Android is with a build system like Gradle. This makes it dead simple to upgrade versions and add destinations. To add the Analytics dependency to your project just add the strings below to your build.gradle file:

allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}

implementation 'org.bitbucket.poderio.analytics-android:analytics:4.3.1-poderio'

We have made some changes in the library in order to work with our own EPICA back-end seamlessly. We would like to generalize these changes and send pull request to the original repository but until that we suggest to use our own library.

Initialize the Client

After instalation ensure that the necessary permissions are declared in your application’s AndroidManifest.xml.

 <!-- Required for internet. -->
<uses-permission android:name="android.permission.INTERNET"/>

We recommend initializing the client in your Application subclass.

public class MyApp extends Application {

@Override public void onCreate() {

// Initialise the default instance
Analytics.createDefaultInstance(this, "WRITE_KEY");

// Safely call Analytics.with(context) from anywhere within your app!
Analytics.with(this).track("Application Started");
}

}

Once you have initialized an Analytics client, you can safely call any of it’s tracking methods from any thread. These events are dispatched asynchronously to our servers and Device-based destinations.

Notes:

Releases

Until our changes are merged into the analytics-android master we release our version a bit delayed. After the origin is released we take over it and release our bespoke version with ‘-poderio’ postfix in the version number.

Proxy HTTP Calls

This feature is not supported at this moment.