├── app
    ├── src
    │   └── main
    │   │   ├── res
    │   │       ├── values
    │   │       │   ├── strings.xml
    │   │       │   ├── colors.xml
    │   │       │   └── themes.xml
    │   │       ├── mipmap-hdpi
    │   │       │   ├── ic_launcher.webp
    │   │       │   └── ic_launcher_round.webp
    │   │       ├── mipmap-mdpi
    │   │       │   ├── ic_launcher.webp
    │   │       │   └── ic_launcher_round.webp
    │   │       ├── mipmap-xhdpi
    │   │       │   ├── ic_launcher.webp
    │   │       │   └── ic_launcher_round.webp
    │   │       ├── mipmap-xxhdpi
    │   │       │   ├── ic_launcher.webp
    │   │       │   └── ic_launcher_round.webp
    │   │       ├── mipmap-xxxhdpi
    │   │       │   ├── ic_launcher.webp
    │   │       │   └── ic_launcher_round.webp
    │   │       ├── xml
    │   │       │   └── network_config.xml
    │   │       ├── layout
    │   │       │   └── activity_main.xml
    │   │       ├── mipmap-anydpi-v26
    │   │       │   ├── ic_launcher.xml
    │   │       │   └── ic_launcher_round.xml
    │   │       ├── values-night
    │   │       │   └── themes.xml
    │   │       ├── drawable-v24
    │   │       │   └── ic_launcher_foreground.xml
    │   │       └── drawable
    │   │       │   └── ic_launcher_background.xml
    │   │   ├── java
    │   │       └── dev
    │   │       │   └── deeplink
    │   │       │       └── sdk
    │   │       │           └── demo
    │   │       │               ├── MainActivity.kt
    │   │       │               ├── AppLinkActivity.kt
    │   │       │               └── CustomApplication.kt
    │   │   └── AndroidManifest.xml
    ├── .gitignore
    ├── proguard-rules.pro
    └── build.gradle.kts
├── gradle
    ├── wrapper
    │   ├── gradle-wrapper.jar
    │   └── gradle-wrapper.properties
    └── libs.versions.toml
├── .gitignore
├── settings.gradle.kts
├── gradle.properties
└── README.md


/app/src/main/res/values/strings.xml:
--------------------------------------------------------------------------------
1 | <resources>
2 |     <string name="app_name">DeepLinkDemo</string>
3 | </resources>


--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/gradle/wrapper/gradle-wrapper.jar


--------------------------------------------------------------------------------
/app/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 | gradlew
3 | gradlew.bat
4 | /.idea/
5 | /.idea/vcs.xml
6 | /.idea/kotlinc.xml
7 | /.idea/misc.xml
8 | /.idea/compiler.xml


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-hdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-mdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xhdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DLinkSDK/client-sdk-kotlin/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp


--------------------------------------------------------------------------------
/app/src/main/res/xml/network_config.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <network-security-config>
3 |     <base-config cleartextTrafficPermitted="true" />
4 | </network-security-config>


--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | #Fri Feb 14 11:50:19 CST 2025
2 | distributionBase=GRADLE_USER_HOME
3 | distributionPath=wrapper/dists
4 | distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-bin.zip
5 | zipStoreBase=GRADLE_USER_HOME
6 | zipStorePath=wrapper/dists
7 | 


--------------------------------------------------------------------------------
/app/src/main/res/layout/activity_main.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
3 |     android:layout_width="match_parent"
4 |     android:layout_height="match_parent">
5 | 
6 | </androidx.constraintlayout.widget.ConstraintLayout>


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | *.iml
 2 | .gradle
 3 | /local.properties
 4 | /.idea/caches
 5 | /.idea/libraries
 6 | /.idea/modules.xml
 7 | /.idea/workspace.xml
 8 | /.idea/navEditor.xml
 9 | /.idea/assetWizardSettings.xml
10 | .DS_Store
11 | /build
12 | /captures
13 | .externalNativeBuild
14 | .cxx
15 | local.properties
16 | gradlew
17 | gradlew.bat
18 | /.idea/
19 | 


--------------------------------------------------------------------------------
/app/src/main/java/dev/deeplink/sdk/demo/MainActivity.kt:
--------------------------------------------------------------------------------
 1 | package dev.deeplink.sdk.demo
 2 | 
 3 | import android.app.Activity
 4 | import android.os.Bundle
 5 | 
 6 | class MainActivity : Activity() {
 7 | 
 8 |     override fun onCreate(savedInstanceState: Bundle?) {
 9 |         super.onCreate(savedInstanceState)
10 |         setContentView(R.layout.activity_main)
11 |     }
12 | }


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
3 |     <background android:drawable="@drawable/ic_launcher_background" />
4 |     <foreground android:drawable="@drawable/ic_launcher_foreground" />
5 |     <monochrome android:drawable="@drawable/ic_launcher_foreground" />
6 | </adaptive-icon>


--------------------------------------------------------------------------------
/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
3 |     <background android:drawable="@drawable/ic_launcher_background" />
4 |     <foreground android:drawable="@drawable/ic_launcher_foreground" />
5 |     <monochrome android:drawable="@drawable/ic_launcher_foreground" />
6 | </adaptive-icon>


