Filtros calculados
Os filtros calculados permitem criar segmentos muito precisos ao longo de um período estendido do histórico de um usuário. Por exemplo, use filtros calculados para direcionar usuários que compraram um produto específico um determinado número de vezes nos últimos 16 meses ou que concluíram um evento de eCommerce que corresponde a valores de propriedade específicos. Refine esse público usando propriedades de eventos para tornar o direcionamento ainda mais granular.

Os filtros calculados estão atualmente em acesso antecipado. Se você tem interesse em participar do acesso antecipado, entre em contato com o seu gerente de conta da Braze.
Como funciona
Os Segments da Braze oferecem ferramentas de direcionamento poderosas para criar grupos dinâmicos de usuários. Para a maioria dos casos de uso, isso é suficiente para alcançar seu público de forma eficaz. Os filtros calculados foram projetados para casos de uso avançados em que você precisa analisar comportamentos de até dois anos atrás ou aplicar lógica complexa, sem comprometer a retenção de dados ou o desempenho do sistema. Use filtros de atividade do usuário para critérios de compra e eventos de eCommerce, ou filtros de objeto de dados para direcionamento por conta e objetos personalizados.
Por exemplo, a segmentação padrão da Braze encontra usuários que atendem a critérios específicos que você define, como identificar um usuário que comprou recentemente um dos seus produtos. Os filtros calculados permitem ir mais fundo, como identificar usuários que compraram uma cor específica de um produto pelo menos duas vezes entre 18 e 24 meses atrás. Os filtros calculados são um aprimoramento, não um requisito. Se você precisa de filtros mais avançados ou de uma janela histórica mais longa, eles são uma ótima ferramenta para ajudar, mantendo o uso de dados otimizado.
Filtros calculados e extensões de segmento SQL
Extensões de segmento SQL e filtros calculados ajudam a criar públicos com base no comportamento de compra, mas usam ferramentas e fontes de dados diferentes. As extensões de segmento SQL usam SQL que você escreve nas consultas contra seus dados conectados do Snowflake.
| Comportamento | Filtros calculados | Extensões de segmento SQL |
|---|---|---|
| Como você define o público | Escolha compras ou eventos recomendados de eCommerce, além de contagens, janelas de tempo e filtros de propriedade opcionais | Escreva SQL na sua conexão com o Snowflake; use modelos, atualização incremental ou atualização completa |
| Onde a lógica é executada | Os critérios e a atualização são gerenciados na Braze como filtros calculados | A consulta é executada no contexto do seu data warehouse de acordo com a configuração da extensão |
| Página de lista de filtros | Uma lista compartilhada para filtros de atividade do usuário e de objetos de dados. A coluna Segments mostra quantos segmentos usam cada filtro, e os status de processamento refletem o estado de geração | Inclui uma coluna Type e filtros que variam por tipo de extensão |
| Casos de uso típicos | Frequência de compra e regras baseadas em propriedades dentro da janela selecionada | Lógica apoiada pelo data warehouse, junções entre tabelas, agregações de gastos e janelas históricas além do formulário de filtros calculados |
Quando usar filtros calculados
Use filtros calculados quando as regras guiadas pelo dashboard para atividade do usuário ou objetos de dados forem suficientes e você não precisar de SQL arbitrário em tabelas do data warehouse.
Quando usar outros tipos de extensão de segmento
Use extensões de segmento SQL quando precisar de SQL completo, dados apoiados pelo Snowflake, modelos ou modos de atualização projetados para consultas grandes ou complexas no data warehouse. Use extensões de segmento CDI quando precisar de SQL que consulte diretamente o seu data warehouse usando dados de conexões de ingestão de dados na nuvem. Use extensões de segmento (extensão simples) para critérios de interação com canais de mensagem quando precisar consultar dados além das interações recentes.
Usando filtros calculados e extensões de segmento juntos
Um segmento pode referenciar um filtro calculado junto com uma extensão de segmento SQL ou CDI — por exemplo, uma coorte definida no data warehouse a partir de uma extensão, combinada com regras de compra que você mantém no criador de filtros calculados.
Criar um filtro calculado
Para criar um filtro calculado, escolha um tipo de filtro quando solicitado, defina seus critérios e, em seguida, salve e ative o filtro antes de usá-lo em um Segment.
Etapa 1: Configurar os detalhes
- Acesse Público > Filtros Calculados.
- Selecione Criar filtro.
- Se o seu espaço de trabalho tiver Contas ativadas, selecione um tipo de filtro:
- Filtros de atividade do usuário: Ações e comportamentos dos usuários.
- Filtros de objeto de dados: Atributos e relacionamentos para objetos de dados.
- Insira um nome que descreva o público que você pretende direcionar. Um nome descritivo facilita encontrar o filtro ao adicioná-lo a um Segment.
- (Opcional) Adicione tags para organizar filtros calculados no seu espaço de trabalho.
Para filtros de atividade do usuário, selecione Ativar atualização recorrente de público para atualizar o filtro em um cronograma recorrente. Se você não ativar essa configuração, o filtro não será atualizado a menos que você o atualize ou selecione Atualizar público. Filtros de objeto de dados são atualizados de hora em hora.
Etapa 2: Escolher seus critérios
Se você selecionou Filtros de objeto de dados, escolha um objeto de dados e adicione condições de atributo, relacionamento ou grupo de filtros. Para direcionamento baseado em contas, consulte Objetos de conta.
Se Criar filtro abrir diretamente o construtor de atividade do usuário, ou se você selecionar Filtros de atividade do usuário, escolha uma das seguintes opções de Critério para direcionamento:
- Realizou uma compra
- Realizou um evento de eCommerce
Depois de selecionar um tipo de evento, escolha o evento específico, quantas vezes o usuário deve tê-lo concluído (mais que, menos que ou igual a) e o período de tempo.

