アンインストール計測

Androidアンインストール計測

Firebase Messagingを使用したアンインストール計測は、Android SDKバージョン4.7.0以降でサポートされています。

1. Firebaseサーバーキーの取得

1. Firebase Android Applicationプロジェクトを作成（まだ作成していない場合）、または Google Developer Consoleからプロジェクトを移行します（Google Developer Consoleの手順に従ってください）。詳細は、Firebaseをご覧ください。
2. Firebase Consoleを開きます。
3. Firebase Consoleページで、Project Settings（プロジェクト設定）に移動します（ページの左パネルでOverview（概要）の横にある歯車をクリック）。
4. [Cloud Messaging] タブで、2つのサーバーキーを確認できます（下のスクリーンショットを参照）：
   
   
5. サーバーキーをコピーします。

2. AppsFlyer管理画面でサーバーキーを入力する

1. AppsFlyerのアプリ管理画面に移動します。
2. 左側のメニューから アプリの設定 を選択します。

   

3. サーバーキーをコピーしてFireBaseサーバーキーを設定します。

3. アプリでFirebase-Messagingを設定する

1. Firebase consoleから google-services.json をダウンロードしてください。
2. google-services.json をアプリのモジュールディレクトリに追加します。
3. ルートレベルのbuild.gradleファイルにルールを追加して、google-servicesプラグインを含めます。

   buildscript { 
       // ... 
       dependencies { 
         // ... 
         classpath 'com.google.gms:google-services:4.2.0' // google-services plugin 
       } 
     }
   

4. アプリレベルのbuild.gradleファイルにFCM dependencyを追加します。

   dependencies {
      implementation 'com.google.firebase:firebase-messaging:17.3.4'
   }
   
   // ADD THIS AT THE BOTTOM 
   apply plugin: 'com.google.gms.google-services
   

Firebaseの最新バージョンはこちら：Firebase公式ドキュメント

「見つかりませんでした..」というエラーが表示される場合は、Android SDK Managerで最新のGoogleリポジトリを使用していることを確認してください。 

4. AppsFlyerアンインストール計測サービスの実装

<application
   <!-- ... -->
      <service
        android:name="com.appsflyer.FirebaseMessagingServiceListener">
        <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT"/>
        </intent-filter>
      </service>
   <!-- ... -->
</application>

import com.appsflyer.AppsFlyerLib;
import com.google.firebase.messaging.FirebaseMessagingService;

public class MyNewFirebaseManager extends FirebaseMessagingService {

    @Override
    public void onNewToken(String s) {
        super.onNewToken(s);

        // Sending new token to AppsFlyer
       	       AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), s);

        // the rest of the code that makes use of the token goes in this method as well
    }
}

AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), refreshedToken); 

<service
    android:name=".MyNewFirebaseManager">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

@Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        
        if(remoteMessage.getData().containsKey("af-uinstall-tracking")){
            return;
        } else {
           // handleNotification(remoteMessage);
        }
    }

5. Proguardを使用したアンインストール計測

ProGuardを使用している場合は、次のルールを追加します。

-dontwarn com.appsflyer.**
-keep public class com.google.firebase.messaging.FirebaseMessagingService {
  public *;
}

6. Androidアンインストール計測のテスト

アンインストール指標はオーバービュー管理画面で確認できます。

アプリをアンインストールしたユーザーのリストは、アンインストール ローデータレポートからご利用いただけます。

Androidアンインストール計測のテスト方法：

1. アプリをインストールします。
2. アプリをアンインストールします。 注！アプリをインストール後すぐにアンインストールできます。
   アンインストール計測は毎日処理されるため、アンインストールイベントは24時間以内に登録されます。
   アプリがこの最中に再インストールされた場合は、アンインストールイベントは記録されません。

アプリのアンインストールイベントは、AppsFlyerのローデータレポートと集計パフォーマンスレポートに反映されるまでに最大48時間かかります。

テスト方法は、AndroidアプリがGoogle Playでリリース済み、リリースの保留中、外部ストアで公開されていても同じです。

7. アンインストール計測を無効にする

Firebase/GCM サーバーキーが提供されている場合、アプリのアンインストール計測はデフォルトで有効になります。アプリ所有者はこの機能を管理画面上で無効にできます。

注！アンインストールを計測するには、アプリインストールのプロセスで、[Enable uninstalls measurement] を有効にする必要があります。アプリをインストールするデバイスが [Enable uninstalls measurement] を無効にした場合、アプリのアンインストールは計測されません。