--------------------------------------------------------------------------------
/app/src/main/res/values/colors.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <resources>
 3 |     <color name="purple_200">#FFBB86FC</color>
 4 |     <color name="purple_500">#FF6200EE</color>
 5 |     <color name="purple_700">#FF3700B3</color>
 6 |     <color name="teal_200">#FF03DAC5</color>
 7 |     <color name="teal_700">#FF018786</color>
 8 |     <color name="black">#FF000000</color>
 9 |     <color name="white">#FFFFFFFF</color>
10 | </resources>


--------------------------------------------------------------------------------
/gradle/libs.versions.toml:
--------------------------------------------------------------------------------
 1 | [versions]
 2 | agp = "8.4.0"
 3 | kotlin = "1.9.0"
 4 | appcompat = "1.7.0"
 5 | material = "1.12.0"
 6 | attribution = "2.5.0"
 7 | appsFlyer = "6.12.2"
 8 | 
 9 | [libraries]
10 | androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }
11 | material = { group = "com.google.android.material", name = "material", version.ref = "material" }
12 | attribution = { group = "dev.deeplink.sdk", name = "attribution", version.ref = "attribution" }
13 | appsflyer = { group = "com.appsflyer", name = "af-android-sdk", version.ref = "appsFlyer" }
14 | 
15 | [plugins]
16 | android-application = { id = "com.android.application", version.ref = "agp" }
17 | jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
18 | 


--------------------------------------------------------------------------------
/app/src/main/res/values/themes.xml:
--------------------------------------------------------------------------------
 1 | <resources>
 2 |     <!-- Base application theme. -->
 3 |     <style name="Theme.DeepLinkDemo" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
 4 |         <!-- Primary brand color. -->
 5 |         <item name="colorPrimary">@color/purple_500</item>
 6 |         <item name="colorPrimaryVariant">@color/purple_700</item>
 7 |         <item name="colorOnPrimary">@color/white</item>
 8 |         <!-- Secondary brand color. -->
 9 |         <item name="colorSecondary">@color/teal_200</item>
10 |         <item name="colorSecondaryVariant">@color/teal_700</item>
11 |         <item name="colorOnSecondary">@color/black</item>
12 |         <!-- Status bar color. -->
13 |         <item name="android:statusBarColor">?attr/colorPrimaryVariant</item>
14 |         <!-- Customize your theme here. -->
15 |     </style>
16 | </resources>


--------------------------------------------------------------------------------
/app/src/main/res/values-night/themes.xml:
--------------------------------------------------------------------------------
 1 | <resources>
 2 |     <!-- Base application theme. -->
 3 |     <style name="Theme.DeepLinkDemo" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
 4 |         <!-- Primary brand color. -->
 5 |         <item name="colorPrimary">@color/purple_200</item>
 6 |         <item name="colorPrimaryVariant">@color/purple_700</item>
 7 |         <item name="colorOnPrimary">@color/black</item>
 8 |         <!-- Secondary brand color. -->
 9 |         <item name="colorSecondary">@color/teal_200</item>
10 |         <item name="colorSecondaryVariant">@color/teal_200</item>
11 |         <item name="colorOnSecondary">@color/black</item>
12 |         <!-- Status bar color. -->
13 |         <item name="android:statusBarColor">?attr/colorPrimaryVariant</item>
14 |         <!-- Customize your theme here. -->
15 |     </style>
16 | </resources>


--------------------------------------------------------------------------------
/app/src/main/java/dev/deeplink/sdk/demo/AppLinkActivity.kt:
--------------------------------------------------------------------------------
 1 | package dev.deeplink.sdk.demo
 2 | 
 3 | import android.app.Activity
 4 | import android.content.Intent
 5 | import android.os.Bundle
 6 | import dev.deeplink.sdk.AttrSdk
 7 | 
 8 | /**
 9 |  * @Author: Hades
10 |  * @Date: 2025/11/21
11 |  */
12 | class AppLinkActivity : Activity() {
13 | 
14 |     override fun onCreate(savedInstanceState: Bundle?) {
15 |         super.onCreate(savedInstanceState)
16 |         val data = intent.data.toString()
17 |         //[Require] Report reEngagement data to Dlink
18 |         AttrSdk.trackAppReEngagement(data)
19 | 
20 |         //[Optional] Execute specific business logic, such as navigating to a specific page.
21 |         startActivity(Intent(this, MainActivity::class.java).apply {
22 |             this.flags = Intent.FLAG_ACTIVITY_NEW_TASK
23 |         })
24 | 
25 |         finish()
26 |     }
27 | }


--------------------------------------------------------------------------------
/app/proguard-rules.pro:
--------------------------------------------------------------------------------
 1 | # Add project specific ProGuard rules here.
 2 | # You can control the set of applied configuration files using the
 3 | # proguardFiles setting in build.gradle.
 4 | #
 5 | # For more details, see
 6 | #   http://developer.android.com/guide/developing/tools/proguard.html
 7 | 
 8 | # If your project uses WebView with JS, uncomment the following
 9 | # and specify the fully qualified class name to the JavaScript interface
10 | # class:
11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
12 | #   public *;
13 | #}
14 | 
15 | # Uncomment this to preserve the line number information for
16 | # debugging stack traces.
17 | #-keepattributes SourceFile,LineNumberTable
18 | 
19 | # If you keep the line number information, uncomment this to
20 | # hide the original source file name.
21 | #-renamesourcefileattribute SourceFile
22 | 
23 | -keep class dev.deeplink.sdk.bean.**{*;}


