Questa guida descrive come attivare i feedback in-app utilizzando l'SDK Android facoltativoFirebase App Distribution, in modo che i tester possano inviare feedback (inclusi gli screenshot) direttamente nell'app.
Prima di iniziare
Se non l'hai ancora fatto, aggiungi Firebase al tuo progetto Android.
Passaggio 1: attiva l'API App Distribution Tester
Apri la console Google Cloud e seleziona il tuo progetto Firebase.
In API Firebase App Testers, fai clic su Abilita.
Passaggio 2: aggiungi App Distribution alla tua app
L'SDK Android App Distribution è composto da due librerie:
firebase-appdistribution-api: la libreria dedicata alle API, che puoi includere in tutte le varianti della build.firebase-appdistribution: l'implementazione completa dell'SDK (facoltativo).
La libreria solo API consente al codice di effettuare chiamate all'SDK. Le chiamate hanno non ha alcun effetto se non è presente l'implementazione completa dell'SDK.
Dichiara la dipendenza per l'SDK Android App Distribution nel tuo File Gradle modulo (a livello di app) (di solito
<project>/<app-module>/build.gradle.ktso<project>/<app-module>/build.gradle).Per evitare di includere la funzionalità di aggiornamento automatico dell'implementazione completa dell'SDK nelle build di Google Play, identifica le varianti, ad esempio tipi di build o aromi di prodotto che distribuirai tramite App Distribution.
Dichiara la dipendenza per l'SDK Android App Distribution nel file Gradle del modulo (a livello di app) (di solito
app/build.gradle). Aggiungi solo l'implementazione completa dell'SDK alle varianti destinate esclusivamente ai test pre-release: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") }
Passaggio 3: configura il feedback in-app
Per raccogliere i feedback dei tester, utilizza uno dei seguenti attivatori per consentire ai tester di avviare il feedback:
Attivatore di notifica integrato: App Distribution L'SDK per Android può visualizzare una notifica continua che indica che può toccare da qualsiasi punto dell'app. Usa questo trigger se vuoi di iniziare più rapidamente e non occorre personalizzare il modo in cui i tester per fornire un feedback.
Trigger personalizzato: puoi fornire il tuo attivatore meccanismo di attenzione, come il tocco di un pulsante o una voce di menu nell'app o lo scuotimento del dispositivo.
Quando utilizzi uno di questi attivatori e il tester invia un feedback, L'SDK Android esegue le seguenti azioni:
Acquisisce uno screenshot dell'attività corrente dell'app.
Esegue controlli per verificare 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 firmare accede a App Distribution con il suo Account Google.
Avvia un'attività a schermo intero che consente al tester di scrivere e inviare la propria feedback.
Opzione 1: attivazione della notifica
Usa showFeedbackNotification() per visualizzare un prompt
in corso
una notifica sul dispositivo del tester che quest'ultimo può toccare per inviare un 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 vuoi
informare i tester della raccolta e del trattamento dei loro
dati di feedback, puoi utilizzare il testo per fornire tale notifica.
Quando usi showFeedbackNotification() e quando l'app apre
sfondo, la notifica è nascosta. Se vuoi nascondere esplicitamente la notifica, utilizza cancelFeedbackNotification(). Ti consigliamo di inserire showFeedbackNotification() in 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: attivatore personalizzato
Utilizza il metodo startFeedback() per avviare il feedback utilizzando un meccanismo di tua scelta. Ad esempio, per attivare il feedback, potresti voler aggiungere un
"Invia feedback" al menu Azioni dell'app oppure consenti ai tester
scuoti il dispositivo
o acquisisci uno screenshot.
Quando attivi il feedback, fornisci del testo che verrà mostrato al tester
prima di inviare un feedback. Se vuoi fornire ai tuoi tester una notifica relativa alla raccolta e all'elaborazione dei dati dei loro feedback, puoi utilizzare questo testo.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
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:
Attiva la modalità sviluppatore sul dispositivo locale:
adb shell setprop debug.firebase.appdistro.devmode true
Realizza la tua app come variante di pre-release che includa l'intera app App Distribution librerie e testare se è possibile attivare il feedback utilizzando il meccanismo implementato in Passaggio 3: configura il feedback in-app. Il feedback non viene inviato in modalità sviluppatore.
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, compilala come variante pre-release che includa le librerie App Distribution complete e testa l'implementazione seguendo questi passaggi:
Carica una nuova release dell'app su App Distribution.
Distribuisci la release dell'app a un account a cui hai l'autorizzazione ad accedere.
Scarica l'app tramite l'app web o per tester Android di App Distribution.
Attivare il feedback utilizzando il meccanismo implementato Passaggio 3: configura il feedback in-app.
Assicurati di aver eseguito l'accesso con lo stesso account a cui hai distribuito la release dell'app e invia il feedback.
Visualizza il tuo feedback nella scheda relativa alla nuova uscita all'interno della Console Firebase.
Per scoprire come risolvere i problemi comuni, ad esempio l'impossibilità per i tester di avviare il feedback nell'app, consulta Attivare le 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:
Visualizzare ed eliminare i feedback nella console Firebase
Puoi esaminare ed eliminare i feedback degli utenti, inclusi gli screenshot, aprendo la scheda Feedback dei tester in una release specifica nella console Firebase. I feedback degli utenti sono organizzati per release, in modo da poter confermare la versione a cui si applicano.
Dopo aver esaminato il feedback degli utenti, puoi eliminarlo facendo clic sull'icona Pulsante Elimina feedback. Il feedback eliminato viene rimosso da .
Ricevi avvisi via email per i nuovi feedback
Per scoprire di più sul feedback dei nuovi tester, puoi ricevere un'email avvisa quando un tester invia un feedback. L'avviso via email include le informazioni feedback fornito dal tester e un link agli screenshot inviati.
Per ricevere avvisi via email di App Distribution tramite questo meccanismo predefinito, devi disporre dell'autorizzazione firebase.projects.update. I seguenti ruoli includono questo
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 Ricevere avvisi di Firebase.
Invia nuovo feedback a strumenti di terze parti
Puoi anche inviare avvisi App Distribution al canale di notifica preferito del tuo team utilizzando Cloud Functions for Firebase. Ad esempio, puoi scrivere un che acquisisce un evento di avviso per i nuovi feedback in-app e pubblica informazioni sugli avvisi a un servizio di terze parti come Discord, Slack o Jira.
Per configurare funzionalità di avviso avanzate utilizzando Cloud Functions for Firebase, segui questi passaggi:
Configura Cloud Functions for Firebase, che include le seguenti attività:
Scarica Node.js e npm.
Installa l'interfaccia a riga di comando Firebase e accedi.
Inizializza Cloud Functions for Firebase utilizzando l'interfaccia a riga di comando Firebase.
Scrivere ed eseguire il deployment di 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 sull'avviso in un messaggio su Discord).
Per una funzione di esempio che mostra come inviare un nuovo feedback a Jira, fai riferimento a questo esempio.
Per scoprire di più su tutti gli eventi di avviso che puoi acquisire, consulta la documentazione di riferimento documentazione per App Distribution avvisi.