Condividi tramite


Usare flag di funzionalità varianti

I flag di funzionalità varianti consentono all'applicazione di supportare più varianti di una funzionalità. Le varianti della funzionalità possono essere assegnate a utenti, gruppi o bucket percentili specifici. Questi flag possono essere utili per le implementazioni di funzionalità, le implementazioni della configurazione e la sperimentazione delle funzionalità (nota anche come test A/B).

Che cos'è un flag di funzionalità varianti?

Un flag di funzionalità variant è un flag di funzionalità avanzato che supporta più stati o varianti. Anche se può ancora essere attivato o disattivato, consente anche varianti diverse con 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 varianti per distinguere le funzionalità o le esperienze utente e, facoltativamente, configurare queste funzionalità o esperienze utente con valori di configurazione varianti. Inoltre, un flag di funzionalità variant include regole di allocazione, che definiscono il gruppo di destinatari per ogni variante.

Varianti

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

Nome variante Valore di configurazione variant
Minima { "maxitems": 10, "showAds": false }
Standard { "maxitems": 30, "showAds": true }

Allocazione

L'allocazione controlla il segmento di utenti che ottengono ogni variante. Nell'esempio seguente viene allocato il 10% degli utenti per ottenere la variante Minima e il 90% per ottenere la variante Standard .

Variant Allocazione Osservazioni:
Minima 10% Assegnare la variante agli utenti nel 0° al 10° percentile.
Standard 90% Assegnare la variante agli utenti nel 10° al 100° percentile.

Overrides

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

Nome gruppo Variant
Beta Tester Minima

Varianti predefinite e cambio di terminazioni

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

  • La variante DefaultWhenEnabled diventa effettiva 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, fatto impostando il campo Abilitato su false, noto anche come "kill switch".

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

Creare un'app con un flag di funzionalità variante

In questa esercitazione viene creata un'app Web denominata Quote of the Day. Quando l'app viene caricata, mostra una citazione. Gli utenti possono interagire con il pulsante di cuore per piacerlo. Per migliorare l'engagement degli utenti, si vuole verificare se un messaggio di saluto personalizzato aumenta il numero di utenti che amano l'offerta. 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 saluto leggermente più lungo.

Prerequisiti

Creare un flag di funzionalità varianti

  1. Creare un flag di funzionalità variante denominato Greeting senza etichetta nell'archivio Configurazione app. Include 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 un flag di funzionalità varianti, vedere Creare un flag di funzionalità varianti.

    Nome variante Valore di configurazione variant Allocazione
    Nessuno (impostazione predefinita) Null 50%
    Semplice "Hello!" 25%
    Lungo "Spero che questo faccia il vostro giorno!" 25%
  2. Continuare con le istruzioni seguenti per usare il flag di funzionalità variant nell'applicazione per il linguaggio o la piattaforma in uso.