卸载与重装监测

使用 Adjust 安卓 SDK 监测卸载和重装。Adjust 使用推送标签向用户设备发送静默推送通知并检查您的应用是否处于已安装状态。

按照以下说明来为您的应用添加此功能。

操作前须知

以下是您在操作前需要了解的内容。

要求

将 Google FCM 关联到 Adjust

通过 Google Firebase Cloud Messaging (FCM) API 配置静默推送通知后，您就可以监测卸载和重装。Adjust 需要 FCM HTTP v1 API 私钥才能连接至 Google FCM。

Google Cloud console

1. 为 Adjust 卸载和重装监测创建自定义角色

访问您的Google Cloud Console 。
选择与 Firebase 项目关联的 Google Cloud 项目。
搜索 IAM & 管理员 (IAM & Admin) 。
从侧栏菜单中选择 角色 (Roles) 。
选择 + 新建角色 (Create Role) 。
输入以下详细信息：
1. Title : Adjust Uninstall
2. ID : adjust_uninstall
3. Role launch stage : General Availability
选择 + 添加权限 (Add Permissions) 。
在 输入属性名称或值 (Enter property name or value) 字段中输入cloudmessaging.messages.create并从搜索结果中进行选择。
勾选 cloudmessaging.messages.create 选项，然后选择 添加 (Add) 。
选择创建。

2. 创建一个服务账户

在侧栏菜单中选择 服务账户 (Service Accounts) 。
选择 + 创建服务账号 (Create Service Account) 。
在 服务账户名称 (Service account name) 字段中输入Adjust Uninstall Service Account 。
选择 Create and Continue (创建并继续) 。
选择 选择角色 (Select a role) 下拉菜单。输入Adjust Uninstall并从搜索结果中选择。
选择 Continue (继续)。
选择 完成 (Done) 。

3. 生成并下载私人密钥

选择新创建的服务账户。格式如下：adjust-uninstall-service-account@test3-55065.iam.gserviceaccount.com。
选择 密钥 (Keys) 标签页。
选择 添加密钥 (Add Key) > 创建新密钥 (Create new key) 。
选择 JSON 然后选择 创建 (Create) 。私人密钥将以 JSON 文件格式下载到您的电脑中。

在 Adjust 控制面板中

现在您已经获得了将 Adjust 连接到 Google FCM 所需的私人密钥详细信息，接下来需要在 AppView 的应用配置中启用卸载与重装监测：

选择平台标签页。
选择编辑。
在 高级设置 下，找到 记录卸载和重装数据 选项。
选择 添加关联 。随后将会弹出一个对话框，提示您添加 Adjust 和 Google FCM 之间的关联。
填写必要信息，包括您最近生成的 FCM 私人密钥。 合作伙伴 和服务字段会自动填充。
选择关联。
查看应用设置，然后选择保存。

集成 Adjust SDK

按照以下说明集成 FCM 与 Adjust SDK

确保您的build.gradle文件中有 Firebase Messaging 所需的依赖：

1
dependencies {
2
   // ...
3
   implementation 'com.google.firebase:firebase-messaging:23.4.0'
4
   // ...
5
}

在安卓端设置 Firebase Cloud Messaging 客户端应用，请按照Google 文档中的说明进行操作 (如您还未进行此操作)。
将设备的推送标签发送到 Adjust SDK。
- 如果您向应用发送自己的推送通知，请确保改写FirebaseMessagingService类中的onMessageReceived方法，使之可处理所有类型推送通知，包括 Adjust 的卸载和重装监测静默推送通知。

示例

以下代码片段展示了如何扩展FirebaseMessagingService类以将推送标签传送至 Adjust SDK，并更新推送通知处理逻辑。如果您不自己发送推送通知，则可以跳过onMessageReceived方法的改写。

Kotlin
Java

1
import com.adjust.sdk.Adjust
2
import com.adjust.sdk.Util
3
import com.google.firebase.messaging.FirebaseMessaging
4
import com.google.firebase.messaging.FirebaseMessagingService
5
import com.google.firebase.messaging.RemoteMessage
6

7
class MyFirebaseMessagingService : FirebaseMessagingService() {
8

9
  override fun onCreate() {
10
    super.onCreate()
11
    // Fetch FCM token and set in Adjust SDK
12
    FirebaseMessaging.getInstance().token
13
      .addOnCompleteListener { task ->
14
        if (task.isSuccessful && task.result != null) {
15
          Adjust.setPushToken(task.result, applicationContext)
16
        }
17
      }
18
  }
19

20
  override fun onNewToken(token: String) {
21
    super.onNewToken(token)
22

23
    // Receive new FCM token and set in Adjust SDK
24
    Adjust.setPushToken(token, applicationContext)
25
  }
26

27
  override fun onMessageReceived(remoteMessage: RemoteMessage) {
28
    super.onMessageReceived(remoteMessage)
29

30
    // Check if message has data payload
31
    if (remoteMessage.data.isNotEmpty()) {
32
      val payload: Map<String, String> = remoteMessage.data
33

34
      // Check for Adjust uninstall detection data message
35
      if (Util.isAdjustUninstallDetectionPayload(payload)) {
36
        // No handling required for Adjust data payload
37
      } else {
38
        // Handle other data payloads here
39
      }
40
    }
41

42
    // Check if message has notification payload
43
    remoteMessage.notification?.let {
44
      // Handle notification payload here
45
    }
46
  }
47
}

1
import com.adjust.sdk.Adjust;
2
import com.adjust.sdk.Util;
3
import com.google.firebase.messaging.FirebaseMessagingService;
4
import com.google.firebase.messaging.RemoteMessage;
5
import java.util.Map;
6

