Feedback von Testern einholen

Das Firebase App Distribution Android SDK ist ein Betarelease. Das bedeutet, dass sich die Funktionalität in nicht abwärtskompatibler Weise ändern kann. Eine Betaversion unterliegt keinem SLA und keiner Einstellungsrichtlinie und erhält möglicherweise nur eingeschränkten oder keinen Support.

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

Fügen Sie Ihrem Android-Projekt Firebase hinzu, falls noch nicht geschehen.

Hinweis: Wenn Sie mehrere Apps in Ihrem Firebase-Projekt haben, muss die App, die Sie mit App Distribution verteilen möchten, eine eigene google-services.json-Konfigurationsdatei haben. Weitere Informationen finden Sie unter Mehrere Umgebungen unterstützen.

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 API-Bibliothek, die Sie in alle Buildvarianten aufnehmen können.
• firebase-appdistribution: Die vollständige SDK-Implementierung (optional).

Achtung :Zur Unterstützung von Funktionen wie der Benachrichtigung von Testern über neue Builds enthält die vollständige Implementierung des App Distribution Android SDK eine Funktion zur automatischen Aktualisierung, die als Verstoß gegen die Google Play-Richtlinien angesehen werden kann, auch wenn dieser Code nicht zur Laufzeit ausgeführt wird. Wenn Sie Ihre App bei Google Play einreichen, ohne die vollständige SDK-Implementierung zu entfernen, kann das dazu führen, dass Ihre App aus Google Play entfernt wird.

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 App Distribution Android SDK 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 App Distribution Android SDK in Ihrer 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 Vorabtests vorgesehen 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.

   Hinweis: Die Aktivierung von Testfunktionen erfolgt auf dem Testgerät einmalig und bleibt über Updates Ihrer App hinweg erhalten. Die Testfunktionen bleiben auf dem Testgerät aktiviert, bis der Tester die App deinstalliert oder die App die Methode signOutTester aufruft.

3. Startet eine Vollbildaktivität, in der die Tester ihr Feedback eingeben und einreichen können.

Option 1: Auslöser für Benachrichtigungen

Mit showFeedbackNotification() können Sie auf dem Gerät des Testers eine dauerhafte oder fortlaufende Benachrichtigung anzeigen, auf die er tippen kann, um Feedback zu geben. Wenn Sie die Benachrichtigung konfigurieren, müssen Sie einen Text angeben, der den Testern angezeigt wird, bevor sie Feedback geben. Außerdem müssen Sie die Unterbrechungsstufe für die Benachrichtigung festlegen, die der Wichtigkeit des Benachrichtigungskanals entspricht. Wenn Sie Ihre Tester über die Erhebung und Verarbeitung ihrer Feedbackdaten informieren möchten, können Sie diesen 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.

Kotlin+KTX

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

Hinweis :Unter Android 13 und höher ist für diese Methode die Laufzeitberechtigung zum Senden von Benachrichtigungen erforderlich: POST_NOTIFICATIONS. Wenn Ihre App auf Android 13 (API-Level 33) oder höher ausgerichtet ist, müssen Sie die Berechtigung deklarieren und dann in der Laufzeit anfordern.

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.

Kotlin+KTX

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

Java

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

Hinweis: Standardmäßig werden alle Inhaber und Bearbeiter von Firebase-Projekten per E-Mail und in der Konsole benachrichtigt, wenn neues Feedback eingeht.

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. Melden Sie sich mit dem Konto an, über das Sie die App-Version veröffentlicht haben, und reichen Sie Feedback ein.

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

Achtung :Bevor Sie Ihre App im Google Play Store veröffentlichen, sollten Sie sie testen, um sicherzustellen, dass Sie nur die API-Bibliotheksabhängigkeit einschließen und dass Ihr Feedbackmechanismus nicht in Ihrer Release-Variante enthalten ist. Weitere Informationen finden Sie unter Schritt 2: App Distribution zur App hinzufügen.

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 es löschen, indem Sie auf die Schaltfläche Feedback löschen klicken. Das gelöschte Feedback wird aus Ihrer Version 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 Ihres 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 umfassen 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 Tools von Drittanbietern senden

Sie können App Distribution-Benachrichtigungen auch über 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 in einem Drittanbieterdienst wie Discord, Slack oder Jira postet.

Hinweis: Wenn Sie erweiterte Benachrichtigungsfunktionen verwenden möchten, muss für Ihr Firebase-Projekt der Blaze-Tarif verwendet werden.

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, die zeigt, wie Sie neues Feedback an Jira senden, finden Sie hier.

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