Parametri e condizioni di Remote Config

Firebase Remote Config ti consente di controllare dinamicamente il comportamento e l'aspetto delle tue applicazioni senza che gli utenti debbano scaricare un aggiornamento dell'app o che sia necessario rifare il deployment del backend.

Per configurare le tue 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 sostituiscono i valori predefiniti per segmenti di pubblico, ambienti o criteri personalizzati specifici.

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

  • Parametri e condizioni nei modelli client: pubblica le configurazioni nelle istanze delle app client su piattaforme Apple, Android, web, Flutter, Unity e C++. Scegli come target le istanze dell'app utilizzando i segmenti di pubblico Google Analytics, le versioni dell'app, la piattaforma, la lingua del dispositivo, il paese, i percentili degli utenti e gli indicatori personalizzati lato client.

  • Parametri e condizioni nei modelli di server: pubblica le configurazioni in ambienti di backend come Cloud Run, Cloud Functions for Firebase o server containerizzati utilizzando l'Firebase Admin SDK per Node.js, Python, Go e Java. Valuta i parametri lato server con una latenza quasi pari a zero utilizzando gli indicatori personalizzati del server e le implementazioni con percentuale casuale.

Confronta i modelli di client e server

I modelli lato client e lato 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 client 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 pari a zero
Regole per le condizioni Versione dell'app, sistema operativo/piattaforma, lingua del dispositivo, paese/regione, Analytics segmenti di pubblico e proprietà utente, utente nel 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 della UI, A/B Testing, personalizzazione Prompt AI e selezione del modello, flag di funzionalità lato server, limitazione di frequenza del backend, routing dinamico
Guida dettagliata Parametri nei modelli client Parametri nei modelli di server

Concetti principali

Che tu lavori con modelli client o server, Remote Config condivide 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 di stringa per i parametri. Le chiavi possono avere una lunghezza massima di 256 caratteri, devono iniziare con un trattino basso o una lettera dell'alfabeto latino (A-Z, a-z) e possono includere numeri.
  • Valori parametro: i valori assegnati ai parametri. I valori vengono archiviati 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 riferimento 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 di 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 parametro personalizzati:

  • Regole: singoli criteri valutati in base ai metadati del client o ai contesti della richiesta (ad esempio un numero di versione, un paese o un indicatore personalizzato).
  • Condizioni: insiemi denominati di una o più regole. Tutte le regole di una condizione devono essere valutate come true affinché la condizione venga valutata come 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 consoleFirebase 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 parametro nel codice dell'SDK.

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

Controllo delle versioni e rollback dei template

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 scoprire di più sulla gestione delle versioni dei template, consulta Gestisci le versioni dei template 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 totale della stringa del valore: fino a 1.000.000 di caratteri per tutti i valori parametro all'interno di un progetto.

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

Passaggi successivi