1. Android Checklist

This document refers to deprecated parts of the platform and has been left intact to help customers with legacy integrations. In order to access the latest platform features and documentation, please go to https://docs.sentiance.com.

Follow the step below to integrate the Android SDK.

1. Installation

1.1 Dependency

Add the Sentiance repository to your project (top-level) build.gradle file.

allprojects {
  repositories {
    ...
    maven {
      url "https://repository.sentiance.com"
    }
  }
}

In the build.gradle file of your app module, add the following line to the dependencies section.

implementation ('com.sentiance:sdk:4.21.2@aar') { transitive = true }

2. Configuration

2.2 Notification & Foreground Service

Depending on your app's configuration and OS version, the SDK may need to start a foreground service every now and again. You must therefore pass a notification that can be used by the service. In the next section, you'll find a handy notification creation method.

Learn more on how to easily setup a sample notification

3. Usage

3.1 SentianceHelper.kt

For a quick start we have created helper file a couple of methods to easily get started. Download this file and place it anywhere accessible in your codebase.

3.2 Initialization & Background Collection

Insert the following line in the onCreate method of your MainApplication.kt file_._ This line ensures that the SDK is initialized and can collect data while the application is in the background.

# MainApplication.kt

SentianceHelper().initSdk(applicationContext, null)

See reference

4. Data Collection & SDK User Creation

In order for the SDK to collect data the application would need to first "create a user" on the SDK. The "createUser" should ideally be called when the user registers, logs in.

4.1 createUser

Invoke the SentianceHelper().createUser method at the moment you are ready to start the data collection. (e.g on user login, on user registration, at a feature, etc)

SentianceHelper.createUser(SDKParams(
   appId,
   secret,
   null,
   link,
   callback
))

See reference

4.2 link

This method will receive the parameters: installId, MetaUserLinkerCallback

See reference

4.3 User linking in your backend

In the link function, at this point, make your backend tell the Sentiance backend which userId should be related to the installId

See reference

4.3 metaUserLinkerCallback.success()

Upon your backend successfully performing the user linking execute the

metaUserLinkerCallback.success()

Verifying the Integration

You can verify the SDK integration by reading the following statuses from the SDK

Sentiance.getInstance().getInitState()	INITIALIZED
Sentiance.getInstance().getSdkStatus().startStatus	STARTED

Note: If you find the startStatus to be PENDING it usually implies that the user has not granted location:always permission. To know more, click here__

You can continue reading through the next sections to get a deeper understanding of the integration and the SDK capabilities.