Delen via


Variantfunctievlagmen gebruiken

Met variantfunctievlagmen kan uw toepassing ondersteuning bieden voor meerdere varianten van een functie. De varianten van uw functie kunnen worden toegewezen aan specifieke gebruikers, groepen of percentielbuckets. Deze vlaggen kunnen handig zijn voor functie-implementaties, configuratie-implementaties en functieexperimenten (ook wel A/B-tests genoemd).

Wat is een variantfunctievlag?

Een variantfunctievlag is een uitgebreide functievlag die ondersteuning biedt voor meerdere statussen of variaties. Hoewel het nog steeds kan worden in- of uitgeschakeld, is het ook mogelijk om verschillende varianten met configuraties toe te staan. Een variant wordt gedefinieerd met een naam en een optionele configuratiewaarde. De naam is een id om varianten van elkaar te onderscheiden. De configuratiewaarde kan variëren van eenvoudige JSON-primitieven tot complexe JSON-objecten. U kunt varianten gebruiken om functies of gebruikerservaringen te onderscheiden en deze functionaliteiten of gebruikerservaringen optioneel te configureren met variantconfiguratiewaarden. Daarnaast bevat een variantfunctievlag toewijzingsregels, waarmee de doelgroep voor elke variant wordt gedefinieerd.

Varianten

In het volgende voorbeeld ziet u twee varianten met behulp van JSON-objecten voor de configuratiewaarde.

Variantnaam Variantconfiguratiewaarde
Minimaal { "maxitems": 10, "showAds": false }
Standaard { "maxitems": 30, "showAds": true }

Toewijzing

Toewijzing bepaalt welk segment van gebruikers elke variant krijgt. In het volgende voorbeeld wordt 10% van de gebruikers toegewezen om de minimale variant en 90% op te halen om de Standard-variant op te halen.

Variant Toewijzing Opmerkingen
Minimaal 10% Wijs de variant toe aan gebruikers in het 0e naar het 10e percentiel.
Standaard 90% Wijs de variant toe aan gebruikers in het 10e naar het 100e percentiel.

Overschrijvingen

U kunt varianten toewijzen aan specifieke groepen of gebruikers, ongeacht de percentagetoewijzing. In het volgende voorbeeld worden gebruikers in de bèta-testergroep de minimale variant toegewezen.

Groepsnaam Variant
Bèta-tester Minimaal

Standaardvarianten en kill-switch

Markeringen voor variantfuncties hebben twee standaardvarianten: DefaultWhenEnabled en DefaultWhenDisabled.

  • De variant DefaultWhenEnabled wordt van kracht als de vlag is ingeschakeld, maar de toewijzing wijst niet alle percentielen toe. Elke gebruiker die in een niet-toegewezen percentiel is geplaatst, ontvangt de variant DefaultWhenEnabled .
  • De variant DefaultWhenDisabled wordt van kracht als de vlag is uitgeschakeld, gedaan door het veld Ingeschakeld in te stellen op false, ook wel bekend als het gebruik van de 'kill switch'.

De kill-switch wordt gebruikt om te voorkomen dat gebruikers worden toegewezen. Wordt gebruikt wanneer een of meer van de varianten een probleem hebben: of het nu gaat om een bug, regressie of slechte prestaties. Als u de kill-switch wilt gebruiken, stelt u het veld Ingeschakeld van de variantvlag in op false. Alle gebruikers krijgen nu de variant DefaultWhenDisabled , ongeacht van welke percentielen of overschreven gebruikers/groepen ze deel uitmaakten.

Een app bouwen met een variantfunctievlag

In deze zelfstudie maakt u een web-app met de naam Quote of the Day. Wanneer de app is geladen, wordt er een offerte weergegeven. Gebruikers kunnen de hartknop gebruiken om het leuk te vinden. Als u de betrokkenheid van gebruikers wilt verbeteren, wilt u bekijken of een gepersonaliseerde begroetingsbericht het aantal gebruikers verhoogt dat de offerte leuk vindt. Gebruikers die de variant None ontvangen, zien geen begroeting. Gebruikers die de Simple-variant ontvangen, krijgen een eenvoudig begroetingsbericht. Gebruikers die de Long-variant ontvangen, krijgen een iets langere begroeting.

Vereisten

Een variantfunctievlag maken

  1. Maak een variantfunctievlag met de naam Greeting zonder label in uw App Configuration-archief. Het bevat drie varianten: Geen, Eenvoudig en Lang, die elk overeenkomen met verschillende begroetingsberichten. Raadpleeg de volgende tabel voor de configuratiewaarden en toewijzingsinstellingen. Zie Een variantfunctievlag maken voor meer informatie over het toevoegen van een variantfunctievlag.

    Variantnaam Variantconfiguratiewaarde Toewijzing
    Geen (standaard) Nul 50%
    Eenvoudig "Hallo!" 25%
    Lang "Ik hoop dat dit uw dag maakt!" 25%
  2. Ga door naar de volgende instructies voor het gebruik van de vlag voor variantfuncties in uw toepassing voor de taal of het platform dat u gebruikt.