O menu 'Adicionar cláusula': grupos booleanos (E, OU, NÃO) no topo, depois cláusulas de trait, de evento e de segmento.
Grupos: E, OU e NÃO
Antes das condições, vêm os grupos, que dizem como elas se combinam:- E (AND) — todas as condições filhas precisam ser verdadeiras.
- OU (OR) — pelo menos uma precisa ser verdadeira.
- NÃO (NOT) — inverte a condição filha. Serve para excluir quem bate em algo — por exemplo, comprou nos últimos 30 dias e não está no segmento de cancelados.
O grupo NÃO só aparece no menu quando a regra já tem pelo menos uma cláusula positiva.
Faz sentido: o segmento precisa primeiro de algo que inclua pessoas para depois você
excluir um grupo — senão não haveria audiência para negar. Monte a condição positiva (quem
entra) e só então use o NÃO para tirar quem você não quer.
Operadores
Vários tipos de cláusula (Trait do perfil e os Filtros das cláusulas de evento) usam o mesmo conjunto de operadores para comparar um campo com um valor:O operador não existe não é suportado dentro de segmentos. Para “o cliente não tem tal
comportamento”, use a cláusula Evento não ocorreu (mais abaixo).
Cláusulas de trait
Trait do perfil
Compara um trait do perfil com um valor fixo. É a cláusula mais leve — ela só olha os traits do perfil, sem consultar eventos.
Trait do perfil: a chave do trait, um operador e um valor.
traits.<chave>.value, ex.:
traits.lifetime_value.value), o operador (da tabela acima) e o valor de comparação.
Exemplos: plano é premium; lifetime_value maior ou igual 100; cidade está em
[São Paulo, Rio]; email existe.
Trait mudou
Verifica se o valor de um trait mudou dentro de uma janela de tempo — olhando o histórico de mudanças, não só o valor atual.
Trait mudou: chave, janela em dias e filtros opcionais por novo valor / valor anterior.
snake_case) e a janela em dias. Há ainda dois filtros
opcionais:
- Filtrar por novo valor — condiciona o valor para o qual o trait passou (ex.: mudou
para
cancelado). - Filtrar por valor anterior — condiciona o valor que o trait tinha antes (ex.: saiu de
ativo).
status mudou para cancelado nos últimos 7 dias — útil para reagir a uma
mudança específica, não só ao estado final.
Cláusulas de evento
Todas as cláusulas de evento compartilham dois elementos:- uma janela em dias (de 1 a 365) — o período recente que será olhado;
- uma aba de Filtros — condições sobre as propriedades do evento, usando os mesmos
operadores (ex.: só compras com
amount>100).
Evento ocorreu
O perfil disparou o evento dentro da janela.
Evento ocorreu: escolha o evento, a versão e a janela. A aba Filtros condiciona as propriedades.
Purchase@1 nos últimos 30 dias com payment_method é pix.
Evento não ocorreu
O oposto: o perfil não disparou o evento (respeitando os filtros, se houver) dentro da janela.
Evento não ocorreu: mesma configuração do anterior, com a lógica invertida.
Login nos últimos 60 dias, ou não comprou
(Purchase) nos últimos 90 dias. Costuma vir junto de uma cláusula positiva (ex.: é cliente
E não comprou há 90 dias).
Contagem de eventos
Conta quantas vezes o evento ocorreu na janela e compara esse número com um valor.
Contagem de eventos: além de Evento e Filtros, a aba Contagem define o operador e o número.
≥, >, =, ≤, <, ≠) e o número. Exemplo: comprou ≥ 3 vezes nos últimos 90 dias
(clientes recorrentes).
Agregação de evento
Em vez de contar ocorrências, calcula algo sobre uma propriedade numérica do evento e compara com um valor. As funções são soma, média, máximo e mínimo. A configuração é como a de contagem (Evento, Filtros e uma aba para escolher a função e a propriedade). Exemplos:- Soma de
amountnas compras ≥ 1.000 → clientes de alto valor acumulado. - Média de
amount≥ 200 → ticket médio alto. - Máximo de
amount≥ 5.000 → já fez ao menos uma compra grande.
Funil de eventos
Uma sequência ordenada de eventos: eles precisam ter acontecido na ordem, dentro da janela.
Funil: as etapas em ordem, e a profundidade mínima (quantas etapas completar).
Cláusula de segmento
Pertence a segmento
O perfil é membro de outro segmento. Permite reaproveitar audiências como blocos de montar.
Pertence a segmento: escolha outro segmento. Os que criariam um ciclo ficam desabilitados.
Segmentos que criariam um ciclo (A depende de B, que depende de A) ficam desabilitados no
seletor — assim você não monta uma dependência circular sem querer.
Limites de uma regra
Para manter as consultas saudáveis, uma regra tem limites:Bom saber
A janela é sempre em dias
As cláusulas de evento e “Trait mudou” olham para uma janela recente — de 1 a 365 dias. Janelas
maiores cobrem mais histórico, mas pesam mais na consulta.
Só eventos ativos aparecem
Os seletores de evento mostram apenas eventos com definição ativa.
Cláusula de trait é a mais leve
Condições só de trait consultam o perfil direto (rápido e barato). Assim que entra um evento na
regra, a consulta passa a ser mais pesada — algo que a prévia sinaliza
no custo estimado.