Feedback von Testern einholen

In dieser Anleitung wird beschrieben, wie Sie mit dem optionalen Firebase App Distribution Android SDK In-App-Feedback aktivieren, damit Ihre Tester Feedback (einschließlich Screenshots) direkt in der App senden können.

Hinweis

Falls noch nicht geschehen, fügen Sie Ihrem Android-Projekt Firebase hinzu.

Schritt 1: App Distribution Tester API aktivieren

1. Öffnen Sie die Google Cloud Console und wählen Sie Ihr Firebase-Projekt aus.

2. Klicken Sie unter „Firebase App Testers API“ auf Aktivieren.

Schritt 2: App Distribution zur App hinzufügen

Das App Distribution Android SDK besteht aus zwei Bibliotheken:

• firebase-appdistribution-api: Die reine API-Bibliothek, die Sie in alle Build-Varianten aufnehmen können.
• firebase-appdistribution: Die vollständige SDK-Implementierung (optional).

Mit der API-Bibliothek kann Ihr Code das SDK aufrufen. Die Aufrufe haben keine Auswirkungen, wenn die vollständige SDK-Implementierung nicht vorhanden ist.

1. Deklarieren Sie die Abhängigkeit für das Android SDK App Distribution in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle).

2. Wenn Sie die Funktion zur automatischen Aktualisierung der vollständigen SDK-Implementierung nicht in Ihre Google Play-Builds aufnehmen möchten, müssen Sie die Buildvarianten angeben, einschließlich Buildtypen oder Produktvarianten, die Sie über App Distribution verteilen.

3. Deklarieren Sie die Abhängigkeit für das Android SDK App Distribution in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel app/build.gradle). Fügen Sie die vollständige SDK-Implementierung nur Varianten hinzu, die ausschließlich für Tests vor der Veröffentlichung bestimmt sind:

   Kotlin+KTX

   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")
   }

Schritt 3: In-App-Feedback konfigurieren

Verwenden Sie einen der folgenden Trigger, um Feedback von Ihren Testern einzuholen:

• Integrierter Benachrichtigungstrigger: Das App Distribution Android SDK kann eine laufende Benachrichtigung anzeigen, auf die Tester von überall in der App tippen können. Verwenden Sie diesen Trigger, wenn Sie schneller loslegen möchten und die Art und Weise, wie Ihre Tester Feedback geben, nicht anpassen müssen.

• Benutzerdefinierter Trigger: Sie können einen eigenen Triggermechanismus angeben, z. B. das Tippen auf eine Schaltfläche oder einen Menüpunkt in Ihrer App oder das Schütteln des Geräts.

Wenn Sie einen dieser Trigger verwenden und der Tester Feedback gibt, führt das Android SDK die folgenden Aktionen aus:

1. Erfasst einen Screenshot der aktuellen Aktivitäten der App.

2. Es werden Prüfungen durchgeführt, um sicherzustellen, dass der Tester die Testfunktionen des SDKs aktiviert hat. Wenn die Testfunktionen nicht aktiviert sind, werden die Tester vom Android SDK aufgefordert, sich mit ihrem Google-Konto in App Distribution anzumelden.

3. Startet eine Vollbildaktivität, bei der der Tester sein Feedback schreiben und senden kann.

Option 1: Auslöser für Benachrichtigungen

Verwenden Sie showFeedbackNotification(), um eine dauerhafte oder laufende Benachrichtigung auf dem Gerät des Testers anzuzeigen, auf die er tippen kann, um ein Feedback einzuleiten. Wenn Sie die Benachrichtigung konfigurieren, müssen Sie Text angeben, der dem Tester angezeigt wird, bevor er Feedback sendet, sowie eine Unterbrechung der Benachrichtigung (entsprechend der Wichtigkeit des Benachrichtigungskanals). Wenn du deine Tester über die Erhebung und Verarbeitung ihrer Feedbackdaten informieren möchtest, kannst du dazu den Text verwenden.

Wenn Sie showFeedbackNotification() verwenden und die App in den Hintergrund wechselt, wird die Benachrichtigung ausgeblendet. Wenn Sie die Benachrichtigung explizit ausblenden möchten, verwenden Sie cancelFeedbackNotification(). Wir empfehlen, showFeedbackNotification() in die onCreate() Ihrer Hauptaktivität einzufügen.

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

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);
    }
}

Option 2: Benutzerdefinierter Trigger

Verwenden Sie die Methode startFeedback(), um Feedback über einen Mechanismus Ihrer Wahl zu initiieren. Wenn Sie beispielsweise Feedback einholen möchten, können Sie dem Aktionsmenü Ihrer App den Menüpunkt „Feedback geben“ hinzufügen oder Ihre Tester bitten, ihr Gerät zu schütteln oder einen Screenshot zu erstellen. Wenn Sie Feedback auslösen, geben Sie einen Text an, der den Testern angezeigt wird, bevor sie Feedback geben. Wenn Sie Ihren Testern eine Mitteilung zur Erhebung und Verarbeitung ihrer Feedbackdaten senden möchten, können Sie diesen Text verwenden.

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

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

Schritt 4: Implementierung erstellen und testen

Lokales Testen

