Raccogliere feedback dai tester

Questa guida descrive come attivare il feedback in-app utilizzando l'SDK Android Firebase App Distribution facoltativo, in modo che i tester possano inviare feedback (inclusi screenshot) direttamente nell'app.

Prima di iniziare

Se non l'hai già fatto, aggiungi Firebase al tuo progetto Android.

Passaggio 1: attiva l'API App Distribution Tester

1. Apri la console Google Cloud e seleziona il tuo progetto Firebase.

2. In API Firebase App Tester, fai clic su Abilita.

Passaggio 2: aggiungi App Distribution alla tua app

L'SDK Android App Distribution è costituito da due librerie:

• firebase-appdistribution-api: la libreria solo API, che puoi includere in tutte le varianti di compilazione.
• firebase-appdistribution: l'implementazione completa dell'SDK (facoltativa).

La libreria solo API consente al tuo codice di effettuare chiamate all'SDK. Le chiamate non hanno alcun effetto se l'implementazione completa dell'SDK non è presente.

1. Dichiara la dipendenza per l'SDK Android App Distribution nel file Gradle del modulo (a livello di app) (solitamente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle).

2. Per evitare di includere la funzionalità di aggiornamento automatico dell'implementazione completa dell'SDK nelle build di Google Play, identifica le varianti di compilazione, inclusi i tipi di build o le versioni prodotto che distribuirai tramite App Distribution.

3. Dichiara la dipendenza per l'SDK Android App Distribution nel file Gradle (a livello di app) del modulo (solitamente app/build.gradle). Aggiungi l'implementazione completa dell'SDK solo alle varianti destinate esclusivamente ai test pre-release:

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

Cerchi un modulo di libreria specifico per Kotlin? A partire dalla release di ottobre 2023, sia gli sviluppatori Kotlin che quelli Java possono fare affidamento sul modulo della libreria principale. Per maggiori dettagli, consulta le domande frequenti su questa iniziativa.

Passaggio 3: configura il feedback in-app

Per raccogliere i feedback dei tester, utilizza uno dei seguenti trigger per consentire ai tester di avviare il feedback:

• Trigger di notifica integrato: l'SDK Android App Distribution può mostrare una notifica continua che il tester può toccare da qualsiasi punto dell'app. Utilizza questo trigger se vuoi iniziare più rapidamente e non hai bisogno di personalizzare il modo in cui i tester forniscono feedback.

• Attivatore personalizzato: puoi fornire il tuo meccanismo di attivazione, ad esempio toccando un pulsante o una voce di menu nella tua app o agitando il dispositivo.

Quando utilizzi uno di questi trigger e il tester invia un feedback, l'SDK Android esegue le seguenti azioni:

1. Acquisisce uno screenshot dell'attività corrente dell'app.

2. Esegue controlli per assicurarsi che il tester abbia attivato le funzionalità di test dell'SDK. Se le funzionalità di test non sono attivate, l'SDK Android chiede al tester di accedere a App Distribution con il proprio Account Google.

3. Avvia un'attività a schermo intero che consente al tester di scrivere e inviare il proprio feedback.

Opzione 1: attivatore della notifica

