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 nos últimos 16 meses ou que gastaram um determinado valor com o seu serviço. 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 são 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. Você pode usar dados do seu próprio data warehouse para refinar ainda mais seu público.
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 específico 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 em comportamento de compra e eventos personalizados, mas usam ferramentas e fontes de dados diferentes. As extensões de segmento SQL usam SQL que você escreve a partir dos dados do Snowflake conectado.
| Comportamento | Filtros calculados | Extensões de segmento SQL |
|---|---|---|
| Como você define o público | Escolha compras, eventos recomendados de eCommerce, interação com mensagens ou eventos personalizados, além de contagens, janelas de tempo e filtros opcionais de propriedades | Escreva SQL na sua conexã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 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 conforme o tipo de extensão |
| Casos de uso típicos | Frequência de compra, gasto total, contagens de eventos personalizados e regras baseadas em propriedades dentro da janela selecionada | Lógica apoiada no data warehouse, junções entre tabelas e janelas históricas ou agregações além do formulário de filtro calculado |
Quando usar filtros calculados
Use filtros calculados quando as regras de atividade do usuário ou de objetos de dados guiadas pelo dashboard 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 consulta diretamente seu data warehouse usando dados de conexões de ingestão de dados na nuvem.
Use 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 ou eventos personalizados 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, depois salve e ative o filtro antes de usá-lo em um Segment.
Etapa 1: Configurar detalhes
- Acesse Audience > Calculated Filters.
- Selecione Create filter.
- Se o seu espaço de trabalho tiver Accounts ativado, selecione um tipo de filtro:
- User activity filters: ações e comportamentos de usuários.
- Data Object filters: 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 quando você adicioná-lo a um Segment.
- (Opcional) Adicione tags para organizar filtros calculados no seu espaço de trabalho.
Para User activity filters, selecione Enable recurring audience update 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 manualmente ou selecione Update audience. Os Data Object filters são atualizados a cada hora.
Etapa 2: Escolher seus critérios
Se você selecionou Data Object filters, 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 Create filter abrir diretamente o construtor de atividade do usuário, ou se você selecionar User activity filters, escolha uma das seguintes opções de Criterion para direcionamento:
- Made a Purchase
- Performed an eCommerce event
- Performed a Custom Event
- Interacted with Message Channel
As opções de Criterion disponíveis variam conforme os recursos ativados no seu espaço de trabalho. Performed an eCommerce event está sempre disponível. Se você não encontrar outra opção de que precisa, entre em contato com o gerente de conta da Braze.
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 que você especificar. Por exemplo, um filtro para mais que 4 vezes e menos que 16 vezes inclui usuários que realizaram a ação 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 fim ou um intervalo de datas exato.

Segmentação por propriedade de evento
Para aumentar a precisão do direcionamento, selecione Add Property Filters. Isso permite filtrar por propriedades de compra, evento de eCommerce ou evento personalizado. 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 Save as draft para salvar um novo filtro calculado sem ativá-lo. Para um filtro ativado, selecione Save changes para salvar suas atualizações. Você deve selecionar Activate filter antes que um rascunho apareça como opção ao construir um Segment.
Depois que você ativar um filtro calculado, a Braze começará a calcular seu público. Quando o processamento estiver 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 Other Filters, selecione Existing calculated filter.
- Selecione o filtro calculado para incluir 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 restringir 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 utilizam cada filtro calculado.
Rótulos de status
Cada filtro calculado exibe um dos seguintes status. 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. |
| 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 da linha de um filtro calculado para executar uma ação. As ações exibidas dependem do status do filtro.
Para filtros que não estão arquivados, o menu da 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.

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 da linha do filtro.
- Selecione um ou mais filtros arquivados e, em seguida, selecione Unarchive.
- Abra um filtro calculado arquivado e selecione Unarchive na página dele.
Ao desarquivar um filtro, o status dele retorna ao que era antes de você arquivá-lo:
- 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 seja concluído antes de desarquivar um filtro que exibe 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.
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, é possível 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 arquivar um filtro calculado se ele estiver em uso?
Não. Antes de arquivar um filtro calculado, remova-o de todas as Campaigns, Canvas e Segments que o utilizam.
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ê pode criar um filtro calculado de usuários que correspondam 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 é atualizado 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, e não 2024-09-06 21:00 UTC.
No entanto, você pode especificar os fusos horários usando segmentos SQL para identificar usuários que realizaram o evento personalizado 10 dias atrás com base na meia-noite no horário da empresa, ou usuários que realizaram o evento 10 dias atrás com base no horário atual.