View a markdown version of this page

Criação de regras de público - AWS AppConfig

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criação de regras de público

A seção de regras de público inclui uma guia Construtor de regras e uma guia Editor para criar regras para atingir um público-alvo para o experimento.

Usando o criador de regras de público

O criador de regras fornece uma interface visual para definir regras de segmentação de público sem escrever expressões. Você pode criar condições usando atributos e combiná-las com operadores lógicos para controlar quais usuários serão incluídos no experimento. No criador de regras, você define regras combinando condições e grupos:

  • As condições avaliam um único atributo (por exemplo,$plan equals "enterprise").

  • Os grupos combinam várias condições usando operadores lógicos, como AND ouOR.

Cada grupo é avaliado como um true oufalse. Os usuários que atendem à regra geral são incluídos no público-alvo.

Use o criador de regras quando quiser:

  • Defina ou modifique rapidamente as regras do público sem escrever expressões

  • Visualize como as condições são agrupadas e avaliadas

  • Crie e valide a lógica de segmentação de forma incremental

Veja alguns exemplos:

Uma regra para segmentar usuários no nível da conta Premium.

Uma imagem da guia Construtor de regras em AWS AppConfig experimentação com uma amostra de regra de público especificada.

Uma regra para segmentar usuários em uma região geográfica específica usando um domínio de e-mail específico.

Uma segunda imagem da guia Construtor de regras em AWS AppConfig experimentação com amostra de regra de público especificada.

Uma regra para segmentar usuários em um plano específico em um plano específico ou usar um plano secundário enquanto optam por um programa beta.

Uma terceira imagem da guia Construtor de regras em AWS AppConfig experimentação com amostra de regra de público especificada.

Relacionamento com o editor

O criador de regras e o editor definem a mesma lógica de segmentação em formatos diferentes:

  • O criador de regras fornece uma forma visual de criar regras.

  • O editor mostra a expressão lógica equivalente.

As alterações feitas em uma visualização são refletidas na outra.

Práticas recomendadas

  • Mantenha as regras legíveis — Use grupos para organizar as condições de forma lógica e evitar estruturas profundamente aninhadas.

  • Validar valores de atributos — Certifique-se de que os nomes e valores dos atributos correspondam aos fornecidos pelo seu aplicativo.

  • Teste antes da exposição — Use 0% de exposição e substituições de atribuição de tratamento para confirmar se suas regras se comportam conforme o esperado.

Usando o editor

O editor permite definir regras de segmentação que determinam quais usuários serão incluídos em um experimento. Você especifica essas regras como expressões lógicas que avaliam os atributos do usuário ou do dispositivo, como plataforma, região ou versão do aplicativo. Quando um experimento é executado,AWS AppConfig avalia a expressão para cada usuário. Os usuários que atendem aos critérios são incluídos no público-alvo e podem ser designados para tratamentos.

Formato de expressão

As expressões usam uma sintaxe de prefixo (estilo de função):

(operator argument1 argument2 ...)

Por exemplo:

(and (eq $system "iPhone") (lt $osVersion 1.8) )

Essa expressão inclui usuários que:

  • Use um iPhone e

  • Ter uma versão do sistema operacional anterior à 1.8

O editor oferece suporte aos mesmos cenários de segmentação do criador de regras. Para exemplos visuais de regras de público, consulteUsando o criador de regras de público.

Definindo atributos

Os atributos representam propriedades do usuário ou do ambiente que está sendo avaliado. Os atributos são referenciados com um $ prefixo.

Os exemplos comuns incluem:

  • $system— tipo de dispositivo ou plataforma

  • $osVersion— versão do sistema operacional

  • $region— região geográfica

  • $appVersion— versão do aplicativo

Os atributos disponíveis dependem do seu aplicativo e de como os dados são transmitidos AWS AppConfig.

Escrevendo expressões

Você pode combinar várias condições usando operadores lógicos:

  • Use and para exigir que todas as condições sejam verdadeiras

  • Use or para corresponder a qualquer condição

  • Use not para excluir condições

Exemplo:

(and (eq $region "us-east-1") (or (eq $system "iPhone") (eq $system "Android") ) )

Essa expressão tem como alvo usuários us-east-1 que usam dispositivos iPhone ou Android.

Práticas recomendadas

  • Comece de forma simples — comece com um pequeno conjunto de condições e expanda conforme necessário.

  • Validar atributos — Certifique-se de que os atributos usados nas expressões sejam preenchidos de forma consistente.

  • Evite expressões excessivamente complexas — a lógica complexa pode dificultar a compreensão e a manutenção da segmentação.

  • Teste antes da exposição — Use 0% de exposição e substituições de atribuição de tratamento para confirmar se suas regras se comportam conforme o esperado.

Operadores de expressão

Os operadores a seguir são compatíveis com expressões de público.

Operadores lógicos

Operador Description Exemplo

and

Retorna verdadeiro se todas as condições forem verdadeiras

(and (eq $region "us") (eq $system "iPhone"))

or

Retorna verdadeiro se alguma condição for verdadeira

(or (eq $system "iPhone") (eq $system "Android"))

not

Retorna verdadeiro se a condição for falsa

(not (eq $region "eu-west-1"))

Operadores de comparação

Operador Description Exemplo

eq

Igual

(eq $system "iPhone")

ne

Not equal

(ne $region "us-west-2")

lt

Menor que

(lt $osVersion 1.8)

lte

Menor ou igual a

(lte $osVersion 2.0)

gt

Maior que

(gt $appVersion 5.0)

gte

Maior ou igual a

(gte $appVersion 5.0)

Operadores de string e set

Operador Description Exemplo

in

Corresponde a qualquer valor em uma lista

(in $region ["us-east-1" "us-west-2"])

contém

Verifica se um valor contém uma substring

(contains $deviceName "iPhone")

nota

Os operadores disponíveis podem variar dependendo de como os atributos são definidos e avaliados em seu aplicativo.