Partilhar via


Usar sinalizadores de recursos variantes

Os sinalizadores de recursos de variantes permitem que seu aplicativo ofereça suporte a várias variantes de um recurso. As variantes do seu recurso podem ser atribuídas a usuários, grupos ou buckets de percentis específicos. Esses sinalizadores podem ser úteis para distribuições de recursos, implementações de configuração e experimentação de recursos (também conhecidos como testes A/B).

O que é um sinalizador de recurso variante?

Um sinalizador de recurso variante é um sinalizador de recurso aprimorado que suporta vários 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, "showAds": 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 sinalizador de recurso variante

  1. Crie um sinalizador de recurso variante chamado Saudação sem rótulo em sua loja de configuração de aplicativos. Inclui 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 obter mais informações sobre como adicionar um sinalizador de recurso de variante, consulte Criar um sinalizador de recurso de variante.

    Nome da variante Valor de configuração da variante Alocação
    Nenhum (padrão) nulo 50%
    Simples "Olá!" 25%
    Longo "Espero que isto faça o seu dia!" 25%
  2. 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.