アンインストール計測を無効にする方法：

1. AppsFlyerにて、アプリ設定を開きます。
2. アトリビューション > アンインストールへスクロールダウンし、アンインストール計測を利用するをオフにします。
   

   

iOSアンインストール計測

1. アプリを見つける

2. アプリIDをまだ登録していない場合は、 + アイコンをクリックして、フォームに入力します。

3. Push Notifications（プッシュ通知）チェックボックスを選択します。

4. アプリケーションを展開すると、 黄色または緑色のステータスアイコンが付いたプッシュ通知の設定が2つ表示されます。

5.  Settings （設定）をクリックして続行します。

2. 証明書を生成する

3. 証明書を更新する

開発用または本番環境用のプッシュSSL証明書を更新する場合は、証明書を初めてアップロードする場合と同様に、上記の手順に沿って操作します。この変更を行うために、以前の証明書を失効させる必要はありません。新しい証明書をアップロードする際に古い証明書を引き続き使用できるようにするため、本番環境用の証明書を同時に2つ作成することができます。

4. P12ファイルをエクスポートする

AppsFlyer管理画面に戻る前の最後の手順として、署名する証明書を.p12ファイルとして保存します。

1. キーチェーンアクセスに先ほど追加した証明書を選択します 

2. ファイル > エクスポートアイテム をクリックします

3.  左下のCategory（カテゴリ）メニューで My Certificates を選択します。

 My Certificates がハイライト表示されていない場合は、p12ファイルとして証明書をエクスポートできません。

3. ファイルを保存する際に、Personal Information Exchange (.p12)形式 を使用します。

4. Apple Push Services（Appleプッシュサービス）と記載され、次のように表示されていることを確認します。

5. AppsFlyerプラットフォームでアプリの管理画面に移動します。

6. 左側のメニューで App Settings を選択します。

7. アップロードアイコンをクリックし、アップロードするP12ファイルを選択します。

8.（オプション）P12 certificate がパスワードで保護されている場合は、 P12証明書のパスワード にパスワードを入力します。

9. Validate（検証）をクリックして、有効であるかを確認するために証明書をAppsFlyerに送信します。 

10. Save Settings をクリックします。

5. SDKの実装

アンインストールデータの収集を有効にするため、プッシュ通知はアプリのコードレベルで登録する必要があります。

	//add UserNotifications.framework
	import UserNotifications
	func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    //...
    // iOS 10 support
    if #available(iOS 10, *) {
      UNUserNotificationCenter.current().requestAuthorization(options:[.badge, .alert, .sound]){ (granted, error) in }
      application.registerForRemoteNotifications()
    }
    // iOS 9 and iOS 8 support
    else if #available(iOS 8, *), #available(iOS 9, *) {
      UIApplication.shared.registerUserNotificationSettings(UIUserNotificationSettings(types: [.badge, .sound, .alert], categories: nil))
      UIApplication.shared.registerForRemoteNotifications()
    }

    // iOS 7 support
    else {
      application.registerForRemoteNotifications(matching: [.badge, .sound, .alert])
    }
    
    return true
  }

 // Called when the application sucessfuly registers for push notifications
  func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    AppsFlyerTracker.shared().registerUninstall(deviceToken)
  }

- #import <UserNotifications/UserNotifications.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The userNotificationTypes below is just an example and may be changed depending on the app
 UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
          center.delegate = self;
          [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
          }];
   [[UIApplication sharedApplication] registerForRemoteNotifications];
    // if you do not use push notificaiton in your app, uncomment the following line
    //application.applicationIconBadgeNumber = 0;
  }
  - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [[AppsFlyerTracker sharedTracker] registerUninstall:deviceToken];
  }
  }

#import <AppsFlyerLib/AppsFlyerTracker.h>
@interface AppDelegate : UIResponder <UIApplicationDelegate, AppsFlyerTrackerDelegate>

上記のコードスニペットは、ユーザーにプッシュ通知を送信する権限をリクエストします。ただし、アンインストールの測定にプッシュ通知をバックグラウンドモードでのみ使用している場合は、ユーザーの承認を求める必要はありません。これらのプッシュ通知がサイレントプッシュ通知しているので、ユーザーからの許可を求める必要がありません。

バックグラウンドモードでのプッシュ通知のユーザー権限

