How to Invoke the Device Data Collector into Mobile Apps using the Native Android SDK

To enable INTERNET access so the collector can transmit information back to Kount and Location Collection support to detect devices in suspicious locations, add the following permissions to your application’s XML under the <manifest> tag:

    <manifest>
        ....
        <uses-permission android:name="android.permission.INTERNET" />
        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
        <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    </manifest>

Enable Analytics Collection support. There are two methods to enable analytics support:

In the main activity of your application, you must initialize the collector and assign the "<MERCHANT_ID>" you received.

Optionally, you can provide a sessionID if you need to generate your own; if not, the SDK generates one for you. You must send this sessionID back to your servers in order to make calls to the API.

Add the following initialization in your MainActivity:

Initialization for MainActivity

import com.kount.api.analytics.AnalyticsCollector;
        
public class MainActity extends AppCompatActivity implements ActivityCompat.OnRequestPermissionsResultCallback{
  final String deviceSessionID="";
  final String KEY_UUID="UUID";
          
  @Override
  protected void onCreate(Bundle savedInstanceState) {
      ...
              
      AnalyticsCollector.setMerchantId("<MERCHANT_ID>");
              
      //This turns the alpha collections on(true)/off(false). It defaults to true
      AnalyticsCollector.collectAnalytics(true);
              
      //For production need to add AnalyticsCollector.ENVIRONMENT_PRODUCTION
      AnalyticsCollector.setEnvironment(AnalyticsCollector.ENVIRONMENT_TEST);
              
      if (savedInstanceState == null) {
          /** If you want to pass in a self generated sessionID(or one given
          to you by your servers) you can set it here instead of generating a UUID using the code below.
          Make sure you set session ID only one time in a user session by saving it in the savedInstanceState. 
          An example to create a sessionID is below.
          **/
          deviceSessionID = UUID.randomUUID().toString().replace('-','');
          AnalyticsCollector.setSessionId(deviceSessionID);
      } else {
          deviceSessionID = savedInstanceState.getString(KEY_UUID)!!
          AnalyticsCollector.setSessionId(deviceSessionID)
      }
              
      //Request location permission for Android 6.0 & above
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        Utils.requestLocationPermission(this); //step:4
      } else {
          AnalyticsCollector.collectDeviceDataForSession(this,(sessionId)->
          {
            //success block
            Log.d("TAG", "Client success completed with sessionId "+sessionId);
            Log.d("TAG", "DDC status is " +AnalyticsCollector.getCollectionStatus());
            return null;
          },(sessionId, error)->
          {
            //error block
            Log.d("TAG", "client failed with sessionId $error, $sessionId");
            Log.d("TAG", "DDC status is " +AnalyticsCollector.getCollectionStatus());
            return null;
          });
      }    
  }
  @Override
  protected void onSaveInstanceState(@NonNull Bundle outState) {
      super.onSaveInstanceState(outState);
      outState.putString(KEY_UUID, deviceSessionID);
  }
        

Your MainActivity should implement ActivityCompat.OnRequestPermissionsResultCallback and Override method onRequestPermissionsResult(requestCode, permissions, grantResults).

     
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
  if (requestCode == AnalyticsCollector.REQUEST_PERMISSION_LOCATION) {
    //this block executes when a user grant/deny the permission
    AnalyticsCollector.collectDeviceDataForSession(this,(sessionId)->
    {
        //success block
        Log.d("TAG", "Client success completed with sessionId "+sessionId);
        Log.d("TAG", "DDC status is " +AnalyticsCollector.getCollectionStatus());
        return null;
    },(sessionId, error)->
    {
        //error block
        Log.d("TAG", "client failed with sessionId $error, $sessionId");
        Log.d("TAG", "DDC status is " +AnalyticsCollector.getCollectionStatus());
        return null;
    });
  }
  super.onRequestPermissionsResult(requestCode, permissions, grantResults);
}
    

To support Location Collection in Android API 23 and above, add the following code to your main activity, onCreate method:

   
if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
  if (ActivityCompat.shouldShowRequestPermissionRationale(activity, Manifest.permission.ACCESS_FINE_LOCATION)) {
      ActivityCompat.requestPermissions(activity, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, AnalyticsCollector.REQUEST_PERMISSION_LOCATION);
  } else {
      ActivityCompat.requestPermissions(activity, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, AnalyticsCollector.REQUEST_PERMISSION_LOCATION);
  }
} else {
  //This block executes when permission is already granted.
      
  AnalyticsCollector.collectDeviceDataForSession(this,(sessionId)-> {
      //success block
      Log.d("TAG", "Client success completed with sessionId "+sessionId);
      Log.d("TAG", "DDC status is " +AnalyticsCollector.getCollectionStatus());
      return null;
  },(sessionId, error)->
  {
      //error block
      Log.d("TAG", "client failed with sessionId $error, $sessionId");
      Log.d("TAG", "DDC status is " +AnalyticsCollector.getCollectionStatus());
      return null;
  });
}
    

Almost all API calls require your assigned merchantID and a sessionID. Send the sessionID created earlier back to your servers. This can be done at any time prior to the API calls being made (from your servers to ours). For example, if you are using our services and plan to evaluate logins, you could include the sessionID along with the users login credentials to your servers. This sessionID is accessible as a global function.

    final String sessionId = AnalyticsCollector.getSessionId();
    // TODO add sessionId in posting to server here
    

Build and run.