React Native SDK - 卸载跟踪

关注
Avatar
Jared Ornstead
Updated
文档

跟踪应用程序卸载

本指南介绍如何使用 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
}