Flutter SDK - アンインストールトラッキング

ドキュメント

アプリのアンインストールを追跡する

このガイドでは、Singular SDKを使用してアプリのアンインストールを追跡できるようにする方法を説明します。

前提条件

  • アプリがSingularプラットフォームに設定されたSingularアカウント。
  • プロジェクトにインストールされたSingular SDK。詳細はSDKインストールガイドをご覧ください。
  • APNS (iOS) または FCM (Android) トークンの取得に精通していること。

アンインストールトラッキングを有効にする手順

  1. Singular でアンインストールトラッキングを設定する

    Singular プラットフォームにログインし、アプリの設定に移動します。アンインストールトラッキングのプラットフォーム固有のセットアップ手順に従ってください:

    先に進む前に、設定が完了していることを確認してください。

  2. APNSまたはFCMトークンの取得

    FlutterアプリでiOSのAPNs (Apple Push Notification service)トークンとAndroidのFCM (Firebase Cloud Messaging)トークンを取得するには、firebase_messagingパッケージを使うのが一番です。このパッケージは、APNとFCMトークンの両方をシームレスに扱い、プッシュ通知トークンを取得するための、クロスプラットフォームで、信頼性が高く、よくメンテナンスされたソリューションを提供します。

    以下の例のような関数を作成します。

    コードサンプル

    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. トークンをSingularに渡す

    registerDeviceTokenForUninstallメソッドを使用して、APNS または FCM トークンを Singular に送信します。デバイスプラットフォーム(iOS または Android)に基づいて正しいトークンが渡されるようにします。

    コードサンプル

    dart
    import Singular from 'react-native-singular';
    
    // Call this function when your app initializes or after token retrieval
    Singular.registerDeviceTokenForUninstall(token);

プラットフォーム固有の注意事項

  • iOS:アプリに必要なプッシュ通知権限があり、APNS が適切に設定されていることを確認してください。
  • Android:FCMがFirebaseコンソールで設定され、google-services.json ファイルがプロジェクトに含まれていることを確認してください。

トラブルシューティング

  • トークンが登録されない setUninstallToken を呼び出す前に、トークンが有効で、Singular SDK が初期化されていることを確認してください。
  • プラットフォームが不一致ですか?プラットフォーム検出を使用して、正しいトークンタイプが渡されることを確認してください:
dart
// iOS
Singular.registerDeviceTokenForUninstall(apnsToken);
            
// Android
Singular.registerDeviceTokenForUninstall(fcmToken);