SDK do React Native - Rastreamento de desinstalação

Documento

Rastreando desinstalações de aplicativos

Este guia explica como habilitar o Singular para rastrear desinstalações para seu aplicativo usando o Singular SDK do React Native.

Pré-requisitos

  • Uma conta Singular com seu aplicativo configurado na plataforma Singular.
  • O SDK do Singular React Native instalado em seu projeto. Consulte o Guia de Instalação do SDK para obter detalhes.
  • Familiaridade com a recuperação de tokens APNS (iOS) ou FCM (Android) no React Native.

Etapas para habilitar o rastreamento de desinstalação

  1. Configurar o rastreamento de desinstalação no Singular

    Faça login na plataforma Singular e navegue até as configurações do seu aplicativo. Siga as instruções de configuração específicas da plataforma para o rastreamento de desinstalação:

    Certifique-se de que a configuração esteja concluída antes de continuar.

  2. Recuperar o Token APNS ou FCM

    Use seu método preferido para obter o token APNS (para iOS) ou o token FCM (para Android) em seu aplicativo React Native. Bibliotecas de exemplo:

    Exemplo de código

    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. Passar o token para o Singular

    Use o método setUninstallToken para enviar o token APNS ou FCM para a Singular. Certifique-se de que o token correto é passado com base na plataforma do dispositivo (iOS ou Android).

    Exemplo de código

    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();

Notas específicas da plataforma

  • iOS: Certifique-se de que seu aplicativo tenha os direitos de notificação por push necessários e que o APNS esteja configurado corretamente.
  • Android: Verifique se o FCM está configurado no seu console do Firebase e se o arquivo google-services.json está incluído no seu projeto.

Solução de problemas

  • O token não está sendo registrado? Confirme se o token é válido e se o Singular SDK foi inicializado antes de chamar setUninstallToken.
  • Incompatibilidade de plataforma? Use a deteção de plataforma para garantir que o tipo de token correto seja passado:
javascript
import { Platform } from 'react-native';

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