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
-
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:
- Configuração do rastreamento de desinstalação do Android
- Configuração do rastreamento de desinstalação do iOS
Certifique-se de que a configuração esteja concluída antes de continuar.
-
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:
- iOS: @react-native-firebase/messaging ou react-native-push-notification.
- Android: @react-native-firebase/messaging.
Exemplo de código
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; } }
-
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
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:
import { Platform } from 'react-native';
if (Platform.OS === 'ios') {
// Handle APNS token
} else if (Platform.OS === 'android') {
// Handle FCM token
}