adjust-icon

卸载与重装监测

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

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

操作前须知

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

要求

将 Google FCM 关联到 Adjust

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

Google Cloud console

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

  1. 访问您的Google Cloud Console 。

  2. 选择与 Firebase 项目关联的 Google Cloud 项目。

  3. 搜索 IAM & 管理员 (IAM & Admin) 。

  4. 从侧栏菜单中选择 角色 (Roles) 。

  5. 选择 + 新建角色 (Create Role) 。

  6. 输入以下详细信息：

    1. Title : Adjust Uninstall
    2. ID : adjust_uninstall
    3. Role launch stage : General Availability

  7. 选择 + 添加权限 (Add Permissions) 。

  8. 在 输入属性名称或值 (Enter property name or value) 字段中输入cloudmessaging.messages.create并从搜索结果中进行选择。

  9. 勾选 cloudmessaging.messages.create 选项，然后选择 添加 (Add) 。

  10. 选择 创建 。

2. 创建一个服务账户

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

3. 生成并下载私人密钥

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

在 Adjust 控制面板中

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

  1. 选择 平台 标签页。
  2. 选择 编辑 。 平台设置
  3. Under Advanced settings , find the Record uninstall and reinstall data option. Advanced settings
  4. 选择 添加关联 。随后将会弹出一个对话框，提示您添加 Adjust 和 Google FCM 之间的关联。 新关联窗口
  5. 填写必要信息，包括您最近生成的 FCM 私人密钥。 合作伙伴 和 服务 字段会自动填充。
  6. 选择 关联 。
  7. 查看应用设置，然后选择 保存 。

集成 Adjust SDK

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

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

    dependencies {
       // ...
       implementation 'com.google.firebase:firebase-messaging:23.4.0'
       // ...
    }

  2. Set up a Firebase Cloud Messaging client app on Android following Google’s documentation, if you haven’t already done so.

  3. 将设备的推送标签发送到 Adjust SDK。

    • 如果您向应用发送自己的推送通知，请确保改写FirebaseMessagingService类中的onMessageReceived方法，使之可处理所有类型推送通知，包括 Adjust 的卸载和重装监测静默推送通知。

示例

The following code snippet shows how you can extend the FirebaseMessagingService class to pass the push token to the Adjust SDK, and to update your push notification handling logic. If you aren’t sending your own push notifications, you can skip the override of the onMessageReceived method.

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

示例

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

测试集成

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

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

要测试卸载监测：

  1. 在 Adjust SDK 中将环境设置为AdjustConfig.ENVIRONMENT_PRODUCTION，然后再初始化 Adjust SDK。

  2. 在测试设备或模拟器上安装应用。

  3. 打开应用。

  4. 打开 Adjust 的测试控制台。

  5. 输入您的 设备 ID ，然后选择 查看设备数据

  6. 在 应用信息 部分：

    • Install state (安装状态) 应显示为 Installed (已安装) 。
    • Push token (推送标签) 应当存在值。

  7. 卸载应用。

  8. 24 小时后，请再次查看测试控制台，因为 Adjust 每天检查一次卸载。在 应用信息 部分下的 Install state (安装状态) 应显示 Uninstalled (已卸载) 。

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

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

故障排除

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

  • 进行测试安装时，Adjust SDK 的环境会设置为AdjustConfig.ENVIRONMENT_SANDBOX 。该设置不支持卸载和重装监测。请确保在 Adjust SDK 中将此设置设为AdjustConfig.ENVIRONMENT_PRODUCTION 。
  • The push token is missing. If the push token doesn’t appear in the Testing Console, there might be something wrong with your Firebase implementation or with the code that integrates the Firebase SDK and the Adjust SDK. Review these elements of your implementation.
  • FCM HTTP v1 API 私人密钥出现问题。例如，您生成的私人密钥可能属于错误的项目，或您在 Adjust suite 中输入的详细信息有误。请查看这些要点并联系您的技术客户经理或发送邮件至support@adjust.com，请同时提供设备的推送标签。他们可以提取日志以检查来自 Google API 的响应。

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

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