Getting started with Android SDK

Set up Convertedin SDK so you can start to Know what your customers do before and after visiting your offline stores. Leverage data and learn what their behavior looks like.
Installation
The Android SDK is compatible with apps supporting Android API level 17 and above. Apps can be written using Kotlin or Java 8.
Getting started with the Android SDK requires five steps:
1.​Adding the dependency to your Gradle files.
2.​Initialize the SDK with your secret key.
3.Authenticate user by Sending user data for segmentation.
4.​Initialize the Notifier and configure it.
5.​Start location tracking.
6.​Track user events and actions through your app.
Step 1: Adding the dependency
Once you acquire a username and password from Convertedin, you can access the repository that has the SDK. Add the following snippet to your root build.gradle file and you will be able to resolve the library.
1
allprojects {
2
    repositories {
3
            maven {url "http://jfrog.converted.in:80/artifactory/android/"}
4
    }
5
}
Copied!
Then, in the build.gradle file for the project for which you would like to include the SDK, add:
1
dependencies {
2
    implementation 'in.converted:convertedinsdk:1.0.0'
3
}
Copied!
Step 2: Initialize the SDK
Use the following code to initialize the SDK in your Application's onCreate method.
you can optionally set the log level toDEBUGto receive more detailed logs while you're developing and persist them on disk.
KOTLIN
JAVA
1
ConvertedInSdk.init {
2
    application = this@App
3
    secretKey = "YOUR_SECRET_KEY"
4
    apiKey= "YOUR_CLIENT_ID"
5
    debuggable = true
6
}
Copied!
1
ConvertedInSdk.init(
2
    this,
3
    "YOUR_CLIENT_ID",
4
    "YOUR_SECRET_KEY",
5
    false // DEBUG Level
6
);
Copied!
Step 3: Initialize and Configure the Notifier
Your app should and must implement FCM In order for the Notifier to work properly. 
If your app is not implementing FCM please click here to get to the FCM setup guide.
Please follow the below steps to get the Notifier up and running:

1. Add the notification configuration to your Application's onCreate method using the example below.
KOTLIN
JAVA
1
ConvertedInSdk.notifier.configNotification {
2
    smallIcon = R.drawable.ic_notification
3
    color = R.color.colorAccent
4
    visitActivityTarget = MainActivity::class.java
5
}
Copied!
1
ConvertedInNotifierConfig config = new ConvertedInNotifierConfig();
2
    
3
// pass the notification icon
4
config.setSmallIcon(R.mipmap.ic_launcher); 
5
    
6
// pass your app's main activity
7
config.setVisitActivityTarget(MainActivity.class); 
8
    
9
ConvertedInNotifierConfig.notifier().configNotification(config);
Copied!
2. setup updating the user's FCM token
whenever a new token is generated for the user you need to pass it to the SDK After you've obtained it.
add the following line to your onNewToken implementation:
KOTLIN
JAVA
1
override fun onNewToken(newToken: String) {
2
    super.onNewToken(newToken)
3
    ConvertedInSdk.auth.updateUserFcmToken(newToken)
4
  }
Copied!
1
@Override
2
public void onNewToken(String token) {
3
ConvertedInSdk.auth().updateUserFcmToken(token);
4
}
Copied!
3. setup handling when the user receives a notification 
whenever the user receives a new message you need to pass the message data to the SDK to handle certain actions passed on the message's type.
add the following line to your onMessageReceived implementation:
KOTLIN
JAVA
1
override fun onMessageReceived(remoteMessage: RemoteMessage) {
2
    super.onMessageReceived(remoteMessage)
3
    ConvertedInSdk.notifier.onMessageReceived(remoteMessage.data)
4
}
Copied!
1
@Override
2
public void onMessageReceived(RemoteMessage remoteMessage) {
3
    ConvertedInSdk.notifier().onMessageReceived(remoteMessage.getData());
4
}
Copied!
Step 4: Sending the user data
In order to create a user profile for our segmentation, you need to pass the user's data to the SDK.
Use the following snippet and add it in your MainActivity'sonCreate method to send the user data.
We check for you if the user data was sent before or not, so no worries about this✌
​
KOTLIN
JAVA
1
ConvertedInSdk.auth.setUserData {
2
    id = "user_id"
3
    gender = UserGender.MALE
4
    countryCode = "20"
5
    email = "[email protected]"
6
    birthday = "1/1/1990"
7
    name = "John Doe"
8
    fcmToken = token
9
}
Copied!
1
//create a new user instance
2
ConvertedInUser user  = new ConvertedInUser();
3
​
4
// set the user related data
5
user.setId("user_id");
6
user.setGender(UserGender.FEMALE);
7
user.setCountryCode("20");
8
user.setEmail("[email protected]");
9
user.setBirthday("1/1/1990");
10
user.setName("John Doe");
11
user.setFcmToken(token);
12
​
13
// pass the created user to the SDK
14
ConvertedInSdk.auth().setUserData(user);
Copied!
Step 5: Setting up Location Awareness
Once the SDK is initialized and configured  you need to start the location tracking by calling the following the line in your MainActivity'sonCreate method.
We handle asking the user for the location permission.
KOTLIN
JAVA
1
ConvertedInSdk.locationTracker.start(this)
Copied!
1
ConvertedInSdk.getLocationTracker().start(this);
Copied!
In case you want to handle asking the user for the location permission you will need to override the onRequestPermissionsResult method in the activity where you ask your user for the location permission and call the following method passing the required params.
KOTLIN
JAVA
1
ConvertedInSdk.locationTracker
2
        .onRequestPermissionsResult(requestCode, permissions, grantResults)
