文档

安卓卸载跟踪使用 Firebase 云消息服务。Firebase 将于2024 年 7 月 22 日淘汰传统 HTTP API。如果您仍在使用传统 HTTP API，请通过 Singular 应用程序配置页面更新为使用HTTP V1 API。了解更多信息。

Singular为您提供了跟踪应用程序卸载情况的选项，这是另一种衡量您通过营销活动获得的流量质量的方法。该功能在 Singular Android SDK 7.x+ 版本中提供，启用该功能需要更新应用程序。

注意事项：

Singular 的卸载跟踪利用了谷歌服务，但使用的方法与谷歌不同。谷歌直接从设备上的操作系统报告卸载情况。因此，谷歌报告的数据可能与 Singular 报告的数据不同。
卸载在 Singular 中作为事件进行跟踪，因此不会从源头安装或再参与源移除归因链接。这可能会导致卸载率高于 100%，因为用户在一生中可能会多次卸载应用程序。

如果为您的 Google 组织启用了 "域限制共享"，请将 "单一组织 ID "应用到 "允许值"：

修改域限制共享策略

访问组织策略
在 Google Cloud Console 中，导航到 "组织策略"页面。
选择要设置策略的组织资源。
从列表中查找并选择域限制共享约束。
单击管理策略。

将组织 ID 添加到允许值

在 "策略值"下，选择 "自定义"。

按格式输入组织资源 ID：

is:principalSet://iam.googleapis.com/organizations/626787461583

设置说明

HTTP V1 API

集成 Android SDK 7.x 以上版本：卸载跟踪功能在 Android SDK 7.x 及以上版本中可用。有关升级 SDK 的说明，请查看我们的Android SDK 集成指南。
修改 AndroidManifest.xml：详见Android SDK 卸载跟踪指南。
在Singular Apps 页面>App>Advanced Settings>Uninstall Tracking 中输入项目 ID。

要创建和配置项目 ID
1. 转到Firebase 云信使控制台
2. 选择或创建新项目
3. 导航至 "项目概览">"项目设置"，然后复制您的项目 ID。 在后续步骤中授予项目适当的角色和权限后，您需要在 Singular 应用程序页面中输入项目ID。
4. 导航至 "云消息 "并启用Firebase 云消息 API (V1)，为项目启用 FCM云消息功能
5. 导航至服务帐户 > 管理服务帐户权限
6. 分配正确的项目角色和权限
  1. 选择左侧导航菜单中的角色
  2. 单击创建角色 并输入以下信息
    标题：奇异卸载跟踪
    ID:singular_uninstalls
    角色启动阶段：一般可用性
  3. 单击添加权限 并添加cloudmessaging.messages.create。 您可以通过 Firebase 云消息 API 管理器上的筛选快速找到它。
  4. 单击创建完成角色创建
7. 将 Singular 指派给角色
  1. 在左侧导航菜单中选择IAM
  2. 在 "权限"选项卡中，单击 "授予访问
  3. 在"添加负责人 ">" 新负责人"下，键入：
    
    singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com
  4. 在 "分配角色"下，选择之前步骤中创建的"Singular 卸载跟踪"。
    
    最终配置应匹配：
  5. 单击保存

(传统）HTTP API

在 Android 中设置卸载跟踪：

集成 Android SDK 7.x 以上版本：卸载跟踪功能在 Android SDK 7.x 及以上版本中可用。有关升级 SDK 的说明，请查看我们的Android SDK 集成指南。
修改 AndroidManifest.xml：详见Android SDK 卸载跟踪指南。
添加发送方 ID 和服务器密钥：Singular 需要谷歌项目编号和服务器密钥才能启用卸载跟踪。要检索这些值，请
- 在 Firebase 中，选择转到控制台并选择项目。
- 选择齿轮图标，进入 "项目设置">"云消息"。
- 在您的 Singular 账户中，转到 "设置">"应用程序"，找到要跟踪卸载的应用程序，然后选择 "编辑"。
- 在卸载跟踪下，添加项目编号（Firebase 上的发件人 ID） 和服务器密钥。
在应用程序中配置 FCM，如下所示：
1. 在 Firebase 控制台中，创建一个 Firebase 项目。
2. 在项目仪表板中，选择将Firebase 添加到你的 Android 应用程序。
3. 输入 Android 应用程序的软件包 ID。
4. 下载配置文件（google-services.json）并将其复制到 Android 项目的应用程序模块中。
5. 在项目级 build.gradle 文件（><project>/build.gradle>）中添加以下内容：
```
buildscript {
   dependencies {
     // Add this line or latest version 
     classpath 'com.google.gms:google-services:3.1.0'
   }
 }
```
6. 在应用程序级 build.gradle 文件 (><project>/<app-module>/build.gradle>) 中，添加以下内容：
```
// Add to the bottom of the file
apply plugin: 'com.google.gms.google-services'
```
7. 同步项目。
8. 在 Android 代码中，创建以下服务：
```
public class FCMService extends FirebaseInstanceIdService {
    @Override
    public void onTokenRefresh() {
        super.onTokenRefresh();
        //now we will have the token                   
        String token = FirebaseInstanceId.getInstance().getToken();
    }
}
```
  onTokenRefresh 方法会获取发送通知所需的 FCM 令牌。
9. 将该服务添加到 Android 清单文件中：
```
<service android:name=".FCMService">
 <intent-filter>
 <action android:name="com.google.firebase.INSTANCE_ID_EVENT"/
 </intent-filter>
</service>
```

现在，Singular 将跟踪拥有更新版本应用程序的用户的卸载情况。

测试通知

你可以通过提供一个 FCM 令牌，使用控制台测试通知：

Screen_Shot_2017-12-27_at_4.56.12_PM.png

设置 Android 卸载跟踪

设置说明

要创建和配置项目 ID

测试通知