Os filtros mais que e menos que são exclusivos — eles não incluem o número especificado. Por exemplo, um filtro para mais que 4 vezes e menos que 16 vezes inclui usuários que realizaram 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 ou 15 vezes.
Ao escolher o período de tempo, você pode especificar um intervalo de datas relativo (os últimos X dias), uma data de início, uma data de término ou um intervalo de datas exato. Para intervalos relativos, insira de 1 a 730 dias (dois anos). Para intervalos de datas absolutos, a data de início deve estar nos últimos dois anos e a data de término deve estar nos próximos dois anos.
Segmentação por propriedade de evento
Para aumentar a precisão do direcionamento, selecione Adicionar filtros de propriedade de evento. Isso permite filtrar por propriedades da sua compra ou evento de eCommerce. A Braze oferece suporte à segmentação por propriedade de evento com base em objetos de string, numéricos, booleanos e de tempo.
Para propriedades de string, insira vários valores de uma vez — por exemplo, direcionando usuários com status igual a ouro, prata ou bronze. Para eventos recomendados de eCommerce, o menu suspenso de propriedades é preenchido com as propriedades disponíveis para aquele evento.

Você não precisa de filtros calculados para usar propriedades de evento no seu Segment. Os filtros calculados apenas estendem a janela histórica usada para criar um Segment padrão. Você pode criar um Segment padrão em tempo real que use propriedades de evento dos últimos 30 dias. Da mesma forma, você pode agendar sua mensagem para disparar em tempo real com base em uma propriedade de evento — sem necessidade de filtro calculado.
Etapa 3: Salvar e ativar seu filtro
Selecione Salvar como rascunho para salvar um novo filtro calculado sem ativá-lo. Para um filtro já ativado, selecione Salvar alterações para salvar suas atualizações. Você deve selecionar Ativar filtro antes que o filtro esteja disponível no criador de segmentos.
Depois que você ativar um filtro calculado, a Braze começa a calcular o público dele. Quando o processamento for concluído, você poderá selecionar o filtro ao construir um público.
Usar um filtro calculado em um Segment
Depois de criar e ativar um filtro calculado, adicione-o ao criar um Segment ou definir um público para uma Campaign ou Canvas.
- No criador de segmentos, abra a lista de filtros.
- Em Outros filtros, selecione Filtro calculado existente.
- Selecione o filtro calculado a ser incluído na definição do Segment.
Depois de adicionar o filtro, selecione o ícone ao lado do menu suspenso do filtro para visualizar os detalhes do filtro e confirmar os critérios aplicados ao seu público.

