中文

开始使用安卓 SDK

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

第 1 步:设置环境

要开始使用 Adjust SDK,您首先要将其作为 dependency 添加至项目中。

请注意:
Adjust SDK 集成支持的最低安卓 API 级别为 9 (Gingerbread)。web view 扩展支持的最低安卓 API 级别为 17 (Jelly Bean)。

Maven

作为 JAR 添加

第 2 步:添加 Google Play 服务

Google Play 商店中的应用必须使用 Google 广告 ID 来识别设备。为了让 Adjust SDK 能使用 Google 广告 ID,您需要集成 Google Play 服务。为此,请将 Google Play 服务库加入您的项目。将下列 dependency 加入 build.gradle 文件的 dependencies 块中。

dependencies {
   implementation 'com.google.android.gms:play-services-ads-identifier:17.0.1'
}
请注意:
Adjust SDK 并不与任何版本的 play-services-analytics dependency 绑定。您可以使用任意版本的 Google Play 服务库。

第 3 步:添加权限

Adjust SDK 需要下列权限。如果尚未添加,请将权限加入您的 AndroidManifest.xml 文件中:

<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"/>

如果您针对的是 Android 12 及更高版本 (API level 31),则需要添加com.google.android.gms.AD_ID许可来读取设备的广告 ID。

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

要了解更多信息,请查看Google 的AdvertisingIdClient.Info文档

第 4 步:设置 Proguard

如果您在应用中使用 Proguard,请将如下行添加至您的 Proguard 文件:

-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.**{ *; }

第 5 步:设置 Install Referrer

Install Referrer 是一种唯一标识符,可用来将应用安装归因至来源。Adjust SDK 需要该信息进行归因。您可以用下列 3 种方法收集 install referrer:

  • 使用 Google Play Referrer API
  • 使用广播接收器监听INSTALL_REFERRERintent。
  • 使用华为 Referrer API (仅限华为设备)。
重要提示:
Google 已不再使用 INSTALL_REFERRER intent 方法 传递 referrer 信息。如果您当前在使用这种方法,请迁移至 Google Play Referrer API。

Google Play Referrer API

INSTALL_REFERRER intent

华为 Referrer API

第 6 步:集成 SDK 至您的应用

如果您要将 Adjust SDK 集成至标准应用,请按照标准 SDK 设置步骤操作。如果您要将 SDK 集成到使用 web view,请按照 Web view SDK 设置步骤操作。

标准 SDK

Web View SDK

第 7 步:设置会话跟踪

您需要设置会话跟踪,SDK 才能向 Adjust 后端传送会话信息。请按照下列说明操作,在应用中进行会话跟踪设置。

API level 14 及更高

API level 9 至 13

第 8 步:设置日志

要设置日志级别,请在 config 实例上调用 setLogLevel 方法。

Java

Javascript

如果希望禁用所有日志,请将日志级别设为 suppress

Java

Javascript

第 9 步:创建应用

太好了!您现在可以创建并运行应用了。请启用日志,检查可能存在的问题。您现在已经准备就绪,可以使用 Adjust SDK 归因用户了。