SDK Integration (in Mandarin)

SDK Integration (in Mandarin)


ClearTrust SDK 集成指南

1.下载和设置
  • 创建 'libs' 目录:在您的应用程序目录中创建一个名为 libs 的文件夹。
  • 添加 AAR 文件:将下载的 .aar 文件放入 libs 目录。

2. SDK 初始化

在您的 Application 类或主 ActivityonCreate 方法中初始化 SDK


import android.app.Application import android.view.MotionEvent import com.cleartrust.cleartrustadfraudtestingapp.android.ct_fraud_detection_sdk.* import kotlinx.coroutines.CoroutineScope import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.launch class MyApplication : Application() { private lateinit var CTSessionManager: CTSessionManager private lateinit var CTDeviceMovementMonitor: CTDeviceMovementMonitor private lateinit var CTTouchTracker: CTTouchTracker private lateinit var CTApiClient: CTApiClient private lateinit var CTDeviceInfoManager: CTDeviceInfoManager private lateinit var fraudScore: CTFraudScore private lateinit var CTAppUtils: CTAppUtils override fun onCreate() { super.onCreate() CTApiClient = CTApiClient(this) CTAppUtils = CTAppUtils(this) CTDeviceInfoManager = CTDeviceInfoManager(this) CTSessionManager = CTSessionManager(CTApiClient) CTDeviceMovementMonitor = CTDeviceMovementMonitor(application, CTAppUtils, this) CTTouchTracker = CTTouchTracker() val uuid = CTAppUtils.ctGetDeviceInfo().uuid val apiKey = "您的授权密钥" fraudScore = CTFraudScore(this, uuid, apiKey, s1="", s2="", s3="", s4="", s5="", s6="") fraudScore.startFraudScoreUpdates() CTAppUtils.ctRequestPermissions(this) val coroutineScope = CoroutineScope(Dispatchers.Main) coroutineScope.launch { fraudScore.ctGetFraudScore() } CTDeviceMovementMonitor.startMonitoring() } override fun onDestroy() { super.onDestroy() CTDeviceMovementMonitor.stopMonitoring() fraudScore.stopFraudScoreUpdates() } override fun dispatchTouchEvent(event: MotionEvent): Boolean { CTTouchTracker.trackTouches(event, this) return super.dispatchTouchEvent(event) } }
 

3. 设置您的授权密钥

在上述示例中,将占位符 您的授权密钥 替换为您的实际授权密钥:

val apiKey = "您的授权密钥" 

4. 权限

在您的 AndroidManifest.xml 文件中添加以下权限:

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

5. 依赖项
在您的 build.gradle.kts 文件中添加以下依赖项
dependencies { // 您现有的依赖项 implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar")))) implementation("com.squareup.okhttp3:logging-interceptor:4.10.0") implementation("androidx.lifecycle:lifecycle-process:2.6.2") implementation("com.squareup.retrofit2:retrofit:2.9.0") implementation("com.squareup.retrofit2:converter-gson:2.9.0") implementation("com.squareup.okhttp3:logging-interceptor:4.11.0") implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3") implementation("com.squareup.okhttp3:okhttp:4.9.3") implementation("com.google.code.gson:gson:2.8.8") }
 

6. 获取欺诈评分

欺诈评分是基于各种因素计算的。要从 SDK 获取评分,请使用以下函数:

val score = fraudScore.ctGetFraudScore()

如果该函数返回 null,请将值默认设置为 0


7. 其他跟踪参数
要与 ClearTrust 共享其他跟踪信息,可以在初始化 CTFraudScore 时传递最多六个可选参数(s1s6
fraudScore = CTFraudScore(this, uuid, apiKey, s1="value1", s2="value2", s3="value3", s4="value4", s5="value5", s6="value6"


8. 设置 Bundle ID 和应用名称
在初始化 CTFraudScore 时,传递应用的 Bundle ID 和应用名称,分别对应参数 s5s6
fraudScore = CTFraudScore( context = this, uuid = uuid, apiKey = apiKey, s1 = "", s2 = "", s3 = "", s4 = "", s5 = "您的.Bundle.ID", // 将此处替换为您的实际 Bundle ID s6 = "您的应用名称" // 将此处替换为您的实际应用名称 )

Notes请确保将 "您的.Bundle.ID""您的应用名称" 分别替换为您应用的实际 Bundle ID 和应用名称。

这完成了将 ClearTrust 欺诈检测 SDK 集成到您的 Android 项目中的过程。 


    • Related Articles

    • SDK Integration (in English)

      1.Download and Setup Download the SDK: Obtain the SDK from the provided link. Create a 'libs' Directory: Within your app's directory, create a folder named libs. Add the AAR File: Place the downloaded .aar file into the libs directory. 2. SDK ...
    • API Integration with Prebid.js (GAM)

      Introduction Integrating an API with a Prebid.js setup in a GAM environment can enhance functionalities such as fraud detection, analytics, or performance tracking. Below is a professional and engaging step-by-step guide to ensure seamless ...
    • Javascript Pixel Integration via GTM

      Deploying the ClearSense Tag: A Step-by-Step Guide The ClearSense On-Site Tag can be deployed using two methods: Direct Deployment and Deployment via Google Tag Manager (GTM). Follow the detailed instructions below to ensure seamless integration. ...
    • Postback Integration

      Introduction ClearTrust’s Postback functionality empowers businesses to act decisively and swiftly by sending real-time notifications (callbacks) whenever critical events occur, such as fraudulent traffic detection or conversions. This innovative ...
    • S2S API Integration

      Introduction SafeAPI is a robust and scalable RESTful API designed to handle real-time traffic verification and blocking. It provides a secure and efficient solution for businesses and organizations to protect their digital infrastructure from ...