Utilizza showFeedbackNotification() per mostrare una notifica persistente o in corso sul dispositivo del tester, che può toccarla per avviare il feedback. Quando configuri la notifica, devi fornire un testo che verrà mostrato al tester prima che invii il feedback e un livello di interruzione per la notifica (corrispondente all'importanza del canale di notifica). Se vuoi informare i tuoi tester della raccolta e del trattamento dei dati dei loro feedback, puoi utilizzare il testo per fornire questa informativa.

Quando utilizzi showFeedbackNotification() e l'app passa in background, la notifica viene nascosta. Se vuoi nascondere esplicitamente la notifica, utilizza cancelFeedbackNotification(). Ti consigliamo di inserire showFeedbackNotification() nel metodo onCreate() dell'attività principale.

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

Opzione 2: trigger personalizzato

Utilizza il metodo startFeedback() per avviare il feedback utilizzando un meccanismo di tua scelta. Ad esempio, per attivare il feedback, potresti aggiungere una voce di menu "Invia feedback" al menu Azioni della tua app o consentire ai tester di scuotere il dispositivo o acquisire uno screenshot. Quando attivi il feedback, fornisci un testo che verrà mostrato al tester prima che invii il feedback. Se vuoi fornire ai tuoi tester un'informativa sulla raccolta e sull'elaborazione dei dati relativi ai loro feedback, puoi utilizzare questo testo.

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

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

Passaggio 4: crea e testa l'implementazione

Test locale

Per testare l'implementazione senza dover prima distribuire l'app, segui questi passaggi:

1. Attiva la modalità sviluppatore sul tuo dispositivo locale:

   adb shell setprop debug.firebase.appdistro.devmode true

2. Crea la tua app come variante pre-release che include le librerie App Distribution complete e verifica di poter attivare il feedback utilizzando il meccanismo implementato nel Passaggio 3: configura il feedback in-app. Il feedback non viene inviato quando è attiva la modalità sviluppatore.

3. Dopo il test, puoi disattivare la modalità sviluppatore sul tuo dispositivo:

   adb shell setprop debug.firebase.appdistro.devmode false

Test end-to-end

Per verificare che la tua app possa inviare feedback, creala come variante pre-release che includa le librerie App Distribution complete e testa l'implementazione seguendo questi passaggi:

1. Carica una nuova release dell'app su App Distribution.

2. Distribuisci la release dell'app a un account a cui hai l'autorizzazione di accedere.

3. Scarica l'app tramite il web o l'app di test per Android di App Distribution.

4. Attiva il feedback utilizzando il meccanismo implementato nel Passaggio 3: configura il feedback in-app.

5. Assicurati di aver eseguito l'accesso con lo stesso account a cui hai distribuito la release dell'app e invia il feedback.

6. Visualizza il feedback nella scheda della nuova release nella console Firebase.

Per scoprire come risolvere i problemi comuni, ad esempio i tester che non riescono ad avviare il feedback nell'app, consulta Attivazione delle funzionalità di test con l'SDK.

Passaggio 5: gestisci il feedback dei tester

Dopo aver consentito ai tester di inviare feedback, puoi utilizzare i seguenti strumenti per esaminarli e intervenire di conseguenza:

• Console Firebase

• Avvisi via email per i nuovi feedback

• Strumenti di terze parti

Visualizza ed elimina i feedback nella console Firebase

Puoi esaminare ed eliminare il feedback degli utenti, inclusi gli screenshot, aprendo la scheda Feedback dei tester in una release specifica nella console Firebase. Il feedback degli utenti è organizzato per release, in modo che tu possa confermare la versione a cui si applica.

Dopo aver esaminato il feedback degli utenti, puoi eliminarlo facendo clic sul pulsante Elimina feedback. Il feedback eliminato viene rimosso dalla release.

Ricevi avvisi via email per i nuovi feedback

Per ricevere informazioni proattive sui nuovi feedback dei tester, puoi ricevere avvisi via email quando un tester invia un feedback. L'avviso via email include il feedback scritto fornito dal tester e un link agli eventuali screenshot inviati.

Per ricevere avvisi via email di App Distribution utilizzando questo meccanismo predefinito, devi disporre dell'autorizzazione firebase.projects.update. I seguenti ruoli includono questa autorizzazione obbligatoria per impostazione predefinita: Firebase Admin o Proprietario o Editor del progetto.

Per impostazione predefinita, ogni membro del progetto che dispone delle autorizzazioni necessarie per ricevere avvisi via email riceverà un'email quando viene inviato un nuovo report di feedback. I membri del progetto possono disattivare singolarmente questi avvisi.

Per disattivare gli avvisi via email, consulta Ricevi avvisi di Firebase.

Invia un nuovo feedback agli strumenti di terze parti

Puoi anche inviare avvisi di App Distribution al canale di notifica preferito del tuo team utilizzando Cloud Functions for Firebase. Ad esempio, puoi scrivere una funzione che acquisisce un evento di avviso per un nuovo feedback in-app e pubblica le informazioni dell'avviso in un servizio di terze parti come Discord, Slack o Jira.

Per configurare funzionalità di avviso avanzate utilizzando Cloud Functions for Firebase, segui questi passaggi:

1. Configura Cloud Functions for Firebase, che include le seguenti attività:

   1. Scarica Node.js e npm.

   2. Installa l'interfaccia a riga di comando Firebase e accedi.

   3. Inizializza Cloud Functions for Firebase utilizzando l'interfaccia a riga di comando di Firebase.

2. Scrivi ed esegui il deployment di una funzione che acquisisce un evento di avviso di feedback in-app da App Distribution e gestisce il payload dell'evento (ad esempio, pubblica le informazioni dell'avviso in un messaggio su Discord).

Per un esempio di funzione che mostra come inviare un nuovo feedback a Jira, consulta questo esempio di funzioni.

Per scoprire tutti gli eventi di avviso che puoi acquisire, consulta la documentazione di riferimento per gli avvisi di App Distribution.