--------------------------------------------------------------------------------
/settings.gradle.kts:
--------------------------------------------------------------------------------
 1 | pluginManagement {
 2 |     repositories {
 3 |         google {
 4 |             content {
 5 |                 includeGroupByRegex("com\\.android.*")
 6 |                 includeGroupByRegex("com\\.google.*")
 7 |                 includeGroupByRegex("androidx.*")
 8 |             }
 9 |         }
10 |         mavenCentral()
11 |         maven { url = uri("https://maven.deeplink.dev/repository/maven-releases/") }
12 |         maven { url = uri("https://jitpack.io") }
13 |         gradlePluginPortal()
14 |     }
15 | }
16 | dependencyResolutionManagement {
17 |     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
18 |     repositories {
19 |         google()
20 |         maven {
21 |             content { include("dev.deeplink") }
22 |             url = uri("https://maven.deeplink.dev/repository/maven-releases/")
23 |         }
24 |         maven { url = uri("https://jitpack.io") }
25 |         mavenCentral()
26 |     }
27 | }
28 | 
29 | rootProject.name = "DeepLinkDemo"
30 | include(":app")
31 |  


--------------------------------------------------------------------------------
/app/build.gradle.kts:
--------------------------------------------------------------------------------
 1 | plugins {
 2 |     alias(libs.plugins.android.application)
 3 |     alias(libs.plugins.jetbrains.kotlin.android)
 4 | }
 5 | 
 6 | android {
 7 |     namespace = "dev.deeplink.sdk.demo"
 8 |     compileSdk = 34
 9 | 
10 |     defaultConfig {
11 |         applicationId = "dev.deeplink.sdk.demo"
12 |         minSdk = 23
13 |         targetSdk = 34
14 |         versionCode = 1
15 |         versionName = "1.0.1"
16 |     }
17 | 
18 |     buildTypes {
19 |         release {
20 |             isMinifyEnabled = true
21 |             proguardFiles(
22 |                 getDefaultProguardFile("proguard-android-optimize.txt"),
23 |                 "proguard-rules.pro"
24 |             )
25 |         }
26 |         debug {
27 |             isMinifyEnabled = true
28 |             proguardFiles(
29 |                 getDefaultProguardFile("proguard-android-optimize.txt"),
30 |                 "proguard-rules.pro"
31 |             )
32 |         }
33 |     }
34 |     compileOptions {
35 |         sourceCompatibility = JavaVersion.VERSION_1_8
36 |         targetCompatibility = JavaVersion.VERSION_1_8
37 |     }
38 |     kotlinOptions {
39 |         jvmTarget = "1.8"
40 |     }
41 | }
42 | 
43 | dependencies {
44 | 
45 |     implementation(libs.androidx.appcompat)
46 |     implementation(libs.material)
47 |     implementation(libs.attribution)
48 |     implementation(libs.appsflyer)
49 | }


--------------------------------------------------------------------------------
/gradle.properties:
--------------------------------------------------------------------------------
 1 | # Project-wide Gradle settings.
 2 | # IDE (e.g. Android Studio) users:
 3 | # Gradle settings configured through the IDE *will override*
 4 | # any settings specified in this file.
 5 | # For more details on how to configure your build environment visit
 6 | # http://www.gradle.org/docs/current/userguide/build_environment.html
 7 | # Specifies the JVM arguments used for the daemon process.
 8 | # The setting is particularly useful for tweaking memory settings.
 9 | org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
10 | # When configured, Gradle will run in incubating parallel mode.
11 | # This option should only be used with decoupled projects. For more details, visit
12 | # https://developer.android.com/r/tools/gradle-multi-project-decoupled-projects
13 | # org.gradle.parallel=true
14 | # AndroidX package structure to make it clearer which packages are bundled with the
15 | # Android operating system, and which are packaged with your app's APK
16 | # https://developer.android.com/topic/libraries/support-library/androidx-rn
17 | android.useAndroidX=true
18 | # Kotlin code style for this project: "official" or "obsolete":
19 | kotlin.code.style=official
20 | # Enables namespacing of each library's R class so that its R class includes only the
21 | # resources declared in the library itself and none from the library's dependencies,
22 | # thereby reducing the size of the R class for that library
23 | android.nonTransitiveRClass=true


--------------------------------------------------------------------------------
/app/src/main/res/drawable-v24/ic_launcher_foreground.xml:
--------------------------------------------------------------------------------
 1 | <vector xmlns:android="http://schemas.android.com/apk/res/android"
 2 |     xmlns:aapt="http://schemas.android.com/aapt"
 3 |     android:width="108dp"
 4 |     android:height="108dp"
 5 |     android:viewportWidth="108"
 6 |     android:viewportHeight="108">
 7 |     <path android:pathData="M31,63.928c0,0 6.4,-11 12.1,-13.1c7.2,-2.6 26,-1.4 26,-1.4l38.1,38.1L107,108.928l-32,-1L31,63.928z">
 8 |         <aapt:attr name="android:fillColor">
 9 |             <gradient
