テスターからフィードバックを収集する

Firebase App Distribution Android SDK はベータ版リリースです。これは、機能が下位互換性のない方法で変更される可能性があることを意味します。ベータ版リリースは、SLA または非推奨ポリシーの対象ではなく、サポートが限定的であるか、またはサポートがまったく提供されない場合があります。

このガイドでは、オプションの Firebase App Distribution Android SDK を使用してアプリ内フィードバックを有効にし、テスターがアプリから直接フィードバック（スクリーンショットを含む）を送信できるようにする方法を説明します。

始める前に

まだ Firebase を Android プロジェクトに追加していない場合は追加します。

注: Firebase プロジェクトにアプリが複数ある場合は、App Distribution で配布するアプリに独自の google-services.json 構成ファイルがあることを確認してください。詳細については、複数の環境をサポートするをご覧ください。

ステップ 1: App Distribution Tester API を有効にする

1. Google Cloud コンソールを開き、Firebase プロジェクトを選択します。

2. [Firebase App Testers API] で [有効にする] をクリックします。

ステップ 2: App Distribution をアプリに追加する

App Distribution Android SDK は、次の 2 つのライブラリで構成されています。

• firebase-appdistribution-api: API のみのライブラリ。すべてのビルド バリアントに含めることができます。
• firebase-appdistribution: SDK の完全な実装（オプション）。

注意: 新しいビルドに関するテスターへの通知などの機能をサポートするために、App Distribution Android SDK の完全な実装には自己更新機能が含まれています。これは、そのコードがランタイムで実行されない場合でも、Google Play ポリシーに違反しているとみなされる可能性があります。そのため、この SDK の完全な実装を削除せずに Google Play にアプリを提出すると、アプリが Google Play から削除される可能性があります。

API のみのライブラリを使用すると、コードから SDK を呼び出せます。SDK の完全な実装がない場合、この呼び出しは無視されます。

1. モジュール（アプリレベル）の Gradle ファイル（通常は <project>/<app-module>/build.gradle.kts または <project>/<app-module>/build.gradle）で App Distribution Android SDK の依存関係を宣言します。

2. SDK の完全な実装にある自己更新機能が Google Play ビルドに含まれないようにするには、App Distribution を通して配布するビルドタイプやプロダクト フレーバーなどのビルド バリアントを指定します。

3. モジュール（アプリレベル）の Gradle ファイル（通常は app/build.gradle）で App Distribution Android SDK の依存関係を宣言します。SDK の完全な実装は、リリース前のテスト専用のバリアントにのみ追加してください。

   Kotlin

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta14")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14")
   }

   Java

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta14")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14")
   }

ステップ 3: アプリ内フィードバックを構成する

テスターからフィードバックを収集するには、次のいずれかのトリガーを使用して、テスターがフィードバックを開始できるようにします。

• 組み込み通知トリガー: App Distribution Android SDK では、テスターがアプリのどこからでもタップできる進行中の通知を表示できます。このトリガーは、テストを迅速に開始し、テスターがフィードバックを提供する方法をカスタマイズする必要がない場合に使用します。

• カスタム トリガー: アプリでボタンやメニュー アイテムをタップしたり、デバイスをシェイクしたりするなど、独自のトリガー メカニズムを指定できます。

これらのトリガーのいずれかを使用して、テスターがフィードバックを送信すると、Android SDK は次のアクションを実行します。

1. アプリの現在のアクティビティのスクリーンショットをキャプチャします。

2. テスターが SDK のテスト機能を有効にしていることを確認するためのチェックを実行します。テスト機能が有効になっていない場合、Android SDK はテスターに Google アカウントで App Distribution にログインするように求めます。

   注: テスト機能の有効化はテストデバイスで 1 回限り実行するプロセスであり、アプリがアップデートされても保持されます。テスターがアプリをアンインストールするか、アプリが signOutTester メソッドを呼び出すまで、テストデバイスでテスト機能は有効のままです。

3. テスターがフィードバックを作成して送信できる全画面アクティビティを開始します。

オプション 1: 通知トリガー

showFeedbackNotification() を使用すると、テスターのデバイスに永続的または継続的な通知が表示され、テスターはタップしてフィードバックを開始できます。通知を構成する際には、フィードバックを送信する前にテスターに表示されるテキストと、通知の中断レベル（通知チャネルの重要度に対応）を指定する必要があります。フィードバック データの収集と処理についてテスターに通知する場合は、テキストを使用してそのような通知を提供できます。

showFeedbackNotification() を使用していて、アプリがバックグラウンドに移動した場合、通知は非表示になります。通知を明示的に非表示にするには、cancelFeedbackNotification() を使用します。メイン アクティビティの onCreate() には showFeedbackNotification() を含めることをおすすめします。

Kotlin

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Firebase.appDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH)
    }
}

Java

public class MainActivity extends AppCompatActivity {
    FirebaseAppDistribution firebaseAppDistribution =
        FirebaseAppDistribution.getInstance();
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        firebaseAppDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH);
    }
}

注: Android 13 以降では、このメソッドには通知を送信するための実行時の権限 POST_NOTIFICATIONS が必要です。Android 13（API レベル 33）以降をターゲットとするアプリの場合、権限を宣言して、次に実行時にリクエストする必要があります。

オプション 2: カスタム トリガー