Para saber mais sobre como criar segmentos, consulte Criar um Segment.
Gerenciar filtros calculados
Acesse Audience > Calculated Filters para visualizar, editar e gerenciar filtros calculados no seu espaço de trabalho.
A página Calculated Filters lista filtros de atividade do usuário e de objetos de dados juntos. Você pode refinar a lista com os controles disponíveis, mas a página não inclui um controle de filtro por tipo nem uma coluna Type. Use a coluna Segments para ver quantos Segments usam cada filtro calculado.
Rótulos de status
Cada filtro calculado exibe um dos status a seguir. Processing e Processing failed são exibidos quando a geração de membros está em andamento ou não foi concluída com sucesso.
| Status | Descrição |
|---|---|
| Active | O filtro está ativado e disponível para uso em Segments. |
| Draft | O filtro foi salvo, mas não ativado. |
| Archived | O filtro está arquivado. |
| Refresh disabled | As atualizações recorrentes de público estão desativadas. A Braze pode definir esse status automaticamente quando um filtro com atualização agendada fica sem uso. |
| Processing | A Braze está processando uma atualização do filtro. |
| Processing failed | A tentativa de processamento mais recente não foi concluída com sucesso. |
Editar e gerenciar filtros individuais
Abra o menu de linha de um filtro calculado para realizar uma ação. As ações que você vê dependem do status do filtro.
Para filtros que não estão arquivados, o menu de linha inclui Edit, Messaging use, Archive e Update audience. Update audience está disponível para filtros ativos que não estão em processamento. Você pode editar um filtro calculado enquanto ele está em processamento, mas não pode salvar suas alterações até que o processamento seja concluído.
Arquivar
Antes de arquivar um filtro calculado, verifique se ele ainda está em uso. O arquivamento pode silenciosamente interromper Campaigns, Canvas ou Segments ativos que fazem referência a ele.
- Filtros de objetos de dados: Se uma Campaign, Canvas ou Segment ativo ainda faz referência ao filtro, arquivá-lo significa que essa Campaign, Canvas ou Segment não corresponderá a nenhum usuário na próxima vez que for lançado ou enviado. Remova a referência primeiro para evitar isso.
- Filtros de atividade do usuário: Se uma Campaign ou Canvas em rascunho ainda faz referência ao filtro, arquivá-lo congela o público desse rascunho nos últimos resultados atualizados do filtro. Ele não será atualizado no futuro, a menos que você remova a referência primeiro.
Para descobrir onde um filtro está sendo usado, selecione Messaging use no menu de linha.
Você não pode arquivar um filtro calculado que é referenciado por uma Campaign, Canvas ou Segment ativo (não em rascunho). Remova essas referências antes de arquivar. Se você está arquivando vários filtros de tipos diferentes ao mesmo tempo, verá uma confirmação separada para cada tipo.

