Acompanhamento de desinstalações de aplicativos
Este guia explica como habilitar o Singular para rastrear desinstalações de seu aplicativo usando o SDK do Singular.
Pré-requisitos
- Uma conta Singular com seu aplicativo configurado na plataforma Singular.
- O SDK do Singular 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).
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 APNS ou o Token FCM
Para obter o token APNs (Apple Push Notification service) no iOS e o token FCM (Firebase Cloud Messaging) no Android em um aplicativo Flutter, a melhor abordagem é usar o pacote firebase_messaging. Este pacote fornece uma solução multiplataforma, confiável e bem mantida para recuperar tokens de notificação push, lidando com APNs e tokens FCM sem problemas.
Crie uma função semelhante ao exemplo abaixo.
Exemplo de código
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; } }
-
Passar o token para o Singular
Use o método registerDeviceTokenForUninstall 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'; // Call this function when your app initializes or after token retrieval Singular.registerDeviceTokenForUninstall(token);
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:
// iOS
Singular.registerDeviceTokenForUninstall(apnsToken);
// Android
Singular.registerDeviceTokenForUninstall(fcmToken);