Flutter SDK - 卸载跟踪

文档

跟踪应用程序卸载

本指南介绍如何使用 Singular SDK 使 Singular 跟踪应用程序的卸载情况。

前提条件

  • 在 Singular 平台中配置了应用程序的 Singular 账户。
  • 项目中已安装 Singular SDK。详见《SDK 安装指南》
  • 熟悉检索 APNS(iOS)或 FCM(Android)令牌。

启用卸载跟踪的步骤

  1. 在 Singular 中配置卸载跟踪

    登录 Singular 平台并导航至应用程序的设置。按照特定平台的设置说明进行卸载跟踪:

    确保配置完成后再继续。

  2. 获取 APNS 或 FCM 令牌

    要在 Flutter 应用程序中获取 iOS 上的 APNs(苹果推送通知服务)令牌和 Android 上的 FCM(Firebase消息)令牌,最好的方法是使用firebase_messaging软件包。该软件包为检索推送通知令牌提供了一个跨平台、可靠且维护良好的解决方案,可无缝处理 APN 和 FCM 令牌。

    创建一个与下面示例类似的函数。

    代码示例

    dart
    import 'package:firebase_messaging/firebase_messaging.dart';
    
    Future<String?> getPushToken() async {
      try {
        final token = await FirebaseMessaging.instance.getToken();
        if (token != null) {
          print('APNs/FCM Token: $token');
          return token;
        } else {
          print('No token received');
          return null;
        }
      } catch (error) {
        print('Error retrieving push token: $error');
        return null;
      }
    }
  3. 将令牌传递给 Singular

    使用registerDeviceTokenForUninstall方法向 Singular 发送 APNS 或 FCM 令牌。确保根据设备平台(iOS 或 Android)传递正确的令牌。

    代码示例

    dart
    import Singular from 'react-native-singular';
    
    // Call this function when your app initializes or after token retrieval
    Singular.registerDeviceTokenForUninstall(token);

特定平台注意事项

  • iOS:确保您的应用程序拥有必要的推送通知权限,并正确配置了 APNS。
  • 安卓:确认已在 Firebase 控制台中设置 FCM,且项目中包含google-services.json 文件。

故障排除

  • 令牌未注册?在调用setUninstallToken 之前,请确认令牌有效且 Singular SDK 已初始化。
  • 平台不匹配?使用平台检测功能确保传递的令牌类型正确:
dart
// iOS
Singular.registerDeviceTokenForUninstall(apnsToken);
            
// Android
Singular.registerDeviceTokenForUninstall(fcmToken);