SDK do Flutter - Rastreamento de desinstalação

Documento

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

  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 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

    dart
    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;
      }
    }
  3. 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

    dart
    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:
dart
// iOS
Singular.registerDeviceTokenForUninstall(apnsToken);
            
// Android
Singular.registerDeviceTokenForUninstall(fcmToken);