Sammeln Sie Feedback von Testern

In dieser Anleitung 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 übermitteln können.

Bevor Sie beginnen

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

Schritt 1: Aktivieren Sie die App Distribution Tester-API

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

  2. Klicken Sie unter der Firebase App Testers API auf Aktivieren .

Schritt 2: Fügen Sie die App-Verteilung zu Ihrer App hinzu

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 reinen API-Bibliothek kann Ihr Code das SDK aufrufen. Die Aufrufe haben keine Wirkung, 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 Ihres Moduls (App-Ebene) (normalerweise <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle ).

  2. Um zu vermeiden, dass die vollständige Selbstaktualisierungsfunktionalität der SDK-Implementierung in Ihre Google Play-Builds einbezogen wird, identifizieren Sie die Build-Varianten, einschließlich Build-Typen oder Produktvarianten , die Sie über App Distribution verteilen.

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

    Kotlin+KTX

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

    Java

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

Schritt 3: Konfigurieren Sie In-App-Feedback

Um Feedback von Ihren Testern zu sammeln, verwenden Sie einen der folgenden Auslöser, damit Tester Feedback initiieren können:

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

  • Benutzerdefinierter Auslöser : Sie können Ihren eigenen Auslösemechanismus bereitstellen, z. B. das Tippen auf eine Schaltfläche oder ein Menüelement in Ihrer App oder das Schütteln des Geräts.

Wenn Sie einen dieser Auslöser verwenden und der Tester Feedback sendet, führt das Android SDK die folgenden Aktionen aus:

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

  2. Führt Prüfungen durch, um sicherzustellen, dass 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 bei App Distribution anzumelden.

  3. Startet eine Vollbildaktivität, die es dem Tester ermöglicht, sein Feedback zu schreiben und einzureichen.

Option 1: Benachrichtigungsauslöser

Verwenden Sie showFeedbackNotification() , um eine dauerhafte oder fortlaufende Benachrichtigung auf dem Gerät des Testers anzuzeigen, auf die er tippen kann, um Feedback einzuleiten. Wenn Sie die Benachrichtigung konfigurieren, müssen Sie einen Text angeben, der dem Tester angezeigt wird, bevor er Feedback sendet, sowie eine Unterbrechungsstufe für die Benachrichtigung (entsprechend der Wichtigkeit des Benachrichtigungskanals). Wenn Sie Ihre Tester über die Erhebung und Verarbeitung ihrer Feedback-Daten informieren möchten, können Sie den Text als Hinweis nutzen.

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 Ihnen, showFeedbackNotification() in 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);
    }
}

Option 2: Benutzerdefinierter Auslöser

Verwenden Sie die Methode startFeedback() , um Feedback mithilfe eines Mechanismus Ihrer Wahl einzuleiten. Um beispielsweise Feedback auszulösen, können Sie dem Aktionsmenü Ihrer App den Menüpunkt „Feedback senden“ hinzufügen oder Ihren Testern die Möglichkeit geben , ihr Gerät zu schütteln oder einen Screenshot zu machen . Wenn Sie Feedback auslösen, geben Sie einen Text ein, der dem Tester angezeigt wird, bevor er Feedback abgibt. Wenn Sie Ihre Tester über die Erhebung und Verarbeitung ihrer Feedback-Daten informieren möchten, können Sie diesen Text verwenden, um einen solchen Hinweis bereitzustellen.

Kotlin+KTX

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

Java

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

Schritt 4: Erstellen und testen Sie Ihre Implementierung

Lokale Tests

Um Ihre Implementierung zu testen, ohne die App zuerst verteilen zu müssen, führen Sie die folgenden Schritte aus:

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

    adb shell setprop debug.firebase.appdistro.devmode true
    
  2. Erstellen Sie Ihre App als Vorabversionsvariante, die die vollständigen App Distribution-Bibliotheken enthält, und testen Sie, ob Sie mithilfe des in Schritt 3: Konfigurieren von In-App-Feedback implementierten Mechanismus Feedback auslösen können. Im Entwicklungsmodus wird kein Feedback übermittelt.

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

    adb shell setprop debug.firebase.appdistro.devmode false
    

