Raccogli feedback dai tester

Questa guida descrive come abilitare il feedback in-app utilizzando l'SDK Android opzionale Firebase App Distribution, in modo che i tuoi 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: abilita l'API App Distribution Tester

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

  2. Nell'API Firebase App Testers, fai clic su Abilita .

Passaggio 2: aggiungi App Distribution alla tua app

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

  • firebase-appdistribution-api : la libreria solo API, che puoi includere in tutte le varianti di build .
  • 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 effetto se non è presente l'implementazione completa dell'SDK.

  1. Dichiara la dipendenza per l'SDK Android di 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'intera implementazione dell'SDK nelle build di Google Play, identifica le varianti di build, inclusi i tipi di build o le versioni di prodotto che distribuirai tramite App Distribution.

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

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

Passaggio 3: configura il feedback in-app

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

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

  • Trigger personalizzato : puoi fornire il tuo meccanismo di attivazione, ad esempio toccando un pulsante o una voce di menu nell'app o scuotendo il dispositivo.

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

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

  2. Esegue i controlli per garantire che il tester abbia abilitato le funzionalità di test dell'SDK. Se le funzionalità di test non sono abilitate, l'SDK Android richiede al tester di accedere ad 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: attivazione della notifica

Utilizza showFeedbackNotification() per visualizzare una notifica persistente o in corso sul dispositivo del tester che può toccare per avviare il feedback. Quando configuri la notifica, devi fornire del testo che verrà visualizzato al tester prima che invii il feedback e un livello di interruzione per la notifica (corrispondente all'importanza del canale di notifica). Se desideri fornire un avviso ai tuoi tester sulla raccolta e l'elaborazione dei dati di feedback, puoi utilizzare il testo per fornire tale avviso.

Quando usi showFeedbackNotification() e quando l'app passa in background, la notifica viene nascosta. Se desideri nascondere esplicitamente la notifica, utilizza cancelFeedbackNotification() . Ti consigliamo di inserire showFeedbackNotification() onCreate() della tua attività principale.

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

Opzione 2: trigger personalizzato

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

Kotlin+KTX

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

Java

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

Passaggio 4: crea e testa la tua implementazione

Test locale

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

  1. Abilita 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 complete di distribuzione dell'app e verifica che sia possibile attivare il feedback utilizzando il meccanismo implementato nel Passaggio 3: configurazione del feedback in-app . Il feedback non viene inviato in 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, crea la tua app come variante pre-release che include le librerie complete di distribuzione dell'app e testa la tua implementazione seguendo questi passaggi:

  1. Carica una nuova versione dell'app in App Distribution.

  2. Distribuisci la versione dell'app a un account a cui sei autorizzato ad accedere.

  3. Scarica l'app tramite il Web di App Distribution o l'app tester Android.

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

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

  6. Visualizza il tuo feedback nella scheda della nuova versione nella console Firebase .

Per informazioni su come risolvere problemi comuni, ad esempio l'impossibilità da parte dei tester di avviare il feedback nell'app, vedi Abilitazione 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 esaminare tale feedback e agire di conseguenza:

Visualizza ed elimina il feedback nella console Firebase

Puoi rivedere ed eliminare il feedback degli utenti, inclusi gli screenshot, aprendo la scheda Feedback del tester in una versione specifica nella console Firebase. Il feedback degli utenti è organizzato per versione in modo da poter confermare la versione a cui si applica il feedback.

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

Ricevi avvisi e-mail per nuovi feedback

Per conoscere in modo proattivo il feedback dei nuovi tester, puoi ricevere avvisi via email quando un tester invia un feedback. L'avviso e-mail include il feedback scritto fornito dal tester e un collegamento a eventuali screenshot inviati.

Per ricevere avvisi e-mail di distribuzione app tramite questo meccanismo predefinito, è necessario disporre dell'autorizzazione firebase.projects.update . I seguenti ruoli includono questa autorizzazione richiesta per impostazione predefinita: Amministratore Firebase o Proprietario o Editor del progetto.

Per impostazione predefinita, ogni membro del progetto che dispone delle autorizzazioni necessarie per ricevere avvisi tramite posta elettronica riceverà un'email quando viene inviato un nuovo rapporto di feedback. I membri del progetto possono rinunciare individualmente a questi avvisi.

Per disattivare gli avvisi e-mail, consulta Ricevere avvisi Firebase .

Invia nuovi feedback a strumenti di terze parti

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

Per configurare funzionalità di avviso avanzate utilizzando Cloud Functions for Firebase, procedi nel seguente modo:

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

    1. Scarica Node.js e npm.

    2. Installa e accedi alla CLI di Firebase.

    3. Inizializza Cloud Functions for Firebase utilizzando la CLI Firebase.

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

Per vedere una funzione di esempio che mostra come inviare un nuovo feedback a Jira, fai riferimento a questo esempio .

Per informazioni su tutti gli eventi di avviso che puoi acquisire, consulta la documentazione di riferimento per gli avvisi di distribuzione delle app .