10 |                 android:endX="85.84757"
11 |                 android:endY="92.4963"
12 |                 android:startX="42.9492"
13 |                 android:startY="49.59793"
14 |                 android:type="linear">
15 |                 <item
16 |                     android:color="#44000000"
17 |                     android:offset="0.0" />
18 |                 <item
19 |                     android:color="#00000000"
20 |                     android:offset="1.0" />
21 |             </gradient>
22 |         </aapt:attr>
23 |     </path>
24 |     <path
25 |         android:fillColor="#FFFFFF"
26 |         android:fillType="nonZero"
27 |         android:pathData="M65.3,45.828l3.8,-6.6c0.2,-0.4 0.1,-0.9 -0.3,-1.1c-0.4,-0.2 -0.9,-0.1 -1.1,0.3l-3.9,6.7c-6.3,-2.8 -13.4,-2.8 -19.7,0l-3.9,-6.7c-0.2,-0.4 -0.7,-0.5 -1.1,-0.3C38.8,38.328 38.7,38.828 38.9,39.228l3.8,6.6C36.2,49.428 31.7,56.028 31,63.928h46C76.3,56.028 71.8,49.428 65.3,45.828zM43.4,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2c-0.3,-0.7 -0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C45.3,56.528 44.5,57.328 43.4,57.328L43.4,57.328zM64.6,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2s-0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C66.5,56.528 65.6,57.328 64.6,57.328L64.6,57.328z"
28 |         android:strokeWidth="1"
29 |         android:strokeColor="#00000000" />
30 | </vector>


--------------------------------------------------------------------------------
/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <manifest xmlns:android="http://schemas.android.com/apk/res/android"
 3 |     xmlns:tools="http://schemas.android.com/tools">
 4 | 
 5 |     <application
 6 |         android:name=".CustomApplication"
 7 |         android:allowBackup="true"
 8 |         android:icon="@mipmap/ic_launcher"
 9 |         android:label="@string/app_name"
