Official Android library for 100% accurate device identification, created for the Fingerprint Pro API.
import com.fingerprintjs.android.fpjs_pro.Configuration
import com.fingerprintjs.android.fpjs_pro.FingerprintJSFactory
...
// Trust your user's identifiers with the Fingerprint Pro
val fpjsClient = FingerprintJSFactory(applicationContext).createInstance(
Configuration(
apiKey = "your-public-api-key"
)
)
fpjsClient.getVisitorId { result ->
val visitorId = result.visitorId
// Use the visitorId
}
Fingerprint Pro is a professional visitor identification service that processes all information server-side and transmits it securely to your servers using server-to-server APIs.
This identification library generates an accurate, sticky, and stable Fingerprint Pro visitor identifier in Android apps. The identifier is linked to a device, i.e. it is the same in all the apps on a device, even if you reinstall or clone them. This library requires a free API key to connect to the Fingerprint Pro API.
For local Android fingerprinting and identifying without making requests to API take a look at the fingerprintjs-android repository.
If you are interested in the iOS platform, you can also check our Fingerprint Pro iOS.
If your version of Gradle is earlier than 7, add these lines to your build.gradle
.
allprojects {
repositories {
...
maven { url 'https://maven.fpregistry.io/releases' }
maven { url 'https://jitpack.io' }
}}
If your version of Gradle is 7 or newer, add these lines to your settings.gradle
.
repositories {
...
maven { url 'https://maven.fpregistry.io/releases' }
maven { url 'https://jitpack.io' }
}
Fingerprint PRO Android uses FingerprintJS Android as a dependency.
dependencies {
implementation "com.fingerprint.android:pro:2.3.0"
implementation "com.github.fingerprintjs:fingerprint-android:2.0.0"
// If you use Java for you project, add also this line
implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
When using Kotlin, also make sure you have specified Kotlin version in your build.gradle
file:
buildscript {
ext.kotlin_version = 'your-kotlin-version'
...
Note: You can find your Kotlin version in Android Studio > File > Settings > Languages & Frameworks > Kotlin.
Sync gradle settings.
Note: The library depends on kotlin-stdlib. If your application is written in Java, add kotlin-stdlib
dependency first (it's lightweight and has excellent backward and forward compatibility).
Retrieve the visitor identifier using Public API key. You can find your Public API key in your dashboard.
import com.fingerprintjs.android.fpjs_pro.Configuration
import com.fingerprintjs.android.fpjs_pro.FingerprintJSFactory
...
// Initialization
val factory = FingerprintJSFactory(applicationContext)
val configuration = Configuration(
apiKey = "your-public-api-key"
)
val fpjsClient = factory.createInstance(
configuration
)
// Usage
fpjsClient.getVisitorId { visitorIdResponse ->
val visitorId = visitorIdResponse.visitorId
// Use the ID
}
import com.fingerprintjs.android.fpjs_pro.Configuration;
import com.fingerprintjs.android.fpjs_pro.FingerprintJS;
import com.fingerprintjs.android.fpjs_pro.FingerprintJSFactory;
...
FingerprintJSFactory factory = new FingerprintJSFactory(this.getApplicationContext());
Configuration configuration = new Configuration(
"your-public-api-key"
);
FingerprintJS fpjsClient = factory.createInstance(
configuration
);
fpjsClient.getVisitorId(visitorIdResponse -> {
// Use the ID
String visitorId = visitorIdResponse.getVisitorId();
return null;
});
When publishing to the Play Market make sure you've noted the following information about collected data:
Data Types | Collected | Shared | Processed ephemerally | Required or Optional | Purposes |
---|---|---|---|---|---|
User IDs | Yes | No | No | Required | Fraud Prevention |
Device or other IDs | Yes | No | No | Required | Fraud Prevention |
This application is MIT licensed. Copyright FingerprintJS, Inc 2021-2022 (c)