Parametri e condizioni di Remote Config

Firebase Remote Config ti consente di controllare dinamicamente il comportamento e l'aspetto delle tue applicazioni senza richiedere agli utenti di scaricare un aggiornamento dell'app o di eseguire nuovamente il deployment del backend.

Per configurare le applicazioni, definisci i parametri (coppie chiave-valore) in Remote Config e li utilizzi nel codice dell'app o del backend. Puoi anche definire condizioni (regole di targeting) per assegnare valori condizionali che ignorano i valori predefiniti per segmenti di pubblico, ambienti o criteri personalizzati specifici.

Remote Config organizza i parametri e le condizioni in modelli. A seconda dell'architettura, puoi utilizzare modelli client, modelli server o entrambi:

  • Parametri e condizioni nei modelli client: Pubblica configurazioni per le istanze dell'app client su piattaforme Apple, Android, web, Flutter, Unity e C++. Targetizza le istanze dell'app utilizzando segmenti di pubblico Google Analytics, versioni dell'app, piattaforma, lingua del dispositivo, paese, percentili degli utenti e indicatori personalizzati lato client.

  • Parametri e condizioni nei modelli di server: Pubblica configurazioni in ambienti di backend come Cloud Run, Cloud Functions for Firebase o server containerizzati utilizzando Firebase Admin SDK per Node.js, Python, Go e Java. Valuta i parametri lato server con latenza quasi nulla utilizzando indicatori personalizzati del server e implementazioni percentuali casuali.

Confrontare i modelli client e server

I modelli client e server sono destinati ad architetture diverse e supportano SDK e regole di targeting distinti. Utilizza la seguente tabella per capire quale tipo di modello è adatto al tuo caso d'uso:

Funzionalità Modelli di clienti Modelli di server
Ambienti di destinazione App client (Apple, Android, web, Flutter, Unity, C++) Ambienti server (Cloud Run, Cloud Functions for Firebase, GKE, servizi di backend)
SDK supportati SDK client Firebase Firebase Admin SDK (Node.js, Python, Go, Java)
Modello di valutazione Recuperati e memorizzati nella cache sui dispositivi client; attivati dal codice dell'app Caricato nella memoria del server; valutato per richiesta con latenza quasi nulla
Regole di condizione Versione dell'app, sistema operativo/piattaforma, lingua del dispositivo, paese/regione, Analytics segmenti di pubblico e proprietà utente, utente in percentile casuale, prima apertura dell'app, indicatori personalizzati del client Utente in percentuale casuale, indicatori personalizzati del server
Casi d'uso comuni Implementazioni di funzionalità, promozioni stagionali, temi dell'interfaccia utente, A/B Testing, Personalizzazione Selezione di prompt e modelli di AI, flag funzionalità lato server, limitazione della frequenza di backend, routing dinamico
Guida dettagliata Parametri nei modelli client Parametri nei modelli lato server

Concetti principali

Che tu lavori con modelli lato client o lato server, Remote Config condividi concetti fondamentali:

Parametri

I parametri sono coppie chiave-valore che definisci nella console Firebase o utilizzando le API di backend Remote Config.

  • Chiavi dei parametri: identificatori stringa per i parametri. Le chiavi possono contenere fino a 256 caratteri, devono iniziare con un trattino basso o una lettera dell'alfabeto latino (A-Z, a-z) e possono includere numeri.
  • Valori dei parametri: i valori assegnati ai parametri. I valori vengono memorizzati come stringhe, ma puoi selezionare i tipi di dati nella console per convalidare i valori in base a formati come String, Boolean, Number o JSON.
  • Valori predefiniti: il valore di base assegnato quando non vengono applicate regole di condizione. Puoi definire i valori predefiniti in-app nel codice, nonché i valori predefiniti del modello nel backend Remote Config.

Condizioni, regole e valori condizionali

Le condizioni ti consentono di scegliere come target segmenti specifici di utenti dell'app o richieste del server con valori dei parametri personalizzati:

  • Regole: singoli criteri valutati in base ai metadati del client o ai contesti delle richieste (ad esempio un numero di versione, un paese o un indicatore personalizzato).
  • Condizioni: insiemi denominati di una o più regole. Affinché una condizione restituisca il valore true, tutte le regole al suo interno devono restituire il valore true.
  • Valori condizionali: valori alternativi assegnati a un parametro quando una condizione restituisce true. Se più condizioni restituiscono true, la condizione con la priorità più alta nella console Firebase ha la precedenza.

Gruppi di parametri

Per organizzare le configurazioni con decine o centinaia di parametri, puoi utilizzare i gruppi di parametri. I gruppi forniscono un'organizzazione visiva nella console Firebase e un raggruppamento logico nell'API REST.

  • Un parametro può appartenere a un solo gruppo alla volta.
  • Le chiavi dei parametri rimangono univoche a livello globale nel progetto, indipendentemente dal raggruppamento.
  • Il raggruppamento non modifica il modo in cui viene fatto riferimento ai valori dei parametri nel codice SDK.

Per istruzioni sulla creazione e la gestione dei gruppi, consulta le guide dettagliate ai parametri client o server.

Controllo delle versioni e rollback dei modelli

Ogni volta che aggiorni e pubblichi parametri o condizioni in Remote Config, Firebase crea e archivia una nuova versione del modello. Puoi visualizzare la cronologia delle versioni, confrontare le modifiche tra le versioni ed eseguire il rollback a una versione precedente ogni volta che è necessario.

Per saperne di più sulla gestione delle versioni dei modelli, consulta Gestire le versioni dei modelli Remote Config.

Quote e limiti

All'interno di un progetto Firebase, Remote Config applica i seguenti limiti:

  • Parametri: fino a 3000 parametri per progetto.
  • Condizioni: fino a 2000 condizioni per progetto.
  • Lunghezza della chiave del parametro: fino a 256 caratteri.
  • Lunghezza della stringa del valore totale: fino a 1.000.000 di caratteri in tutti i valori dei parametri all'interno di un progetto.

Per un elenco completo dei limiti, consulta Quote e limiti.

Passaggi successivi