卸载追踪设置 - Flutter SDK (v4)

Airbridge 会向过去 6 个月内执行过至少 1 次 App 事件的用户发送静默推送通知,以检查用户是否已卸载 App。此静默推送通知在每天 UTC 15:00 至 16:00 之间发送。App 卸载事件可在 Airbridge 报告和通过导出原始数据查看。

凭证输入

需要在 Airbridge 面板输入 Apple Developer 和 Google Cloud 控制台凭证。

从 Apple Developer 获取凭证

请从 Apple Developer 获取 4 项凭证:

从 Google Cloud 控制台获取凭证

请通过以下 3 个步骤从 Google Cloud 控制台获取凭证。

在 Airbridge 面板输入凭证

请输入各平台的凭证。

iOS

请在 Airbridge 面板导航至 [设置]>[卸载追踪]>[iOS App 卸载追踪],输入从 Apple Developer 获取的所有凭证。

App 环境选择

在 Airbridge 面板完成所有凭证的输入后,请选择要收集推送 Token 的 App 环境。根据所选 App 环境,收集的推送 Token 将不同。例如,在 “生产” 环境中收集的推送 Token 无法在 “开发” 环境中使用。

Android

请按照以下步骤在 Airbridge 面板输入凭证。

1. 请在 Airbridge 面板导航至 [设置]>[卸载追踪]。

2. 请在 [Android] 页面上传从 Google Cloud 控制台下载的 JSON 文件。

3. 您可将文件拖放到上传区域或点击上传区域进行文件搜索和上传。

静默推送测试

各平台的静默推送通知测试详情如下。

iOS

您可通过点击 “测试静默推送” 按钮,检查静默推送通知是否根据已输入的凭证成功发送至设备。静默推送测试既不监测也不创建实际卸载事件,因此 Airbridge 面板上不会显示任何卸载事件。

此外,卸载追踪所需的 Bundle ID 只能通过静默推送测试来验证其有效性,因此,建议进行静默推送测试。

为了进行静默推送测试,需要 APNs 推送 Token(Device Token)。由于根据 App 环境收集的推送 Token 不同,在进行静默推送测试之前,需要确认推送 Token 和 App 环境。有关确认 APNs 推送 Token 的方法,请参阅 Apple Developer 文档

当 Airbridge 向设备发送静默推送通知时,您可以查看成功消息或错误代码。可以通过 iOS 静默推送测试查看的主要错误代码如下。有关错误代码的更多信息,请参阅 Apple Developer 文档

注意

iOS Simulator 无法进行静默推送测试。

Android

您可以通过测试静默推送通知以检查静默推送通知是否正常发送至设备。请点击 “测试静默推送” 按钮,并输入测试设备的 FCM 注册 Token。获取 FCM 注册 Token 的方法,请参阅 Firebase 文档

当静默推送通知成功发送至测试设备时,您可以查看成功消息。对于已卸载 App 的测试设备,可以查看 404 错误代码。

以下是在 Android 环境测试静默推送通知时可能遇到的主要错误代码。有关错误代码的更多信息,请参阅 Firebase 文档

静默推送通知测试既不监测也不创建实际 App 卸载事件,因此不会影响 Airbridge 面板上的 App 卸载事件数据。因此,无法通过静默推送通知测试在 Airbridge 报告或通过导出原始数据查看是否发生了 App 卸载事件。

Airbridge SDK 设置

为了追踪 App 卸载事件,需要完成 Airbridge SDK 设置。

推送通知设置

Airbridge 通过静默推送通知追踪 App 卸载情况,因此请确保 App 已启用接收推送通知。

推送 Token 传递

当推送 Token 生成后,请调用 registerPushToken 函数,将该 Token 传递至 SDK。

123
import 'package:airbridge_flutter_sdk/airbridge_flutter_sdk.dart';
...
Airbridge.registerPushToken(token);

注意

iOS 需传递 APNs 推送 Token,Android 需传递 Firebase 推送 Token。

忽略静默推送通知设置

为了卸载追踪发送的静默推送通知,不应该在 App 中显示给用户。为了使 App 忽略此静默推送通知,请参见以下代码设置:

1234567
import 'package:airbridge_flutter_sdk/airbridge_flutter_sdk.dart';
...
if (Airbridge.isUninstallTrackingNotification(payload)) {
    // app uninstall tracking push by airbridge.
    // ignore these push notifications.
    return
}

卸载追踪启用

在 Airbridge 面板输入凭证并完成 Airbridge SDK 设置后,即可打开 “启用 App 卸载追踪” 切换按钮开始追踪卸载。有关卸载追踪的更多信息,请参阅 本指南

Was this page helpful?

Have any questions or suggestions?