Condividi tramite


Usare flag di funzionalità varianti

I flag di funzionalità con varianti sono flag di funzionalità configurati con più opzioni di una funzionalità. Le varianti della funzionalità possono essere assegnate a utenti, gruppi o bucket percentili specifici. Questi flag possono essere utili per la sperimentazione delle funzionalità (nota anche come test A/B).

Che cos'è un flag di funzionalità variante?

Una flag di funzionalità variante è una flag di funzionalità che supporta più stati o variazioni. Anche se può ancora essere attivato o disattivato, consente anche varianti diverse con le configurazioni. Una variante viene definita con un nome e un valore di configurazione facoltativo. Il nome è un identificatore per distinguere le varianti. Il valore di configurazione può variare da primitive JSON semplici a oggetti JSON complessi. È possibile usare le varianti per differenziare le funzionalità o le esperienze utente e, facoltativamente, configurare queste funzionalità o esperienze utente con i valori di configurazione delle varianti. Inoltre, un flag di funzionalità variante include regole di allocazione, che definiscono il gruppo di destinatari per ogni variante.

Varianti

L'esempio seguente mostra due varianti che usano oggetti JSON per il valore di configurazione.

Nome della variante Valore di configurazione variante
Minime { "maxitems": 10, "showAds": false }
Normale { "maxitems": 30, "showAds": true }

Allocation (Allocazione)

L'allocazione controlla quale segmento di utenti ottiene ogni variante. L'esempio seguente alloca il 10% degli utenti per ottenere la variante Minima e il 90% per ottenere la variante Standard.

Variante Allocation (Allocazione) Osservazioni
Minime 10% Assegnare la variante agli utenti dal 0° al 10° percentile.
Normale 90% Assegnare la variante agli utenti dal 10° al 100° percentile.

Override

È possibile assegnare varianti a gruppi o utenti specifici indipendentemente dall'allocazione percentuale. L'esempio seguente assegna agli utenti del gruppo Beta Tester la variante Minima.

Nome del gruppo Variante
Beta Tester Minime

Varianti predefinite e opzione di terminazione

I flag di funzionalità variant hanno due valori predefiniti di variante, DefaultWhenEnabled e DefaultWhenDisabled.

  • La variante DefaultWhenEnabled ha effetto se il flag è abilitato ma l'allocazione non assegna tutti i percentili. Qualsiasi utente inserito in un percentile non assegnato riceve la variante DefaultWhenEnabled.
  • La variante DefaultWhenDisabled diventa effettiva se il flag è disabilitato, a tale scopo, impostando il campo Abilitato su false, noto anche come "kill switch".

L'opzione terminare viene usata per impedire agli utenti di allocare. Usato quando una o più varianti presentano un problema, che si tratti di un bug, di una regressione o di prestazioni insufficienti. Per usare l'opzione kill, impostare il campo Abilitato del flag variante su false. A tutti gli utenti viene ora assegnata la variante DefaultWhenDisabled, indipendentemente dai percentili o dagli utenti/gruppi di cui hanno eseguito l'override.

Creare un'app con un flag di funzionalità variante

In questa esercitazione viene creata un'app Web denominata CItazione del giorno. Quando l'app viene caricata, mostra una citazione. Gli utenti possono interagire con il pulsante a forma di cuore per aggiungere mi piace. Per migliorare il coinvolgimento degli utenti, si vuole verificare se un messaggio di saluto personalizzato aumenta il numero di utenti a cui piace la citazione. Gli utenti che ricevono la variante None non vedono alcun messaggio di saluto. Gli utenti che ricevono la variante Simple ricevono un semplice messaggio di saluto. Gli utenti che ricevono la variante Long ricevono un messaggio di saluto leggermente più lungo.

Prerequisiti

Creare un flag di funzionalità

  1. Creare un flag di funzionalità denominato Greeting senza etichetta nell'archivio di Configurazione app con tre varianti: None, Simple e Long, ognuna corrispondente a messaggi di saluto diversi. Per i valori di configurazione e le impostazioni di allocazione, vedere la tabella seguente. Per altre informazioni su come aggiungere una variante, vedere Creare un flag di funzionalità - Esperimento.

    Nome della variante Valore di configurazione variante Allocation (Allocazione)
    Nessuno (impostazione predefinita) Null 50%
    Semplice "Ciao!" 25%
    long "Spero che migliori la tua giornata!" 25%

Passaggi successivi

Continuare con le istruzioni seguenti per usare il flag di funzionalità variante nell'applicazione per il linguaggio o la piattaforma in uso