So testen Sie Ihre Implementierung, ohne die App zuerst verteilen zu müssen:

1. Aktivieren Sie den Entwicklermodus auf Ihrem lokalen Gerät:

   adb shell setprop debug.firebase.appdistro.devmode true

2. Erstellen Sie eine Vorabversion Ihrer App, die alle App Distribution-Bibliotheken enthält, und testen Sie, ob Sie Feedback mit dem in Schritt 3: In-App-Feedback konfigurieren implementierten Mechanismus auslösen können. Im Entwicklermodus wird kein Feedback gesendet.

3. Nach dem Testen können Sie den Entwicklermodus auf Ihrem Gerät deaktivieren:

   adb shell setprop debug.firebase.appdistro.devmode false

End-to-End-Tests

Wenn Sie testen möchten, ob Ihre App Feedback senden kann, erstellen Sie eine Vorabversion Ihrer App, die die vollständigen App Distribution-Bibliotheken enthält. Führen Sie dann die folgenden Schritte aus, um Ihre Implementierung zu testen:

1. Laden Sie einen neuen App-Release auf App Distribution hoch.

2. Veröffentlichen Sie die App-Version in einem Konto, auf das Sie Zugriff haben.

3. Lade die App über die Website oder die Android-Tester-App von App Distribution herunter.

4. Lösen Sie Feedback mit dem Mechanismus aus, der in Schritt 3: In-App-Feedback konfigurieren implementiert wurde.

5. Achte darauf, dass du mit demselben Konto angemeldet bist, an das du den App-Release verteilt hast, und sende Feedback.

6. Sie können sich Ihr Feedback in der Karte des neuen Release in der Firebase Console ansehen.

Informationen zum Beheben häufiger Probleme, z. B. wenn Tester kein Feedback in der App geben können, finden Sie unter Testfunktionen mit dem SDK aktivieren.

Schritt 5: Feedback der Tester verwalten

Nachdem Sie Ihren Testern die Möglichkeit gegeben haben, Feedback zu senden, können Sie dieses Feedback mit den folgenden Tools prüfen und darauf reagieren:

• Firebase-Konsole

• E-Mail-Benachrichtigungen zu neuem Feedback

• Drittanbietertools

Feedback in der Firebase-Konsole ansehen und löschen

Sie können Nutzerfeedback, einschließlich Screenshots, prüfen und löschen, indem Sie in der Firebase-Konsole unter einer bestimmten Version den Tab Testerfeedback öffnen. Nutzerfeedback ist nach Release sortiert, damit Sie die Version bestätigen können, auf die sich das Feedback bezieht.

Nachdem Sie das Nutzerfeedback geprüft haben, können Sie das Feedback löschen. Klicken Sie dazu auf die Schaltfläche Delete feedback (Feedback löschen). Das gelöschte Feedback wird aus Ihrem Release entfernt.

E-Mail-Benachrichtigungen für neues Feedback erhalten

Wenn Sie proaktiv über das Feedback neuer Tester informiert werden möchten, können Sie sich per E-Mail benachrichtigen lassen, wenn ein Tester Feedback sendet. Die E-Mail-Benachrichtigung enthält das schriftliche Feedback des Testers und einen Link zu allen Screenshots, die er eingereicht hat.

Um App Distribution-E-Mail-Benachrichtigungen über diesen Standardmechanismus zu erhalten, benötigen Sie die Berechtigung firebase.projects.update. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig: Firebase-Administrator oder Inhaber oder Bearbeiter des Projekts.

Standardmäßig erhalten alle Projektmitglieder, die die erforderlichen Berechtigungen zum Empfangen von E-Mail-Benachrichtigungen haben, eine E-Mail, wenn ein neuer Feedbackbericht eingereicht wird. Projektmitglieder können diese Benachrichtigungen einzeln deaktivieren.

Informationen zum Deaktivieren von E-Mail-Benachrichtigungen finden Sie unter Firebase-Benachrichtigungen erhalten.

Neues Feedback an Drittanbietertools senden

Sie können App Distribution-Benachrichtigungen auch mithilfe von Cloud Functions for Firebase an den bevorzugten Benachrichtigungskanal Ihres Teams senden. Sie können beispielsweise eine Funktion schreiben, die ein Benachrichtigungsereignis für neues In-App-Feedback erfasst und die Benachrichtigungsinformationen an einen Drittanbieterdienst wie Discord, Slack oder Jira sendet.

So richten Sie erweiterte Benachrichtigungsfunktionen mit Cloud Functions for Firebase ein:

1. Cloud Functions for Firebase einrichten, was die folgenden Aufgaben umfasst:

   1. Laden Sie Node.js und npm herunter.

   2. Installieren Sie die Firebase-Befehlszeile und melden Sie sich an.

   3. Initialisieren Sie Cloud Functions for Firebase mit der Firebase-Befehlszeile.

2. Erstellen und bereitstellen einer Funktion, die ein In-App-Feedback-Benachrichtigungsereignis von App Distribution erfasst und die Ereignisnutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht in Discord postet).

Eine Beispielfunktion zum Senden von neuem Feedback an Jira finden Sie in diesem Beispiel.

Informationen zu allen Benachrichtigungsereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation für App Distribution-Benachrichtigungen.