Android：Google三方库之Adjust集成详细步骤

通过 Adjust 安卓 SDK，您可以在自己的安卓应用中跟踪归因、事件及更多数据。请按照本指南中说明的步骤操作，在应用内设置 Adjust SDK

1、添加依赖

        //adjustimplementation("com.adjust.sdk:adjust-android:4.33.5")implementation("com.android.installreferrer:installreferrer:2.2")

2、添加Google Play服务

Google Play 商店中的应用需要使用 Google 广告 ID 来识别设备。要为我们的 SDK 启用 Google 广告 ID，您需要集成 Google Play 服务。为此请将 Google Play 服务库加入您的项目。将下列 dependency 加入build.gradle 文件的 dependencies 部分。

        //google servicesimplementation("com.google.android.gms:play-services-ads-identifier:18.0.1")

3、收集 App Set Identifier（用了firebase可以不用这个）

App Set Identifier 是一个唯一标识符，用户在设备上安装您的应用后，您可以通过此标识符监测这些应用的信息。同一位开发者开发的所有应用共享同一个 App Set ID，也就是说您可以从所有应用中收集有用的洞见。要记录设备的 App Set ID，您需要向build.gradle 文件中添加下列权限：

        implementation("com.google.android.gms:play-services-appset:16.0.2")

4、添加权限

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

如果您的应用并非面向 Google Play 商店，请添加以下权限：

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

5、设置混淆：proguard-rules.pro

#adjust
-keep class com.adjust.sdk.**{ *; }
-keep class com.google.android.gms.common.ConnectionResult {int SUCCESS;
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {java.lang.String getId();boolean isLimitAdTrackingEnabled();
}
-keep public class com.android.installreferrer.**{ *; }

应用不在 Google Play 商店发布，请添加下列 com.adjust.sdk 规则：

-keep public class com.adjust.sdk.**{ *; }

6、设置 Install Referrer

Install Referrer 是一种唯一标识符，可用来将应用安装归因至来源。Adjust SDK 需要该信息进行归因。（使用 Google Play Referrer API方式获取：前面已经集成依赖）

/*** 获取安装来源信息的函数* 在application中调用这个方法*/
private fun getInstallReferrer(applicationContext:Context) {val installReferrerClient = InstallReferrerClient.newBuilder(applicationContext).build()installReferrerClient.startConnection(object : InstallReferrerStateListener {override fun onInstallReferrerSetupFinished(responseCode: Int) {when (responseCode) {InstallReferrerClient.InstallReferrerResponse.OK -> {val response: ReferrerDetails = installReferrerClient.installReferrerval referrerUrl: String = response.installReferrerval referrerClickTime: Long = response.referrerClickTimestampSecondsval appInstallTime: Long = response.installBeginTimestampSeconds// 这里可以处理安装来源信息// ...// 将安装来源信息传递给 Adjust SDKAdjust.setReferrer(referrerUrl, applicationContext)//断开服务连接installReferrerClient.endConnection()}// ...}}override fun onInstallReferrerServiceDisconnected() {// 安装来源服务断开连接// ...}})
}

7、初始化（Application 类中onCreate 方法。）

         //配置Adjustval environment = if (BuildConfig.IS_DEBUG) {AdjustConfig.ENVIRONMENT_SANDBOX} else {AdjustConfig.ENVIRONMENT_PRODUCTION}val config = AdjustConfig(this, "{YourAppToken}", environment)config.setLogLevel(LogLevel.VERBOSE)Adjust.onCreate(config)

注意：在进行测试时，应当确保将环境设置为 AdjustConfig.ENVIRONMENT_SANDBOX 。请在向 App Store 提交应用程序前将此设为 AdjustConfig.ENVIRONMENT_PRODUCTION 。

8、设置会话跟踪

        registerActivityLifecycleCallbacks(object : ActivityLifecycleCallbacks {override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}override fun onActivityStarted(activity: Activity) {}override fun onActivityResumed(activity: Activity) {Adjust.onResume()}override fun onActivityPaused(activity: Activity) {Adjust.onPause()}override fun onActivityStopped(activity: Activity) {}override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}override fun onActivityDestroyed(activity: Activity) {}})