7
public class MyFirebaseMessagingService extends FirebaseMessagingService {
8

9
  @Override
10
  public void onCreate() {
11
    super.onCreate();
12
    // Fetch FCM token and set in Adjust SDK
13
    FirebaseMessaging.getInstance().getToken()
14
      .addOnCompleteListener(task -> {
15
        if (task.isSuccessful() && task.getResult() != null) {
16
          Adjust.setPushToken(task.getResult(),getApplicationContext());
17
        }
18
      });
19
  }
20

21
  @Override
22
  public void onNewToken(String token) {
23
    super.onNewToken(token);
24

25
    // Receive new FCM token and set in Adjust SDK
26
    Adjust.setPushToken(token, getApplicationContext());
27
  }
28

29
  @Override
30
  public void onMessageReceived(RemoteMessage remoteMessage) {
31
    super.onMessageReceived(remoteMessage);
32

33
    // Check if message has data payload
34
    if (!remoteMessage.getData().isEmpty()) {
35
      Map<String, String> payload = remoteMessage.getData();
36

37
      // Check for Adjust uninstall detection data message
38
      if (Util.isAdjustUninstallDetectionPayload(payload)) {
39
        // No handling required for Adjust data payload
40
      } else {
41
        // Handle other data payloads here
42
      }
43
    }
44

45
    // Check if message has notification payload
46
    if (remoteMessage.getNotification() != null) {
47
      // Handle notification payload here
48
    }
49
  }
50
}

在初始化 Adjust SDK 前，在您的应用中初始化 Firebase 实例。

示例

以下是安卓项目中应用程序类的示例。您可以看到应用一启动就初始化了 Firebase 实例。

Kotlin
Java

1
import android.app.Application
2
import com.adjust.sdk.Adjust
3
import com.adjust.sdk.AdjustConfig
4
import com.google.firebase.FirebaseApp
5

6
class MyApp : Application() {
7

8
  override fun onCreate() {
9
    super.onCreate()
10

11
    // Initialize Firebase App
12
    FirebaseApp.initializeApp(this)
13

14
    // Configure Adjust SDK
15
    // Replace {YourAppToken} with your Adjust app token
16
    val appToken = "{YourAppToken}"
17
    val environment = AdjustConfig.ENVIRONMENT_PRODUCTION
18
    val config = AdjustConfig(this, appToken, environment)
19

20
    // Initialize Adjust SDK
21
    Adjust.onCreate(config)
22
  }
23
}

1
import android.app.Application;
2
import com.adjust.sdk.Adjust;
3
import com.adjust.sdk.AdjustConfig;
4
import com.google.firebase.FirebaseApp;
5

6
public class MyApp extends Application {
7

8
  @Override
9
  public void onCreate() {
10
    super.onCreate();
11

12
    // Initialize Firebase App
13
    FirebaseApp.initializeApp(this);
14

15
    // Configure Adjust SDK
16
    // Replace {YourAppToken} with your Adjust app token
17
    String appToken = "{YourAppToken}";
18
    String environment = AdjustConfig.ENVIRONMENT_PRODUCTION;
19
    AdjustConfig config = new AdjustConfig(this, appToken, environment);
20

21
    // Initialize Adjust SDK
22
    Adjust.onCreate(config);
23
  }
24
}

测试集成

Adjust 会检查生产环境中记录了最后一次活动的设备上的安卓应用卸载情况。

要测试卸载和重装监测，您可以使用调试或发布版本。最主要的是在测试安装时，您必须将 Adjust SDK 环境设置为 Production (生产) 。

要测试卸载监测：

在 Adjust SDK 中将环境设置为AdjustConfig.ENVIRONMENT_PRODUCTION，然后再初始化 Adjust SDK。
在测试设备或模拟器上安装应用。
打开应用。
打开 Adjust 的测试控制台。
输入您的 设备 ID ，然后选择 查看设备数据
在 应用信息 部分：
- Install state (安装状态) 应显示为 Installed (已安装) 。
- Push token (推送标签) 应当存在值。
卸载应用。
24 小时后，请再次查看测试控制台，因为 Adjust 每天检查一次卸载。在 应用信息 部分下的 Install state (安装状态) 应显示 Uninstalled (已卸载) 。

状态从 已安装 变为已 已卸载 可确保卸载与重装监测功能正常运行。如果您还想测试重装监测，请按照下列步骤操作：

在测试设备或模拟器中重新安装调试或发布版本。
打开应用。
24 小时后请再次查看测试控制台，Adjust 会每天检查一次重装。在 App information (应用信息) 部分下， Install state (安装状态) 现在应显示为 Reinstalled (已重装) 。

故障排除

以下是测试卸载和重装监测时最常见的问题：

进行测试安装时，Adjust SDK 的环境会设置为AdjustConfig.ENVIRONMENT_SANDBOX 。该设置不支持卸载和重装监测。请确保在 Adjust SDK 中将此设置设为AdjustConfig.ENVIRONMENT_PRODUCTION 。
推送标签缺失。如果推送标签未出现在测试控制台中，则可能是您的 Firebase 安装或 Firebase SDK 与 Adjust SDK 集成代码出现了问题。请仔细检查这些元素。
FCM HTTP v1 API 私人密钥出现问题。例如，您生成的私人密钥可能属于错误的项目，或您在 Adjust suite 中输入的详细信息有误。请查看这些要点并联系您的技术客户经理或发送邮件至support@adjust.com，请同时提供设备的推送标签。他们可以提取日志以检查来自 Google API 的响应。

解决问题后，请按照以下步骤再次测试集成情况：

卸载应用。
在测试控制台中输入您的 设备 ID ，然后选择 查看设备数据 > 遗忘设备 。
重复测试集成部分所述的步骤。