10 |         android:networkSecurityConfig="@xml/network_config"
11 |         android:roundIcon="@mipmap/ic_launcher_round"
12 |         android:supportsRtl="true"
13 |         android:theme="@style/Theme.DeepLinkDemo"
14 |         tools:targetApi="31">
15 | 
16 |         <activity
17 |             android:name="dev.deeplink.sdk.demo.MainActivity"
18 |             android:exported="true">
19 | 
20 |             <intent-filter>
21 |                 <action android:name="android.intent.action.MAIN" />
22 | 
23 |                 <category android:name="android.intent.category.LAUNCHER" />
24 |             </intent-filter>
25 |         </activity>
26 | 
27 |         <meta-data
28 |             android:name="com.facebook.sdk.ApplicationId"
29 |             android:value="xxxx" />
30 | 
31 |         <meta-data
32 |             android:name="com.facebook.sdk.ClientToken"
33 |             android:value="xxxx" />
34 | 
35 |         <activity
36 |             android:name=".AppLinkActivity"
37 |             android:excludeFromRecents="true"
38 |             android:exported="true"
39 |             android:launchMode="singleTask">
40 | 
41 |             <intent-filter android:autoVerify="true">
42 | 
43 |                 <action android:name="android.intent.action.VIEW" />
44 | 
45 |                 <category android:name="android.intent.category.DEFAULT" />
46 |                 <category android:name="android.intent.category.BROWSABLE" />
47 | 
48 |                 <!-- Replace "https://xxx.deeplink.dev" with your AppLink domain provided by Dlink -->
49 |                 <data
50 |                     android:host="https://xxx.deeplink.dev"
51 |                     android:scheme="https" />
52 |             </intent-filter>
53 | 
54 |         </activity>
55 | 
56 |     </application>
57 | 
58 | </manifest>


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # client-sdk-kotlin
  2 | 
  3 | Step 1: Get the Account ID and DevToken
  4 | 
  5 | Register an account at [https://console.dlink.cloud/](https://console.dlink.cloud). After creating an app on the platform, get the corresponding Account ID and DevToken of the app.
  6 | 
  7 | Step 2: Get the SDK
  8 | 
  9 | (1) Configure the Maven repository
 10 | ```kotlin   
 11 | repositories {
 12 |    maven { url 'https://maven.deeplink.dev/repository/maven-releases/' }
 13 | }
 14 | ```
 15 | 
 16 | Note: The Maven repository address needs to be configured in both 'buildscript' and 'allprojects' in the root directory's 'build.gradle'.
 17 | 
 18 | (2) If you are using Gradle for integration, add the following code to your project's build.gradle:
 19 | ```kotlin
 20 | implementation 'dev.deeplink.sdk:attribution:2.5.0'
 21 | ```
 22 | 
 23 | Step 3: Configure AndroidManifest
 24 | 
 25 | Find the project configuration file AndroidManifest.xml in your project, and add the following permissions:
 26 | 
 27 | ```kotlin
 28 | <uses-permission android:name="android.permission.INTERNET" />
 29 | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 30 | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
 31 | ```
 32 | 
 33 | If you enable FB InstallReferrer attribution, you need to add the following configuration:
 34 | ```kotlin
 35 | <application>
 36 |     <meta-data
 37 |         android:name="com.facebook.sdk.ApplicationId"
 38 |         android:value="xxxx" />
 39 |     <meta-data
 40 |         android:name="com.facebook.sdk.ClientToken"
 41 |         android:value="xxxx" />
 42 | </application>
 43 | ```
 44 | 
 45 | If you enable AppsFlyer, you need to add the following configuration:
 46 | ```kotlin
 47 | implementation("com.appsflyer:af-android-sdk:6.12.2")
 48 | ```
 49 | 
 50 | If you need to add obfuscation during packaging, please add the following code to the obfuscation configuration file:
 51 | ```kotlin
 52 | -keep class dev.deeplink.sdk.bean.**{*;}
 53 | ```
 54 | 
 55 | Step 4: Initialize the SDK
 56 | If your application is in multi-process mode, please initialize the SDK in the main process. Here is the reference code:
 57 | ```kotlin
 58 | public class MainApplication extends Application {
 59 |     @Override
 60 |     public void onCreate() {
 61 |         super.onCreate();
 62 |         if (getBaseContext().getPackageName().equals(getPackageName())) {
 63 |             // Initialize the SDK
 64 |         }
 65 |     }
 66 | }
 67 | ```
 68 | 
 69 | This method must be called before all other SDK methods and be successfully initialized.
 70 | Other methods will not take effect before successful initialization (except for setting common event attributes).
 71 | 
 72 | ```kotlin
 73 | import android.util.Log
 74 | import dev.deeplink.sdk.AttrSdk
 75 | import dev.deeplink.sdk.OnInitializationCallback
 76 | import dev.deeplink.sdk.config.LoggerConfig
 77 | import dev.deeplink.sdk.config.ThirdPartyConfig
 78 | 
 79 | val thirdPartyConfig = ThirdPartyConfig().apply {
 80 |     this.metaAppId = "Meta appId"
 81 |     this.appsFlyerDevKey = "AppsFlyer Dev Key"
 82 | }
 83 | AttrSdk.init(context, "ACCOUNT_ID","DEV_TOKEN", thirdPartyConfig,
 84 |             object : OnInitializationCallback {
 85 |                 override fun onCompleted(code: Int) {
 86 |                     Log.i("Test", "onCompleted -> code($code)")
 87 |                     if (code == 0) {
 88 |                         //Initialization successful
 89 |                     } else {
 90 |                         //Initialization failed, for specific failure reasons refer to the code interpretation
 91 |                     }
 92 |                 }
 93 |             })
 94 | ```
 95 | 
 96 | Step 5: Obtain attribution information
 97 | 
 98 | Obtain attribution results via callback
 99 | 
100 | Developers need to set the attribution information callback interface before the SDK is initialized, otherwise the attribution info callback may not work correctly.
101 | 
102 | ```kotlin
103 | import android.util.Log
104 | import dev.deeplink.sdk.AttrSdk
105 | import dev.deeplink.sdk.OnAttributionListener
106 | import org.json.JSONObject
107 | 
108 | AttrSdk.setOnAttributionListener(object : OnAttributionListener {
109 |     override fun onAttributionSuccess(attribution: JSONObject) {
110 |         Log.i("Test","onAttributionSuccess -> $attribution")
111 |     }
112 |     override fun onAttributionFail(errCode: Int) {
113 |         Log.e("Test","onAttributionFail -> $errCode")
114 |     }
115 | })
116 | AttrSdk.init(context, "ACCOUNT_ID","DEV_TOKEN")
117 | ```
118 | 
119 | Directly obtain attribution results
120 | 
121 | In addition to adding an attribution result callback when initializing the SDK, you can also directly call and obtain the attribution information after the SDK is initialized.
122 | It should be noted that the method for directly obtaining attribution results will return local cache, so if the local cache has not been generated, the attribution result will be null.
123 | 
124 | ```kotlin
125 | import dev.deeplink.sdk.AttrSdk
126 | 
127 | AttrSdk.init(context, "ACCOUNT_ID","DEV_TOKEN")
128 | val attribution = AttrSdk.getAttribution()
129 | ```
130 | 


--------------------------------------------------------------------------------
/app/src/main/res/drawable/ic_launcher_background.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <vector xmlns:android="http://schemas.android.com/apk/res/android"
  3 |     android:width="108dp"
  4 |     android:height="108dp"
  5 |     android:viewportWidth="108"
  6 |     android:viewportHeight="108">
  7 |     <path
  8 |         android:fillColor="#3DDC84"
  9 |         android:pathData="M0,0h108v108h-108z" />
 10 |     <path
 11 |         android:fillColor="#00000000"
 12 |         android:pathData="M9,0L9,108"
 13 |         android:strokeWidth="0.8"
 14 |         android:strokeColor="#33FFFFFF" />
 15 |     <path
 16 |         android:fillColor="#00000000"
 17 |         android:pathData="M19,0L19,108"
 18 |         android:strokeWidth="0.8"
 19 |         android:strokeColor="#33FFFFFF" />
 20 |     <path
 21 |         android:fillColor="#00000000"
 22 |         android:pathData="M29,0L29,108"
 23 |         android:strokeWidth="0.8"
 24 |         android:strokeColor="#33FFFFFF" />
 25 |     <path
 26 |         android:fillColor="#00000000"
 27 |         android:pathData="M39,0L39,108"
 28 |         android:strokeWidth="0.8"
 29 |         android:strokeColor="#33FFFFFF" />
 30 |     <path
 31 |         android:fillColor="#00000000"
 32 |         android:pathData="M49,0L49,108"
 33 |         android:strokeWidth="0.8"
 34 |         android:strokeColor="#33FFFFFF" />
 35 |     <path
 36 |         android:fillColor="#00000000"
 37 |         android:pathData="M59,0L59,108"
 38 |         android:strokeWidth="0.8"
 39 |         android:strokeColor="#33FFFFFF" />
 40 |     <path
 41 |         android:fillColor="#00000000"
 42 |         android:pathData="M69,0L69,108"
 43 |         android:strokeWidth="0.8"
 44 |         android:strokeColor="#33FFFFFF" />
 45 |     <path
 46 |         android:fillColor="#00000000"
 47 |         android:pathData="M79,0L79,108"
 48 |         android:strokeWidth="0.8"
 49 |         android:strokeColor="#33FFFFFF" />
 50 |     <path
 51 |         android:fillColor="#00000000"
 52 |         android:pathData="M89,0L89,108"
 53 |         android:strokeWidth="0.8"
 54 |         android:strokeColor="#33FFFFFF" />
 55 |     <path
 56 |         android:fillColor="#00000000"
 57 |         android:pathData="M99,0L99,108"
 58 |         android:strokeWidth="0.8"
 59 |         android:strokeColor="#33FFFFFF" />
 60 |     <path
 61 |         android:fillColor="#00000000"
 62 |         android:pathData="M0,9L108,9"
 63 |         android:strokeWidth="0.8"
 64 |         android:strokeColor="#33FFFFFF" />
 65 |     <path
 66 |         android:fillColor="#00000000"
 67 |         android:pathData="M0,19L108,19"
 68 |         android:strokeWidth="0.8"
 69 |         android:strokeColor="#33FFFFFF" />
 70 |     <path
 71 |         android:fillColor="#00000000"
 72 |         android:pathData="M0,29L108,29"
 73 |         android:strokeWidth="0.8"
 74 |         android:strokeColor="#33FFFFFF" />
 75 |     <path
 76 |         android:fillColor="#00000000"
 77 |         android:pathData="M0,39L108,39"
 78 |         android:strokeWidth="0.8"
 79 |         android:strokeColor="#33FFFFFF" />
 80 |     <path
 81 |         android:fillColor="#00000000"
 82 |         android:pathData="M0,49L108,49"
 83 |         android:strokeWidth="0.8"
 84 |         android:strokeColor="#33FFFFFF" />
 85 |     <path
 86 |         android:fillColor="#00000000"
 87 |         android:pathData="M0,59L108,59"
 88 |         android:strokeWidth="0.8"
 89 |         android:strokeColor="#33FFFFFF" />
 90 |     <path
 91 |         android:fillColor="#00000000"
 92 |         android:pathData="M0,69L108,69"
 93 |         android:strokeWidth="0.8"
 94 |         android:strokeColor="#33FFFFFF" />
 95 |     <path
 96 |         android:fillColor="#00000000"
 97 |         android:pathData="M0,79L108,79"
 98 |         android:strokeWidth="0.8"
 99 |         android:strokeColor="#33FFFFFF" />
100 |     <path
101 |         android:fillColor="#00000000"
102 |         android:pathData="M0,89L108,89"
103 |         android:strokeWidth="0.8"
104 |         android:strokeColor="#33FFFFFF" />
105 |     <path
106 |         android:fillColor="#00000000"
107 |         android:pathData="M0,99L108,99"
108 |         android:strokeWidth="0.8"
109 |         android:strokeColor="#33FFFFFF" />
110 |     <path
111 |         android:fillColor="#00000000"
112 |         android:pathData="M19,29L89,29"
113 |         android:strokeWidth="0.8"
114 |         android:strokeColor="#33FFFFFF" />
115 |     <path
116 |         android:fillColor="#00000000"
117 |         android:pathData="M19,39L89,39"
118 |         android:strokeWidth="0.8"
119 |         android:strokeColor="#33FFFFFF" />
120 |     <path
121 |         android:fillColor="#00000000"
122 |         android:pathData="M19,49L89,49"
123 |         android:strokeWidth="0.8"
124 |         android:strokeColor="#33FFFFFF" />
125 |     <path
126 |         android:fillColor="#00000000"
127 |         android:pathData="M19,59L89,59"
128 |         android:strokeWidth="0.8"
129 |         android:strokeColor="#33FFFFFF" />
130 |     <path
131 |         android:fillColor="#00000000"
132 |         android:pathData="M19,69L89,69"
133 |         android:strokeWidth="0.8"
134 |         android:strokeColor="#33FFFFFF" />
135 |     <path
136 |         android:fillColor="#00000000"
137 |         android:pathData="M19,79L89,79"
138 |         android:strokeWidth="0.8"
139 |         android:strokeColor="#33FFFFFF" />
140 |     <path
141 |         android:fillColor="#00000000"
142 |         android:pathData="M29,19L29,89"
143 |         android:strokeWidth="0.8"
144 |         android:strokeColor="#33FFFFFF" />
145 |     <path
146 |         android:fillColor="#00000000"
147 |         android:pathData="M39,19L39,89"
148 |         android:strokeWidth="0.8"
149 |         android:strokeColor="#33FFFFFF" />
150 |     <path
151 |         android:fillColor="#00000000"
152 |         android:pathData="M49,19L49,89"
153 |         android:strokeWidth="0.8"
154 |         android:strokeColor="#33FFFFFF" />
155 |     <path
156 |         android:fillColor="#00000000"
157 |         android:pathData="M59,19L59,89"
158 |         android:strokeWidth="0.8"
159 |         android:strokeColor="#33FFFFFF" />
160 |     <path
161 |         android:fillColor="#00000000"
162 |         android:pathData="M69,19L69,89"
163 |         android:strokeWidth="0.8"
164 |         android:strokeColor="#33FFFFFF" />
165 |     <path
166 |         android:fillColor="#00000000"
167 |         android:pathData="M79,19L79,89"
168 |         android:strokeWidth="0.8"
169 |         android:strokeColor="#33FFFFFF" />
170 | </vector>
171 | 


--------------------------------------------------------------------------------
/app/src/main/java/dev/deeplink/sdk/demo/CustomApplication.kt:
--------------------------------------------------------------------------------
  1 | package dev.deeplink.sdk.demo
  2 | 
  3 | import android.app.Application
  4 | import android.util.Log
  5 | import dev.deeplink.sdk.AttrSdk
  6 | import dev.deeplink.sdk.InAppEventType
  7 | import dev.deeplink.sdk.OnAttributionListener
  8 | import dev.deeplink.sdk.OnExtraInfoListener
  9 | import dev.deeplink.sdk.OnInitializationCallback
 10 | import dev.deeplink.sdk.bean.OrderInfo
 11 | import dev.deeplink.sdk.bean.ProductInfo
 12 | import dev.deeplink.sdk.bean.UserInfo
 13 | import dev.deeplink.sdk.config.ThirdPartyConfig
 14 | import org.json.JSONObject
 15 | 
 16 | class CustomApplication : Application() {
 17 | 
 18 |     companion object {
 19 |         private const val TAG = "CustomApplication"
 20 |     }
 21 | 
 22 |     override fun onCreate() {
 23 |         super.onCreate()
 24 | 
 25 |         //[Optional] This property is used to identify the source of the installation package to better understand how users obtain the app.
 26 |         //You can set the property value before initializing the SDK. If not passed in or null is passed in, the default is empty
 27 |         AttrSdk.setPackageSource("PACKAGE_SOURCE")
 28 | 
 29 |         //[Optional] Defaults to false. You can set the property value before initializing the SDK.
 30 |         //When true is passed, it means that the developer wants to customize the device ID.
 31 |         //Attribution and events will be reported only when the developer passes in a custom device ID.
 32 |         //When false is passed, the SDK will generate the device ID internally.
 33 |         AttrSdk.setWaitForDeviceId(true)
 34 | 
 35 |         //[Optional] By default, the SDK will automatically generate a device ID.
 36 |         //The custom device ID passed by the developer will take effect only when AttrSdk.setWaitForDeviceId is passed true.
 37 |         AttrSdk.setDeviceId("DEVICE_ID")
 38 | 
 39 |         //[Optional] Defaults to false. You can set the property value before initializing the SDK.
 40 |         // When true is passed, it means that the developer wants to customize the account ID to associate the account with the attribution information.
 41 |         // Attribution will be reported only if and when the developer passes in a customized account ID.
 42 |         // When false is passed, the SDK will not generate a account ID internally.
 43 |         AttrSdk.setWaitForAccountId(true)
 44 | 
 45 |         //[Optional] Defaults to empty. Used to associate the account system in the developer's business logic with the attribution information.
 46 |         AttrSdk.setAccountId("ACCOUNT_ID")
 47 | 
 48 |         //[Optional] By default, the SDK will automatically obtain Gaid, and developers do not need to set it manually
 49 |         //You can set the property value before initializing the SDK.
 50 |         AttrSdk.setGaid("GAID")
 51 | 
 52 |         //[Optional] For pre-installed apps, developers can pass Custom CampaignName and Custom UtmSource for installation attribution
 53 |         // AttrSdk.setPreInstall(true, "A-B-C-D", "A-B-C-D")
 54 | 
 55 |         AttrSdk.setOnAttributionListener(object : OnAttributionListener {
 56 | 
 57 |             override fun onAttributionSuccess(attribution: JSONObject) {
 58 |                 //Obtain attribution results successfully
 59 |                 Log.i(TAG, "onAttributionSuccess -> $attribution")
 60 |             }
 61 | 
 62 |             override fun onAttributionFail(errCode: Int) {
 63 |                 //Failed to obtain attribution results
 64 |                 Log.e(TAG, "onAttributionFail -> $errCode")
 65 |             }
 66 |         })
 67 | 
 68 |         val thirdPartyConfig = ThirdPartyConfig().apply {
 69 |             //[Optional]
 70 |             this.metaAppId = "META_APP_ID"
 71 |             //[Optional]
 72 |             this.appsFlyerDevKey = "APPS_FLYER_DEV_KEY"
 73 |         }
 74 | 
 75 |         AttrSdk.setOnExtraInfoListener(object : OnExtraInfoListener {
 76 |             override fun onUpdate(value: Map<String, Any>) {
 77 |                 Log.i(TAG, "onUpdate -> $value")
 78 |             }
 79 |         })
 80 | 
 81 |         AttrSdk.init(
 82 |             this, "ACCOUNT_ID", "DEV_TOKEN", thirdPartyConfig,
 83 |             object : OnInitializationCallback {
 84 |                 override fun onCompleted(code: Int) {
 85 |                     Log.i(TAG, "onCompleted -> code($code)")
 86 |                     if (code == 0) {
 87 |                         //Initialization success
 88 |                         logEvents()
 89 |                     } else {
 90 |                         //Initialization failed, for specific failure reasons refer to the code interpretation
 91 |                     }
 92 |                 }
 93 |             })
 94 |     }
 95 | 
 96 |     private fun logEvents() {
 97 |         AttrSdk.setUserInfo(UserInfo().apply {
 98 |             this.countryName = "COUNTRY_NAME"
 99 |             this.city = "CITY"
100 |             this.emails = mutableListOf("EMAIL1", "EMAIL2")
101 |             this.phones = mutableListOf("PHONE1", "PHONE2")
102 |             this.firstName = "FIRST_NAME"
103 |             this.lastName = "LAST_NAME"
104 |             this.fbLoginId = "FB_LOGIN_ID"
105 |         })
106 | 
107 |         //Users enter the product details page.
108 |         AttrSdk.logEvent(InAppEventType.VIEW_CONTENT, hashMapOf<String, Any>().apply {
109 |             this[AttrSdk.ORDER_INFO] = OrderInfo(
110 |                 currency = "", //Ignore
111 |                 value = 0f, //Ignore
112 |                 contents = mutableListOf<ProductInfo>().apply {
113 |                     this.add(
114 |                         ProductInfo(
115 |                             productId = "CONTENT_ID", //Required
116 |                             productName = "CONTENT_NAME", //Required
117 |                             quantity = 1, //Required
118 |                             value = 0f //Ignore
119 |                         )
120 |                     )
121 |                 },
122 |                 searchString = "", //Ignore
123 |                 subscribeDay = "" //Ignore
124 |             )
125 |         })
126 | 
127 |         //The user clicks the "Add to Cart" button.
128 |         AttrSdk.logEvent(InAppEventType.ADD_TO_CART, hashMapOf<String, Any>().apply {
129 |             this[AttrSdk.ORDER_INFO] = OrderInfo(
130 |                 currency = "USD",  //Required
131 |                 value = 9.9f,  //Required, Total Price
132 |                 contents = mutableListOf<ProductInfo>().apply {
133 |                     this.add(
134 |                         ProductInfo(
135 |                             productId = "PRODUCT_ID",  //Required
136 |                             productName = "PRODUCT_NAME",  //Required
137 |                             quantity = 1,  //Required
138 |                             value = 9.9f  //Required, Price Each
139 |                         )
140 |                     )
141 |                 },
142 |                 searchString = "", //Ignore
143 |                 subscribeDay = "" //Ignore
144 |             )
145 |         })
146 | 
147 |         //The user has entered the checkout process, but has not yet completed it.
148 |         AttrSdk.logEvent(InAppEventType.INITIATE_CHECK_OUT, hashMapOf<String, Any>().apply {
149 |             this[AttrSdk.ORDER_INFO] = OrderInfo(
150 |                 currency = "USD",  //Required
151 |                 value = 9.9f,  //Required, Total Price
152 |                 contents = mutableListOf<ProductInfo>().apply {
153 |                     this.add(
154 |                         ProductInfo(
155 |                             productId = "PRODUCT_ID",  //Required
156 |                             productName = "PRODUCT_NAME",  //Required
157 |                             quantity = 1,  //Required
158 |                             value = 9.9f  //Required, Price Each
159 |                         )
160 |                     )
161 |                 },
162 |                 searchString = "", //Ignore
163 |                 subscribeDay = "" //Optional, If it's a subscription product, please enter the number of subscription days.
164 |             )
165 |         })
166 | 
167 |         //
168 |         //Someone has completed the purchase or checkout process.
169 |         AttrSdk.logEvent(InAppEventType.PURCHASE, hashMapOf<String, Any>().apply {
170 |             //Please enter your real order ID.
171 |             this[AttrSdk.EVENT_ID] = "ORDER_ID" //Required
172 |             this[AttrSdk.ORDER_INFO] = OrderInfo(
173 |                 currency = "USD", //Required
174 |                 value = 9.9f,  //Required, Total Price
175 |                 contents = mutableListOf<ProductInfo>().apply {
176 |                     this.add(
177 |                         ProductInfo(
178 |                             productId = "PRODUCT_ID", //Required
179 |                             productName = "PRODUCT_NAME", //Required
180 |                             quantity = 1, //Required
181 |                             value = 9.9f  //Required, Price Each
182 |                         )
183 |                     )
184 |                 },
185 |                 searchString = "",  //Ignore
186 |                 subscribeDay = ""  //Ignore
187 |             )
188 |         })
189 | 
190 |         //Someone has applied for a paid subscription service for the goods or services you provide.
191 |         AttrSdk.logEvent(InAppEventType.SUBSCRIBE, hashMapOf<String, Any>().apply {
192 |             //Please enter your real order ID.
193 |             this[AttrSdk.EVENT_ID] = "ORDER_ID"  //Required
194 |             this[AttrSdk.ORDER_INFO] = OrderInfo(
195 |                 currency = "USD", //Required
196 |                 value = 9.9f,  //Required, Total Price of contents
197 |                 contents = mutableListOf<ProductInfo>().apply {
198 |                     this.add(
199 |                         ProductInfo(
200 |                             productId = "PRODUCT_ID", //Required
201 |                             productName = "PRODUCT_NAME", //Required
202 |                             quantity = 1, //Required
203 |                             value = 9.9f  //Required, Price Each
204 |                         )
205 |                     )
206 |                 },
207 |                 searchString = "",  //Ignore
208 |                 subscribeDay = "30" //Required
209 |             )
210 |         })
211 |     }
212 | }


--------------------------------------------------------------------------------