End-to-End-Tests

Um zu testen, ob Ihre App Feedback senden kann, erstellen Sie Ihre App als Vorabversionsvariante, die die vollständigen App Distribution-Bibliotheken enthält, und testen Sie Ihre Implementierung anhand der folgenden Schritte:

  1. Laden Sie eine neue App-Version in App Distribution hoch.

  2. Verteilen Sie die App-Version an ein Konto, auf das Sie zugreifen dürfen.

  3. Laden Sie die App über die Web- oder Android-Tester-App von App Distribution herunter.

  4. Lösen Sie Feedback mithilfe des in Schritt 3: Konfigurieren von In-App-Feedback implementierten Mechanismus aus.

  5. Stellen Sie sicher, dass Sie mit demselben Konto angemeldet sind, an das Sie die App-Version verteilt haben, und geben Sie Feedback.

  6. Sehen Sie sich Ihr Feedback auf der Karte der neuen Version in der Firebase-Konsole an.

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

Schritt 5: Tester-Feedback verwalten

Nachdem Sie Ihren Testern das Senden von Feedback ermöglicht haben, können Sie die folgenden Tools verwenden, um dieses Feedback zu überprüfen und darauf zu reagieren:

Feedback in der Firebase-Konsole anzeigen und löschen

Sie können Benutzerfeedback, einschließlich Screenshots, überprüfen und löschen, indem Sie die Registerkarte Tester-Feedback unter einer bestimmten Version in der Firebase-Konsole öffnen. Das Benutzerfeedback ist nach Release geordnet, sodass Sie die Version bestätigen können, für die das Feedback gilt.

Nachdem Sie das Benutzerfeedback überprüft haben, können Sie dieses Feedback löschen, indem Sie auf die Schaltfläche „Feedback löschen“ klicken. Das gelöschte Feedback wird aus Ihrer Veröffentlichung entfernt.

Erhalten Sie E-Mail-Benachrichtigungen für neues Feedback

Um proaktiv über das Feedback neuer Tester zu erfahren, können Sie E-Mail-Benachrichtigungen erhalten, wenn ein Tester Feedback sendet. Die E-Mail-Benachrichtigung enthält das schriftliche Feedback Ihres Testers und einen Link zu allen von ihm eingereichten Screenshots.

Um App Distribution-E-Mail-Benachrichtigungen über diesen Standardmechanismus zu erhalten, müssen Sie über die Berechtigung firebase.projects.update verfügen. Die folgenden Rollen umfassen standardmäßig diese erforderliche Berechtigung: Firebase-Administrator oder Projektinhaber oder -editor .

Standardmäßig erhält jedes Projektmitglied, das über die erforderlichen Berechtigungen zum Empfang von E-Mail-Benachrichtigungen verfügt, eine E-Mail, wenn ein neuer Feedbackbericht übermittelt wird. Projektmitglieder können diese Benachrichtigungen individuell deaktivieren.

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

Senden Sie neues Feedback an Tools von Drittanbietern

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

Führen Sie die folgenden Schritte aus, um erweiterte Benachrichtigungsfunktionen mithilfe von Cloud Functions für Firebase einzurichten:

  1. Richten Sie Cloud Functions für Firebase ein , was die folgenden Aufgaben umfasst:

    1. Laden Sie Node.js und npm herunter.

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

    3. Initialisieren Sie Cloud Functions für Firebase mit der Firebase-CLI.

  2. Schreiben und implementieren Sie eine Funktion , die ein In-App-Feedback-Benachrichtigungsereignis von App Distribution erfasst und die Ereignisnutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht auf Discord veröffentlicht).

Eine Beispielfunktion, die Ihnen zeigt, wie Sie neues Feedback an Jira senden, finden Sie in diesem Beispiel .

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