This feature, which combines IPQS's web fingerprinting with the IPQS mobile device fingerprinting SDK , offers a flexible solution for your Android app's fraud detection needs. It can verify new or returning users and identify a wide range of high-risk behaviors, including:

• Mobile emulators
• Residential botnets
• Location spoofing
• Bots
• Non-human requests
• Fake accounts
• and hijacked devices.

With this tool, you can easily identify app install quality and gain deeper insights into your audience's KPIs. It also helps you detect duplicate accounts and prevent free trial abuse, fraudulent users, fake installs, and much more.

1. In your app's top-level build.gradle file, add the following:
   
   maven { url = uri("https://downloads.ipqualityscore.com/maven2/") credentials { username "ipqs" password "YOUR_API_KEY_HERE" } authentication { basic(BasicAuthentication) } }
   
   As an example, your repository list should now look similar to this:
   
   allprojects { repositories { google() jcenter() maven { url = uri("https://downloads.ipqualityscore.com/maven2/") credentials { username "ipqs" password "YOUR_API_KEY_HERE" } authentication { basic(BasicAuthentication) } } } }

    

2. In your app's module build.gradle file, add the following:
   
   implementation 'com.ipqualityscore:FraudEngine:1.2.7'
   
   

3. Sync your gradle.build file.

4. The IPQS SDK can optionally take advantage of the following permissions if you choose to add them to your app. These permissions help us provide better results and create a better overall picture of your users. These permissions must be added to the «manifest» section of your AndroidManifest.xml file.

   We highly recommend adding at least the ACCESS_NETWORK_STATE, ACCESS_WIFI_STATE, and READ_PHONE_STATE permissions listed below.

   The location permissions also listed below are only helpful if you intend to use the allowLocationRequest() system or if your app already collects location data from your users.
   
   

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

1. Add the SDK inside one of your app's activity sections. Ideally, this should be the main activity section, but it does not necessarily need to be, depending on your specific use case.
   
   import com.ipqualityscore.FraudEngine.IPQualityScore; ... IPQualityScore api = IPQualityScore.getInstance(); api.setAppKey("api_key_here"); api.setActivity(this); // Not required if using the Proxy/Email portions of the SDK.

    

2. Call the SDK from within your application's activities. Below is an example of how to retrieve the fraud score for a given device:
   
   import android.widget.Toast; import android.content.Context; import com.ipqualityscore.FraudEngine.MobileTracker; import com.ipqualityscore.FraudEngine.IPQualityScore; import com.ipqualityscore.FraudEngine.Interfaces.OnMobileTrackerResult; import com.ipqualityscore.FraudEngine.Utilities.IPQualityScoreException; ... try { /* * Set custom variables if you have them before calling performFraudCheck() * MobileTracker.addCustomVariable("userID", "1234"); */ MobileTracker.performFraudCheck(new OnMobileTrackerResult(){ @Override public void onResult(MobileTrackerResult result){ // Display a result via a toast. Context context = IPQualityScore.getInstance().getContext(); CharSequence text = "You have a fraud score of " + result.getFraudScore().toString() + "!"; int duration = Toast.LENGTH_SHORT; Toast toast = Toast.makeText(context, text, duration); toast.show(); } }); } catch(IPQualityScoreException e){ // Display the error via toast. Context context = IPQualityScore.getInstance().getContext(); CharSequence text = e.getMessage(); int duration = Toast.LENGTH_SHORT; Toast toast = Toast.makeText(context, text, duration); toast.show(); }

Below is an example Android app with the Mobile Device Fingerprinting SDK integrated. The app will close if the user's fraud score is greater than 85:

The SDK allows you to specify that you'd like us to attempt to capture location information from your user via a permission request check. You can enable this like such:

Our SDK allows you to specify custom variables for statistics, postback, and enhanced scoring purposes. We only accept strings for both the key and values specified. Make sure you cast/convert the type of your data appropriately. You can set a custom variable like such:

Some apps may want to avoid collecting the advertising ID or may get flagged by Google for doing so. We've added a method to disable it (You no longer need to include androidx.ads:ads-identifier:1.0.0-alpha04 in your build.gradle):

Our SDK offers various result methods and functions to enhance your experience and help prevent fraudulent activity. The variable result below signifies an object of com.ipqualityscore.FraudEngine.Results.MobileTrackerResult.

Postback Example to Retrieve Latest Request by UserID

This method uses the Postback API to retrieve requests by userID.

Retrieve multiple requests with the Request List API

This method uses the Request List API to search by Device ID and IP Address.