startFeedback() メソッドを使用して、任意のメカニズムでフィードバックを開始します。たとえば、フィードバックをトリガーするには、アプリのアクション メニューに「フィードバックを送信」メニュー項目を追加するか、テスターがデバイスを振るまたはスクリーンショットを撮るようにします。フィードバックをトリガーする際、フィードバックの送信前にテスターに表示されるテキストを指定します。フィードバック データの収集と処理についてテスターに通知する場合は、テキストを使用してそのような通知を提供できます。

Kotlin

Firebase.appDistribution.startFeedback(R.string.feedbackMessage)

Java

FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);

ステップ 4: 実装をビルドしてテストする

ローカルテスト

最初にアプリを配布することなく実装をテストするには、次の手順を行います。

1. ローカル デバイスでデベロッパー モードを有効にします。

   adb shell setprop debug.firebase.appdistro.devmode true

2. App Distribution ライブラリ全体を含むプレリリース バリアントとしてアプリをビルドし、ステップ 3: アプリ内フィードバックを構成するで実装したメカニズムを使用してフィードバックをトリガーできることをテストします。デベロッパー モードではフィードバックは送信されません。

3. テストの後、デバイスでデベロッパー モードを無効にできます。

   adb shell setprop debug.firebase.appdistro.devmode false

エンドツーエンドのテスト

注: デフォルトでは、新しいフィードバックによって、Firebase プロジェクトのオーナーと編集者全員にメールとコンソール内アラートがトリガーされます。

アプリでフィードバックを送信できるかをテストするには、App Distribution ライブラリ全体を含むプレリリース バリアントとしてアプリをビルドし、次の手順で実装をテストします。

1. 新しいアプリのリリースを App Distribution にアップロードします。

2. アクセス権限のあるアカウントにアプリのリリースを配布します。

3. App Distribution のウェブまたは Android のテスターアプリからアプリをダウンロードします。

4. ステップ 3: アプリ内フィードバックを構成するで実装したメカニズムを使用してフィードバックをトリガーします。

5. アプリのリリースを配布したアカウントと同じアカウントでログインし、フィードバックを送信します。

6. Firebase コンソールの新しいリリースのカードでフィードバックを確認します。

注意: アプリを Google Play ストアにリリースする前に、アプリをテストして、API のみのライブラリの依存関係が含まれており、フィードバック メカニズムがリリース バリアントに含まれていないことを確認します。詳しくは、ステップ 2: App Distribution をアプリに追加するをご覧ください。

テスターがアプリでフィードバックを開始できない場合など、一般的な問題の解決方法については、SDK でテスト機能を有効にするをご覧ください。

ステップ 5: テスターのフィードバックを管理する

テスターがフィードバックを送信できるようにしたら、次のツールを使用してフィードバックを確認し、対応できます。

• Firebase コンソール

• 新しいフィードバックのメール通知

• サードパーティ製ツール

Firebase コンソールでフィードバックを表示、削除する

スクリーンショットを含むユーザー フィードバックを確認したり削除したりするには、Firebase コンソールで特定のリリースの下にある [テスターのフィードバック] タブを開きます。ユーザー フィードバックはリリースごとに整理されているため、フィードバックが適用されるバージョンを確認できます。

確認が済んだユーザー フィードバックは、[フィードバックを削除] ボタンをクリックして削除できます。削除したフィードバックはリリースから削除されます。

新しいフィードバックに関するメール通知アラートを受信する

新しいテスターのフィードバックを積極的に把握できるようにするために、テスターがフィードバックを送信したときにメール通知アラートを受け取ることができます。メール通知アラートには、テスターから提供されたフィードバックの内容と、送信されたスクリーンショットへのリンクが含まれています。

このデフォルトのメカニズムを介して App Distribution のメール通知アラートを受信するには、firebase.projects.update 権限が必要です。必要となるこの権限は、Firebase 管理者、プロジェクトのオーナーまたは編集者のロールにデフォルトで含まれています。

デフォルトでは、新しいフィードバック レポートが送信されると、メール通知アラートを受信するために必要な権限を持つすべてのプロジェクト メンバーがメール通知アラートを受け取ります。プロジェクト メンバーは、このようなアラートを個別に無効にできます。

メール通知アラートを無効にするには、Firebase アラートを受信するをご覧ください。

サードパーティ ツールに新しいフィードバックを送信する

Cloud Functions for Firebase を使用して、App Distribution アラートをチームの希望する通知チャンネルに送信することもできます。たとえば、関数を作成して、新しいアプリ内フィードバックのアラート イベントをキャプチャし、アラート情報を Discord、Slack、Jira などのサードパーティのサービスに送信するようなことができます。

注: 高度なアラート機能を使用するには、Firebase プロジェクトで Blaze 料金プランを使用する必要があります。

Cloud Functions for Firebase を使用して高度なアラート機能を設定するには、次の手順を行います。

1. Cloud Functions for Firebase を設定します。これには、次のタスクが含まれます。

   1. Node.js と npm をダウンロードします。

   2. Firebase CLI をインストールしてログインする。

   3. Firebase CLI を使用して Cloud Functions for Firebase を初期化する。

2. App Distribution からアプリ内フィードバックのアラート イベントをキャプチャし、イベントのペイロードを処理する（たとえば Discord のメッセージにアラート情報を投稿する）関数を記述してデプロイします。

Jira に新しいフィードバックを送信する方法の例については、こちらのサンプルをご覧ください。

キャプチャできるすべてのアラート イベントについては、App Distribution のアラートのリファレンス ドキュメントをご覧ください。