Copied!
1
ConvertedInSdk.getLocationTracker()
2
      .onRequestPermissionsResult(requestCode, permissions, grantResults);
Copied!
for stopping the tracking simply call the following line:
KOTLIN
JAVA
1
ConvertedInSdk.locationTracker.stop
Copied!
1
ConvertedInSdk.getLocationTracker().stop();
Copied!
Step 6: Track user events
We have around 14 events that need to be implemented to be logged across the user's life cycle within the app. Here are the events
App launch.
Sign in.
Sign up.
Sign out.
Basket view.
View item.
Add item to basket.
Remove an item from basket.
Transaction confirmation.
Search.
Promo redeemed.
Feedback.
You need to log the user events across the app by adding each event as follows:
 App launch
Implement this event in your MainActivity'sonCreate  and pass the current timestamp to log whenever the user opens the app as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.appLaunch()
Copied!
1
ConvertedInSdk.events().appLaunch();
Copied!
Sign in
Implement this event after the user is successfully signed in as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.signIn()
Copied!
1
ConvertedInSdk.events().signIn();
Copied!
Sign up
Implement this event after the registration or signing in for the first time as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.signUp()
Copied!
1
ConvertedInSdk.events().signUp();
Copied!
Sign out
Implement this event after the user signs out as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.signOut()
Copied!
1
ConvertedInSdk.events().signOut();
Copied!
Basket view
Implement this event whenever the user views the basket and pass the basket id as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.viewBasket(12)
Copied!
1
ConvertedInSdk.events().viewBasket(12);
Copied!
View item
Implement this event whenever the user views an item that can be added to the basket and pass the item id as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.viewItem(12)
Copied!
1
ConvertedInSdk.events().viewItem(12);
Copied!
Add item to basket
Implement this event whenever the user adds an item to the basket and pass the basket id and the item id as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.addItemToCart {
2
      itemId = 12
3
      basketId = 30
4
    }
Copied!
1
ConvertedInSdk.events().addItemToCart(12,30);
Copied!
Remove item from basket
Implement this event whenever the user views the basket and pass the basket id as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.removeItemFromCart{
2
      itemId = 12
3
      basketId = 30
4
    }
Copied!
1
ConvertedInSdk.events().removeItemFromCart(12,30);
Copied!
Transaction confirmation
Implement this event after the user successfully completes a payment and pass the order id and the basket id as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.transactionConfirmation {
2
      basketId = 12
3
      orderId = 30
4
    }
Copied!
1
ConvertedInSdk.events().transactionConfirmation(12, 30);
Copied!
Search
Implement this event whenever the user searches for an item and pass the search query as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.search("Running Shoes")
Copied!
1
ConvertedInSdk.events().search("Running Shoes");
Copied!
Promo redemption 
Implement this event whenever the user redeems a promo code successfully and pass the promo string and it's value as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.promoRedeemed {
2
      amount = 200.0
3
      promoCode = "COVID19"
4
    }
Copied!
1
ConvertedInSdk.events().promoRedeemed("COVID19", 200.0);
Copied!
Order feedback
If you have implemented a feedback activity or you take the user's feedback in any form just log it by passing the order id and the feedback questions and answers as follows:
KOTLIN
JAVA
1
ConvertedInSdk.events.orderFeedback {
2
      order_id = 2
3
      feedback_list = listOf(
4
        Feedback("Quality of the product", 1.0),
5
        Feedback("Quality of sales team", "needs to be better")
6
      )
7
      note = "this is a note"
8
    }
Copied!
1
ConvertedInSdk.events().orderFeedback(2, new ArrayList<Feedback>(), "");
Copied!
Overview
Next - IOS
Getting started with the iOS SDK
Last modified 1yr ago
Copy link
Contents
Installation