アンインストール測定

Androidアンインストール計測

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

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

1. 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のアンインストール計測の実装テストは非常に簡単です。

AndroidアプリがGoogle Playで公開されているか、リリースの保留中であるか、さらにはストア外であるかどうかにかかわらず、テストの手順は同じです。単にデバイスからアプリをアンインストールするのみです。

管理画面の集計パフォーマンスレポートテーブルと、アンインストールのローデータレポートにアプリの新しいアンインストールイベントが表示されるには、最長24時間かかります。

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. アンインストールをテストする

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

AppsFlyerTracker.shared().useUninstallSandbox = true

[AppsFlyerTracker sharedTracker].useUninstallSandbox = true;

インストールしてからアンインストールするまで、一定の時間待つ必要はありません。アプリをインストールしてすぐにアンインストールできます。

ただし、ダッシュボードに実際のアンインストールが表示されるまでには、インストールから最大9日かかる場合があります。また、アンインストール日は、実際のアンインストール日から9日後です。詳しくは、以下のセクションをご覧ください。

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

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

Appleプッシュ通知サービスの直近の変更により、アンインストールがダッシュボードに表示されるまでに最低9日かかります。

詳細については、SDK統合ガイドの iOS Track App Uninstalls（iOSでのアプリアンインストールのトラッキング）セクション を参照してください。

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

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

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

アプリのいずれのアプリ内イベントをマッピングするのと同じように、af_uninstall イベントをマッピングできます。

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

af_uninstall のタイミング

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

AppsFlyerのローデータとパートナーへのポストバックのaf_uninstallログイベント時間は、AppsFlyerがアンインストールを認識した時間です。これは、実際のアプリのアンインストールから24時間以内に発生します。

制限事項

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

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

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

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