サイレントプッシュ通知のみを使用している場合は、アプリのCapabilitiesでバックグラウンドモードの リモート通知を必ず有効にしてください。

1. XCodeでプロジェクトを選択します
2. ターゲットを選択してください
3. Capabilities（機能）タブに切り替えます
4. バックグラウンドモード をオンにします
5. リモート通知 にチェックを入れます
   
   

6. プッシュ通知

XCode capabilities（XCode機能）タブに必ずプッシュ通知を追加します。これを追加しない場合、deviceTokenが 収集されません。

7. アンインストールをテストする

iOSアンインストール計測のテスト：

1. アプリをインストールします。
2. アプリをアンインストールします。 注！アプリをインストールした直後にアンインストールできます。

Xcode または TestFlight からアンインストールテストをする場合は、トークンがサンドボックス環境から生成されていることをSDKに知らせることが重要です。次のAPIを使用します：

AppsFlyerTracker.shared().useUninstallSandbox = true

[AppsFlyerTracker sharedTracker].useUninstallSandbox = true;

注意！アンインストールはAppsFlyer管理画面には即座に表示されません。

• アンインストールがレポートに表示されるまでに平均9日かかります
• サンドボックス環境から発生したアンインストールがレポートに表示されるには、 1 か月以上 かかる場合もあります。

また、アンインストールの日付は、 アンインストールが報告された日付です 。詳しくは、以下のセクションをご覧ください。

8. AppsFlyer管理画面でアンインストールデータを確認する

アンインストール計測は、集約されたパフォーマンステーブルのメインダッシュボードに表示されます。

Appleプッシュ通知サービスの直近の変更により、アンインストールがダッシュボードに表示されるまでに最低9日かかります。 AppsFlyerは、24時間ごとのアンインストールのメトリックを更新および集計します

詳細については、SDK統合ガイドの iOSアプリのアンインストール計測を参照してください。

9. アンインストール計測を無効にする

P12証明書が提供され有効である場合、アプリのアンインストール計測はデフォルトで有効になります。アプリ所有者はこの機能を管理画面上で無効にできます。

注！アンインストールを計測するには、アプリインストールのプロセスで、[Enable uninstalls measurement] を有効にする必要があります。アプリをインストールするデバイスが [Enable uninstalls measurement] を無効にした場合、アプリのアンインストールは計測されません。

アンインストール計測を無効にする方法：

1. AppsFlyerにて、アプリ設定を開きます。
2. アトリビューション > アンインストールへスクロールダウンし、アンインストール計測を利用するをオフにします。
   

   

アンインストールイベントのポストバック

AppsFlyerを使用すると、アンインストールが認知された全てのユーザーに対して、連携しているパートナーにアンインストールイベントポストバックを送信できます。アンインストールイベントはAppsFlyer管理画面上で af_uninstallと表示されます。

アンインストールイベントのマッピング

アプリのアプリ内イベントをマッピングするのと同様に、af_uninstallイベントをマッピングできます。

アプリ内イベントと同様に、AppsFlyerは、イベントが実際に発生してAppsFlyerによって記録された場合にのみポストバックを送信できます。したがって、 af_uninstallのマッピングは、アンインストール計測の実装が完了した場合のみ機能します。オーバービュー管理画面またはアンインストールのローデータレポートにアンインストールが表示されない場合、af_uninstallイベントをマッピングしていても、アンインストールポストバックはパートナーに送信されません。

af_uninstall のタイミング

通常のアプリ内イベントのポストバックと異なり、af_uninstall イベントはリアルタイムで送信されません。

AppsFlyerのローデータとパートナーポストバックでは、af_uninstall に紐づくイベント時刻は、AppsFlyerがアンインストールを認識した時刻を指します。

• Androidデバイスの場合：実際のアンインストールから24-48時間後
• iOSデバイスの場合：実際のアンインストールから9-11日後

制限事項

af_uninstall イベントは、アプリ内イベントポストバックレポートに含まれません。

現在、af_uninstall イベントはすべてのパートナーで利用できるわけではありません。

パートナーとのマッピングを希望するが、そのイベントがパートナーにはない場合は、専任のCSMにお問い合わせいただくか、hello@appsflyer.com までご連絡ください。

あなたがパートナーで、af_uninstallイベントを受け取りたい場合は、専任のPDMにお問い合わせいただくか、partners@appsflyer.com までご連絡ください。