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:| Operador | Significa | Exemplo |
|---|---|---|
| é / não é | igual / diferente | plano é "premium" |
| maior que / maior ou igual | > / ≥ | lifetime_value ≥ 100 |
| menor que / menor ou igual | < / ≤ | idade < 18 |
| está em / não está em | dentro / fora de uma lista | cidade está em [SP, RJ] |
| contém | tem o trecho (texto) ou o item (lista) | tags contém "vip" |
| existe | o campo tem algum valor | email existe |
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.
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.
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.
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.
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.
≥, >, =, ≤, <, ≠) 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.
Cláusula de segmento
Pertence a segmento
O perfil é membro de outro segmento. Permite reaproveitar audiências como blocos de montar.
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:| Limite | Valor |
|---|---|
| Profundidade de aninhamento de grupos | 5 |
| Total de nós (grupos + cláusulas) | 50 |
| Cláusulas de trait | 20 |
| Cláusulas de evento (incluindo funil) | 10 |
| Cláusulas “Trait mudou” | 10 |
| Cláusulas “Pertence a segmento” | 5 |
| Filtros por cláusula | 10 |
| Etapas de um funil | 10 |
| Janela de tempo | 1 a 365 dias |
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.