| Seleziona la piattaforma: | iOS+ Android Web Flutter Unity C++ |
Remote Config in tempo reale ti consente di ricevere chiavi e valori dei parametri aggiornati non appena vengono pubblicati sul server. In questo modo, puoi aggiornare rapidamente qualsiasi tipo di attributo dell'app controllato utilizzando un valore parametro Remote Config. Con gli aggiornamenti di Remote Config in tempo reale, puoi:
- Riduci i rischi implementando le funzionalità in modo incrementale per gli utenti target ed eseguendo un rollback di emergenza, se necessario.
- Aumenta il coinvolgimento degli utenti personalizzando rapidamente le esperienze utente mentre utilizzano l'app. Ad esempio, puoi aggiornare i banner e offrire incentivi agli utenti che corrispondono a proprietà utente Google Analytics specifiche o regolare dinamicamente la difficoltà del gioco per gruppi di giocatori.
- Riduci le dipendenze di build e aumenta la produttività degli sviluppatori: utilizza i parametri Remote Config come flag di funzionalità per esporre le funzionalità ai team di sviluppo e test, mantenendole nascoste agli utenti in produzione.
Per saperne di più sui modi in cui puoi utilizzare Remote Config, consulta Cosa puoi fare con Remote Config?.
Questa guida tratta i seguenti argomenti:
- La relazione client-server che supporta gli aggiornamenti in tempo reale.
- Come funziona la funzionalità in tempo reale nell'SDK.
- Come utilizzare gli aggiornamenti in tempo reale per mantenere aggiornata la configurazione dell'app.
- Best practice per Remote Config in tempo reale.
La connessione client-server in tempo reale
Quando implementi Remote Config in tempo reale nella tua app, crei un listener in tempo reale che apre una connessione HTTP al backend Remote Config. La richiesta include la versione della configurazione memorizzata nella cache del dispositivo. Il server Remote Config in tempo reale utilizza un messaggio di annullamento della convalida per segnalare all'app quando deve essere recuperata una versione più recente di una configurazione lato server.
Se il server ha una versione più recente, invia immediatamente l'indicatore di annullamento della convalida.
Se non è disponibile una versione più recente, mantiene aperta la connessione e attende che ne venga pubblicata una sul server. Quando l'SDK client riceve un segnale di annullamento della convalida, lo recupera automaticamente e chiama il callback del listener registrato quando hai aperto la connessione del listener. Questo recupero è simile alla chiamata di recupero che puoi effettuare con l'SDK, ma ignora qualsiasi impostazione di memorizzazione nella cache o di minimumFetchInterval. La connessione client-server viene mantenuta mentre l'app è in primo piano.
Poiché la connessione client-server viene stabilita tramite HTTP, non richiede dipendenze da altre librerie.
Ascolta gli aggiornamenti
Gli aggiornamenti in tempo reale integrano le chiamate Remote Config fetch. Ti consigliamo di chiamare fetch all'avvio dell'app (o in un momento qualsiasi del ciclo di vita dell'app) e di ascoltare gli aggiornamenti di Remote Config in tempo reale durante la sessione utente per assicurarti di avere i valori più recenti non appena vengono pubblicati sul server.
Per ascoltare gli aggiornamenti, chiama
AddOnConfigUpdateListener,
implementando un callback che viene richiamato ogni volta che è disponibile un aggiornamento di Remote Config
nell'app. Dietro le quinte, questa chiamata inizia ad ascoltare gli aggiornamenti
dal server Remote Config. Per scoprire di più sulla relazione client-server, consulta la sezione precedente.
Il callback è spesso un buon punto in cui utilizzare activate per rendere disponibili alla tua app i parametri di configurazione aggiornati. Consulta Strategie di caricamento di Firebase Remote Config per ulteriori strategie per attivare i valori parametro quando utilizzi Remote Config in tempo reale.
Attiva in modo selettivo i valori parametro
Quando chiami
AddOnConfigUpdateListener,
puoi attendere la modifica e attivarla.
Il callback onUpdate viene chiamato quando viene recuperata automaticamente una nuova versione del modello e quando questa nuova versione contiene modifiche ai valori dei parametri attivi nell'app.
Questi callback vengono richiamati con un parametro configUpdate.
configUpdate contiene updated_keys, ovvero l'insieme di chiavi dei parametri modificate che hanno avviato l'aggiornamento in tempo reale e include quanto segue:
- Chiavi dei parametri aggiunte o rimosse
- Chiavi dei parametri i cui valori sono stati modificati
- Chiavi dei parametri i cui metadati sono cambiati (ad esempio, informazioni di personalizzazione di Remote Config)
- Chiavi dei parametri la cui origine del valore è cambiata (ad esempio, un valore predefinito in-app che viene aggiornato a un valore lato server)
Se utilizzi un listener in tempo reale in una visualizzazione specifica della tua app, puoi verificare se i parametri pertinenti a quella visualizzazione sono cambiati prima dell'attivazione.
A volte, un recupero (avviato quando chiami il metodo fetch o da Remote Config in tempo reale) non comporta un aggiornamento per il client. In questi casi, il metodo o il completamento onUpdate non verrà chiamato.
Aggiungi e rimuovi ascoltatori
AddOnConfigUpdateListener
è l'entrypoint principale per Remote Config in tempo reale. La prima volta che chiami questo listener nel ciclo di vita dell'app, viene aperta la connessione al backend.
Le chiamate successive riutilizzano la stessa connessione, eseguendo il multiplexing del messaggio di annullamento della convalida descritto nella sezione Connessione client-server in tempo reale.
La chiamata restituisce una "registrazione del listener", che ha un metodo chiamato Remove.
Per interrompere l'ascolto, archivia il riferimento alla registrazione del listener. Chiama remove per interrompere l'ascolto di questa registrazione. Se è l'unico listener registrato, la chiamata a remove chiude la connessione in tempo reale al server.
Anche se puoi interrompere manualmente l'ascolto degli aggiornamenti, spesso non è necessario. Remote Config in tempo reale interrompe automaticamente l'ascolto degli aggiornamenti quando l'app passa in background e lo riavvia quando l'app passa in primo piano.
Passaggi successivi
Consulta Inizia a utilizzare Firebase Remote Config per configurare Remote Config e iniziare ad ascoltare gli aggiornamenti in tempo reale.