Filtro de Audiência — editor de audiência do bloco
AudienceFilterEditor — um editor separado que define para quem mostrar o bloco. Disponível em todas as telas de configurações do Wave-2 (Complemento do carrinho, Similar ao carrinho, Similar à lista de desejos, Frequentemente encomendado, blocos recomendativos).
Por que isso é necessário
Frequentemente, o bloco recomendativo deve ser exibido não para todos, mas para um segmento específico de usuários. Por exemplo:
- bloco "Brinquedos para meninos de 5 a 10 anos" — mostrar apenas para aqueles cujo perfil de usuário contém uma criança nessa faixa etária;
- bloco "Produtos Premium" — apenas para usuários de Moscovo e São Petersburgo;
- bloco "Descontos de fim de semana" — apenas para assinantes da newsletter.
O Filtro de Audiência permite descrever tais regras sem programação.
Estrutura da regra
Cada regra de audiência é construída com base em uma estrutura de seletores em cascata:
- Conjunto de atributos — por exemplo, "Perfil do usuário" (veja conjuntos de atributos).
- Atributo dentro do conjunto — por exemplo, "Idade", "Cidade", "É assinante".
- Operador —
igual,dentro do intervalo,está na lista, etc. - Valor — valor específico, intervalo ou array de valores (dependendo do operador).
- Categorias de conteúdo — seleção múltipla de páginas nas quais essa regra se aplica.
Após preencher todos os cinco campos, a regra é salva e aplicada ao bloco.
A cascata "conjunto → atributo" é preenchida a partir dos conjuntos de atributos do usuário existentes. Se no projeto ainda não houver um conjunto adequado — crie um (por exemplo, "Perfil do usuário") e adicione atributos (Idade, Cidade, Assinante, etc.). Para a regra de idade (intervalo min..max) é necessário um atributo numérico — em atributos de texto, o intervalo não aparecerá.
Atributo de idade (age attribute)
Para a idade, existe uma tipificação separada — ageAttribute. Esta regra possui um intervalo numérico min..max, descrito separadamente no Swagger DTO (ageAttribute / ageValueType / ageValue).
Na interface, isso fornece um input conveniente de intervalo com dois campos (de — até), em vez de um único valor:
min = 5, max = 10— usuários com idades de 5 a 10 anos.min = 18, max = null— usuários acima de 18 anos (sem limite superior).
ageAttribute é conveniente para segmentação etária (produtos infantis, 18+, aposentados) — sem ele, seria necessário descrever o intervalo com duas regras separadas.
Várias regras
No Filtro de Audiência, é possível adicionar várias regras — elas são aplicadas com a lógica "E" (todas as regras devem ser verdadeiras).
Se precisar da lógica "OU" entre as condições — configure-as através do motor de atributos (veja tipos de atributos) ou use um valor composto em um único atributo.
Categorias de conteúdo
O último passo — seleção de categorias, nas quais a regra é válida. Esta é uma seleção múltipla de páginas do projeto.
Se as categorias não forem selecionadas — a regra é aplicada globalmente (em todas as páginas do projeto onde este bloco está embutido).
Comportamento "pronto para uso"
Se o Filtro de Audiência não estiver configurado — o bloco é exibido para todos os usuários em todas as páginas onde está vinculado. Ative o filtro apenas quando precisar de segmentação.
Antes de publicar o bloco, verifique como a regra de audiência funcionará — abra o Modal de Pré-visualização e veja a aba Investigar: lá você pode ver qual regra foi aplicada (appliedAudienceRule) e quais avisos o sistema gerou.