Partilhar via


Usar sinalizadores de recursos variantes

Os sinalizadores de variantes de funcionalidade são sinalizadores configurados com múltiplas variantes de uma funcionalidade. As variantes do seu recurso podem ser atribuídas a usuários, grupos ou buckets de percentis específicos. Estas flags podem ser úteis para experimentação de características (também conhecidas como testes A/B).

O que é um sinalizador de recurso variante?

Uma feature flag variante é uma feature flag que suporta múltiplos estados ou variações. Embora ainda possa ser ativado ou desativado, ele também permite diferentes variantes com configurações. Uma variante é definida com um Nome e um Valor de Configuração opcional. O nome é um identificador para distinguir variantes. O valor de configuração pode variar de primitivas JSON simples a objetos JSON complexos. Você pode usar variantes para diferenciar funcionalidades ou experiências do usuário e, opcionalmente, configurar essas funcionalidades ou experiências do usuário com valores de configuração variantes. Além disso, um sinalizador de recurso de variante inclui regras de alocação, que definem o público-alvo para cada variante.

Variantes

O exemplo a seguir mostra duas variantes usando objetos JSON para o valor de configuração.

Nome da variante Valor de configuração da variante
Mínimo { "maxitems": 10, "showAds": false }
Standard { "maxitems": 30, "mostrarAnúncios": true }

Alocação

A alocação controla qual segmento de usuários obtém cada variante. O exemplo a seguir aloca 10% dos usuários para obter a variante Minimal e 90% para obter a variante Standard .

Variante Alocação Observações
Mínimo 10% Atribua a variante aos usuários no percentil 0 a 10.
Standard 90% Atribua a variante aos usuários no percentil 10 a 100.

Substituições

Você pode atribuir variantes a grupos ou usuários específicos, independentemente da alocação percentual. O exemplo a seguir atribui aos usuários no grupo Beta Tester a variante Minimalista .

Nome do Grupo Variante
Testador Beta Mínimo

Variantes padrão e kill switch

Os sinalizadores de recurso variante têm dois padrões variantes, DefaultWhenEnabled e DefaultWhenDisabled.

  • A variante DefaultWhenEnabled entrará em vigor se o sinalizador estiver habilitado, mas a alocação não atribuir todos os percentis. Qualquer usuário colocado em um percentil não atribuído recebe a variante DefaultWhenEnabled .
  • A variante DefaultWhenDisabled entra em vigor se o sinalizador estiver desativado, definindo o campo Enabled como false, também conhecido como usando o "kill switch".

O kill switch é usado para impedir que os usuários alocem. Usado quando uma ou mais variantes têm um problema, seja um bug, regressão ou mau desempenho. Para usar o kill switch, defina o campo Enabled do sinalizador variante como false. Todos os usuários agora recebem a variante DefaultWhenDisabled , independentemente de quais percentis ou usuários/grupos substituídos eles faziam parte.

Criar um aplicativo com um sinalizador de recurso variante

Neste tutorial, você cria um aplicativo Web chamado Cotação do Dia. Quando o aplicativo é carregado, ele exibe uma cotação. Os usuários podem interagir com o botão do coração para gostar. Para melhorar o envolvimento do usuário, você deseja explorar se uma mensagem de saudação personalizada aumenta o número de usuários que gostam da citação. Os usuários que recebem a variante Nenhum não veem nenhuma saudação. Os usuários que recebem a variante Simple recebem uma mensagem de saudação simples. Os usuários que recebem a variante Long recebem uma saudação um pouco mais longa.

Pré-requisitos

Criar um marcador de funcionalidade

  1. Crie um flag de funcionalidade chamado Saudação sem etiqueta na sua loja de Configuração de Aplicações com três variantes: Nenhuma, Simples e Longa, cada uma correspondendo a diferentes mensagens de saudação. Consulte a tabela a seguir para obter seus valores de configuração e definições de alocação. Para mais informações sobre como adicionar uma variante, veja Criar um flag de funcionalidade - Experimentar.

    Nome da variante Valor de configuração da variante Alocação
    Nenhum (padrão) null 50%
    Simples "Olá!" 25%
    Longo "Espero que isto faça o seu dia!" 25%

Próximos passos

Continue com as instruções a seguir para usar o sinalizador de recurso variante em seu aplicativo para o idioma ou plataforma que você está usando