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

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

1、添加依赖

        //adjust        implementation("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 services        implementation("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、添加权限

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

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.installReferrer                    val referrerUrl: String = response.installReferrer                    val referrerClickTime: Long = response.referrerClickTimestampSeconds                    val appInstallTime: Long = response.installBeginTimestampSeconds                    // 这里可以处理安装来源信息                    // ...                    // 将安装来源信息传递给 Adjust SDK                    Adjust.setReferrer(referrerUrl, applicationContext)                    //断开服务连接                    installReferrerClient.endConnection()                }                // ...            }        }        override fun onInstallReferrerServiceDisconnected() {            // 安装来源服务断开连接            // ...        }    })}

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

         //配置Adjust        val 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 。

1、​如果需要获取Adjust 设备标识符​AdjustConfig config = new AdjustConfig(this, appToken, environment);config.setOnAttributionChangedListener(newOnAttributionChangedListener() {    @Override    public void onAttributionChanged(AdjustAttribution attribution) {        String adid = Adjust.getAdid();    }});Adjust.onCreate(config);2、获取gps_adid（在SDK初始化后获取）Adjust.getGoogleAdId(this, new OnDeviceIdsRead() {    @Override    public void onGoogleAdIdRead(String googleAdId) {}});

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) {            }        })