React Native SDK - 卸载跟踪

文档

跟踪应用程序卸载

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

前提条件

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

启用卸载跟踪的步骤

  1. 在 Singular 中配置卸载跟踪

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

    确保配置完成后再继续。

  2. 获取 APNS 或 FCM 令牌

    在 React Native 应用程序中使用首选方法获取 APNS 令牌(适用于 iOS)或 FCM 令牌(适用于 Android)。示例库:

    代码示例

    javascript
    import messaging from '@react-native-firebase/messaging';
    
    async function getPushToken() {
      try {
        const token = await messaging().getToken();
        return token;
      } catch (error) {
        console.error('Error retrieving push token:', error);
        return null;
      }
    }
  3. 将令牌传递给 Singular

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

    代码示例

    javascript
    import Singular from 'react-native-singular';
    
    async function registerUninstallTracking() {
      const token = await getPushToken();
      if (token) {
        Singular.setUninstallToken(token);
        console.log('Uninstall token registered:', token);
      } else {
        console.warn('No token available for uninstall tracking');
      }
    }
    
    // Call this function when your app initializes or after token retrieval
    registerUninstallTracking();

特定平台注意事项

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

故障排除

  • 令牌未注册?在调用setUninstallToken 之前,确认令牌有效且 Singular SDK 已初始化。
  • 平台不匹配?使用平台检测功能确保传递的令牌类型正确:
javascript
import { Platform } from 'react-native';

if (Platform.OS === 'ios') {
  // Handle APNS token
} else if (Platform.OS === 'android') {
  // Handle FCM token
}