Pular para o conteúdo

Coortes

Uma coorte é um grupo nomeado de pessoas definido por condições, avaliado com antecedência. Uma única definição de coorte serve à plataforma inteira: segmentação de feature flags, audiências de campanhas e análise.

Dois tipos, combinados com AND:

  • Condições de traits — sobre as propriedades atuais da pessoa: plan exact "pro", company icontains "acme".
  • Condições de comportamento — “fez o evento X pelo menos N vezes nos últimos Y dias”: checkout ≥ 3 vezes em 30 dias. A contagem de comportamento resolve merges de identidade, então a atividade de um usuário em vários dispositivos conta como uma pessoa só.

O pertencimento a coortes é pré-computado: as definições são avaliadas em um cronograma (a cada ~10 minutos) e a lista de membros é trocada atomicamente — os consumidores nunca observam uma coorte construída pela metade.

O que isso compra e o que custa:

  • A avaliação de flags e o matching de campanhas leem o pertencimento como um lookup simples — sem queries pesadas nos hot paths, então o /decide continua rápido não importa quão complexas fiquem as suas definições de coorte.
  • O pertencimento pode estar até ~10 minutos defasado. Para flags e audiências de campanha, esse é o trade-off certo; coortes não são uma primitiva de tempo real. Se você precisa de um override de segmentação imediato para uma avaliação, passe person_properties para o /decide.

As coortes vivem no painel, ao lado das feature flags. Como as flags, são tratadas como configuração sensível: qualquer membro do projeto pode vê-las, alterá-las exige papel de admin — editar uma coorte pode mudar quem recebe uma campanha.