Feedback von Testern einholen

In diesem Leitfaden wird beschrieben, wie Sie In-App-Feedback mit dem optionalen Firebase App Distribution Android SDK aktivieren, damit Ihre Tester Feedback (einschließlich Screenshots) direkt in der App einreichen 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-Konsole und wählen Sie Ihr Firebase-Projekt aus.

2. Klicken Sie unter der 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 einbinden können.
• firebase-appdistribution: Die vollständige SDK-Implementierung (optional).

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

1. Deklarieren Sie die Abhängigkeit für das App Distribution Android SDK in der Gradle-Datei des Moduls (auf App-Ebene) (normalerweise <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, identifizieren Sie die Build-Varianten, einschließlich Build-Typen oder Produktvarianten, die Sie über App Distribution vertreiben möchten.

3. Deklarieren Sie die Abhängigkeit für das App Distribution Android SDK in der Gradle-Datei Ihres 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 vorgesehen sind:

   Kotlin

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

   Java

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

Suchen Sie nach einem Kotlin-spezifischen Bibliotheksmodul? Seit dem Release im Oktober 2023 können sowohl Kotlin- als auch Java-Entwickler das Hauptbibliotheksmodul verwenden. Weitere Informationen finden Sie in den FAQs zu dieser Initiative.

Schritt 3: In-App-Feedback konfigurieren

Wenn Sie Feedback von Ihren Testern einholen möchten, können Sie einen der folgenden Trigger verwenden, damit Tester Feedback geben können:

• Integrierter Benachrichtigungstrigger: Das App Distribution Android SDK kann eine dauerhafte Benachrichtigung anzeigen, auf die der Tester von überall in der App tippen kann. 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 bereitstellen, 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 sendet, führt das Android SDK die folgenden Aktionen aus:

1. Erstellt einen Screenshot der aktuellen Aktivität der App.

2. Es wird geprüft, ob der Tester die Testfunktionen des SDK aktiviert hat. Wenn die Testfunktionen nicht aktiviert sind, fordert das Android SDK den Tester auf, sich mit seinem Google-Konto in App Distribution anzumelden.

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

Option 1: Auslöser für Benachrichtigungen

Verwende showFeedbackNotification(), um eine dauerhafte oder laufende Benachrichtigung auf dem Gerät des Testers anzuzeigen, auf die er tippen kann, um Feedback zu geben. Wenn Sie die Benachrichtigung konfigurieren, müssen Sie einen Text angeben, der dem Tester angezeigt wird, bevor er Feedback einreicht, sowie eine Unterbrechungsstufe für die Benachrichtigung (entsprechend der Wichtigkeit des Benachrichtigungskanals). Wenn Sie Ihre Tester über die Erhebung und Verarbeitung ihrer Feedbackdaten informieren möchten, können Sie den Text verwenden, um einen entsprechenden Hinweis bereitzustellen.

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()-Methode der 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. Sie können beispielsweise im Aktionsmenü Ihrer App den Menüpunkt „Feedback geben“ hinzufügen oder Ihre Tester das Gerät schütteln oder einen Screenshot erstellen lassen, um Feedback zu geben. Wenn Sie Feedback anfordern, geben Sie Text an, der dem Tester angezeigt wird, bevor er Feedback einreicht. Wenn Sie Ihre Tester über die Erhebung und Verarbeitung ihrer Feedbackdaten informieren 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 bereitstellen zu müssen:

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

   adb shell setprop debug.firebase.appdistro.devmode true

2. Erstellen Sie Ihre App als Vorabversion, die die vollständigen 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, und testen Sie Ihre Implementierung so:

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

2. Stellen Sie den App-Release für ein Konto bereit, auf das Sie Zugriff haben.

3. Lade die App über die Web- oder 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 dem Konto angemeldet bist, über das du den App-Release bereitgestellt hast, und gib Feedback.

6. Sie können sich Ihr Feedback auf 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 von Testern verwalten

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

• Firebase Console

• E‑Mail-Benachrichtigungen bei neuem Feedback

• Drittanbieter-Tools

Feedback in der Firebase-Konsole ansehen und löschen

Sie können Nutzerfeedback, einschließlich Screenshots, prüfen und löschen. Öffnen Sie dazu in der Firebase Console unter einem bestimmten Release den Tab Testerfeedback. Das Nutzerfeedback ist nach Release organisiert, sodass du die Version bestätigen kannst, auf die sich das Feedback bezieht.

Nachdem Sie das Nutzerfeedback geprüft haben, können Sie es löschen, indem Sie auf den Button Feedback löschen klicken. Das gelöschte Feedback wird aus Ihrem Release entfernt.

E‑Mail-Benachrichtigungen für neues Feedback erhalten

Wenn Sie proaktiv über neues Testerfeedback informiert werden möchten, können Sie E‑Mail-Benachrichtigungen erhalten, wenn ein Tester Feedback einreicht. Die E‑Mail-Benachrichtigung enthält das schriftliche Feedback des Testers und einen Link zu allen eingereichten Screenshots.

Wenn Sie App Distribution-E-Mail-Benachrichtigungen über diesen Standardmechanismus erhalten möchten, benötigen Sie die Berechtigung firebase.projects.update. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig: Firebase-Administrator oder Projektinhaber oder ‑bearbeiter.

Standardmäßig erhält jedes Projektmitglied, das die erforderlichen Berechtigungen zum Empfangen von E‑Mail-Benachrichtigungen hat, 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 mit 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, einschließlich der folgenden Aufgaben:

   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. Schreiben und stellen Sie eine Funktion bereit, die ein In-App-Feedback-Benachrichtigungsereignis von App Distribution erfasst und die Ereignisnutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht auf Discord postet).

Ein Beispiel für eine Funktion, die zeigt, wie neues Feedback an Jira gesendet wird, finden Sie in diesem Funktionsbeispiel.

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