Seu espaço de trabalho pode ter até 100 filtros calculados ativos por vez. Entre em contato com o gerente de conta da Braze se precisar aumentar esse limite.
Desarquivar
Você pode desarquivar um filtro de qualquer uma das seguintes formas:
- Selecione Unarchive no menu de linha do filtro.
- Selecione um ou mais filtros arquivados e então selecione Unarchive.
- Abra um filtro calculado arquivado e selecione Unarchive na página dele.
Quando você desarquiva um filtro, o status dele retorna ao que era antes do arquivamento:
- Um rascunho retorna para Draft.
- Um filtro ativado retorna para Active, conta para o limite de filtros ativos, e a Braze inicia uma atualização de público.
Aguarde até que o processamento termine antes de desarquivar um filtro que mostra Processing. Se você atingiu o limite de filtros ativos, arquive um filtro ativo antes de desarquivar outro filtro ativo.
Salvar versus ativar
Você pode salvar um filtro calculado sem ativá-lo. Filtros inativos permanecem no seu espaço de trabalho, mas não podem ser adicionados a Segments até que você os ative. Selecione Activate filter para usar o filtro na segmentação.
Considerações
Os filtros calculados avaliam quantas vezes um usuário completou um evento dentro da janela selecionada. Eles não somam valores entre eventos, como receita total ou gasto ao longo do tempo. Para limites de gastos ou outras agregações entre compras, use as extensões de segmento SQL.
Regras baseadas em propriedades de compra e eCommerce
Quando eventos de compra ou eCommerce incluem as propriedades de que você precisa — como categoria do produto, ID da loja ou código promocional — é possível direcionar usuários com filtros de propriedade de evento. Exemplos incluem usuários que usaram um código promocional específico durante um intervalo de datas, compraram uma categoria de produto nos últimos 12 meses ou fizeram compras em uma loja específica. Padrões de compradores inativos (por exemplo, comprou em uma janela, mas não em outra) funcionam combinando filtros calculados em um Segment.
Atributos de perfil e direcionamento baseado em localização
- Atributos de perfil: Direcione pontos de fidelidade, níveis ou outros valores armazenados no perfil de usuário com filtros de Segment padrão, não com filtros calculados.
- Distância ou proximidade: a Braze não calcula distância geográfica em filtros calculados. Pré-calcule as distâncias no seu próprio serviço, armazene o resultado no perfil de usuário e depois segmente com base nesse atributo.
Interações com canais de mensagem
Para critérios de engajamento com mensagem (como aberturas de e-mail ou interações com push), use as extensões de segmento quando precisar consultar dados além das interações recentes. Os filtros calculados com critérios de interação de canal de mensagem (quando disponíveis no seu espaço de trabalho) avaliam dados recentes de interação com mensagens. Eles não utilizam o mesmo preenchimento retroativo de dois anos de dados usado nos critérios de compra e eCommerce.
Perguntas frequentes
Posso criar um filtro calculado que usa vários eventos personalizados?
Ao usar filtros calculados, você pode selecionar um evento personalizado, um evento de compra, um evento de eCommerce ou uma interação de canal. No entanto, você pode combinar vários filtros calculados com AND ou OR ao criar o Segment.
Você pode adicionar vários eventos ou referenciar várias tabelas do Snowflake ao usar extensões de segmento SQL.
Posso usar arrays em filtros calculados?
Sim. Para usar arrays, adicione colchetes ([]) ao nome da sua propriedade. Se a sua propriedade for location_code, você digitaria location_code[].
A Braze usa [] para percorrer arrays e verificar se algum item no array percorrido corresponde à propriedade do evento. Por exemplo, você poderia criar um filtro calculado de usuários que correspondem a pelo menos um valor de uma propriedade de array.
Como a Braze calcula o período de tempo para um período relativo de “últimos X dias”?
Quando os filtros calculados calculam o período relativo (“últimos X dias”), o horário de início é definido como meia-noite UTC. Por exemplo, para um filtro calculado que atualiza em 2024-09-16 21:00 UTC e especifica 10 dias, o horário de início é definido como 2024-09-06 00:00 UTC, não 2024-09-06 21:00 UTC. Os filtros calculados sempre usam UTC para janelas de tempo; o fuso horário do seu espaço de trabalho não se aplica.
No entanto, você pode especificar fusos horários usando extensões de segmento SQL para identificar usuários que realizaram um evento há 10 dias com base na meia-noite no horário da empresa, ou usuários que realizaram o evento há 10 dias com base no horário atual.