Solução de problemas de Segments

Encontre seu sintoma na lista abaixo para ir à seção correta. Esta página aborda erros de lançamento, elegibilidade de usuários, problemas com filtros e divergências na análise de dados. Para definições de filtros, consulte Filtros de segmentação. Para estimativas de tamanho de Segments, contagens exatas e gráficos de histórico de membros, consulte Medir o tamanho do Segment.

Comece aqui: identifique seu sintoma

Caminho de investigação padrão

Use este fluxo de trabalho quando um usuário deveria estar em um Segment mas não está, ou quando a contagem de um Segment parece incorreta.

1. Envio bloqueado: Se você vir um erro de complexidade de público ou de filtro de 10.000 bytes em uma Campaign ou Canvas, comece por Erros (solução alternativa com CSV, simplificação de filtros).
2. Prévia do usuário ou busca de usuário: Teste um usuário específico em relação aos filtros do seu Segment. Quando um usuário não corresponde a parte ou a todos os critérios, os critérios ausentes são listados para solução de problemas. Para ver as etapas, consulte Testando Segments em Criar um Segment.
3. Calcular estatísticas exatas: Se a estimativa do Segment mostrar 0 usuários ou parecer incorreta, selecione Calcular estatísticas exatas no painel Usuários contatáveis. Salve seu Segment antes de calcular. Se um cálculo já estiver em andamento, aguarde sua conclusão; números desatualizados podem ser exibidos até que o novo cálculo termine. Para saber mais, consulte Calculando estatísticas exatas.
4. Verifique os valores dos filtros: Procure erros de digitação, incompatibilidades de tipo de dados, referências desatualizadas de etapas do Canvas e filtro negativo + lógica OR.
5. Verifique a complexidade: Se o envio estiver bloqueado, consulte Público-alvo complexo demais para envio.
6. Entre em contato com o suporte: Se ainda estiver com problemas, entre em contato com o suporte da Braze.

Segment mostra zero usuários

O tamanho do Segment no dashboard é frequentemente uma estimativa baseada em uma amostra de usuários. Segments muito pequenos podem mostrar uma faixa estimada que inclui 0, mesmo quando há usuários que correspondem aos seus filtros.

• Selecione Calculate exact stats no painel Usuários contatáveis para obter uma contagem precisa. Salve o Segment primeiro. Para saber mais, consulte Considerações sobre contagens estimadas.
• Se a Prévia do usuário retornar zero usuários para um Segment pequeno, isso não significa necessariamente que o Segment está vazio. Execute Calculate exact stats para confirmar. Para saber mais, consulte Prévia do usuário.

Associação retroativa a Segments

A Braze não armazena o histórico de associação a Segments por usuário. Não é possível consultar se um usuário específico estava em um Segment em um momento passado de envio.

Para capturar a associação em um ponto no tempo, exporte os usuários do Segment no dashboard ou chame o endpoint /users/export/segment antes de enviar uma Campaign ou Canvas. Para saber mais, consulte Filtros de segmentação (filtro de associação a Segment) e Exportar dados de Segment para CSV.

Erros

O público-alvo é complexo demais para ser lançado

Esse erro raro ocorre quando o público-alvo contém muitos valores de regex, valores de regex excessivamente longos, filtros muito detalhados (como “é qualquer um de 30.000 CEPs”) ou filtros demais. Isso inclui todos os filtros no público de uma Campaign ou Canvas, sejam eles localizados nos Segments referenciados ou adicionados como filtros na etapa Target Audience.

Quando você adiciona filtros de Segment a uma Campaign ou Canvas, esses filtros são traduzidos em consultas na Braze (a contagem de caracteres dessas consultas não é proporcional à quantidade de caracteres que o usuário do dashboard visualiza). Quando a Braze envia uma Campaign ou Canvas, ela executa uma consulta que combina todos os filtros do público-alvo. Aplicamos um limite na quantidade de caracteres da consulta resultante para o público-alvo. Para uma determinada Campaign ou Canvas, somamos a contagem de caracteres de todos os Segments referenciados, incluindo todos os filtros adicionais. Para um determinado Segment, somamos a contagem de caracteres de todos os filtros e seus valores.

O dashboard exibirá um erro quando uma Campaign, Canvas ou Segment ultrapassar o limite e não puder ser lançado. Se você receber esse erro, simplifique o público-alvo antes de lançar novamente, considerando:

• Se o público referencia múltiplos Segments, verifique se não há redundâncias, como os mesmos filtros aparecendo em vários Segments.
• Certifique-se de que não está referenciando dados desatualizados nos filtros de Segment. Por exemplo, um filtro desatualizado pode procurar usuários que não receberam uma determinada etapa do Canvas na última semana, mesmo que o Canvas esteja parado há meses.
• Segments que são apenas listas de IDs de usuário ou e-mails (que geralmente usam um filtro de regex) podem ser convertidos em uma importação de CSV e simplificados em um único filtro baseado em CSV.
• Se você usa CDI, pode ser possível criar um Segment de CDI que extrai o grupo diretamente do seu data warehouse.

Você também pode entrar em contato com o suporte para obter assistência adicional com a otimização de filtros.

Nota

Começamos a limitar a contagem de caracteres em abril de 2025. Campaigns e Canvas lançados antes de abril de 2025 foram isentos, o que significa que podem continuar excedendo o limite, enquanto Campaigns e Canvas criados recentemente não podem excedê-lo. Se você editar ou clonar uma Campaign ou Canvas isento, não será possível lançá-lo até que o público seja atualizado para ficar abaixo do limite.

X Campaigns ou Canvas ativos ou parados excedem o limite de complexidade do público

Esse banner é exibido no topo de uma lista de Campaigns ou Canvas sempre que Campaigns ou Canvas ativos ou parados possuem públicos que excedem o limite de complexidade do público. Selecione o banner para filtrar a lista apenas para as Campaigns ou Canvas que excedem o limite e, em seguida, siga as etapas de solução de problemas em O público-alvo é complexo demais para ser lançado.

Filtro excede 10.000 bytes ou é longo demais para salvar

A Braze limita filtros individuais de Segment a no máximo 10.000 bytes, o que equivale a 10.000 caracteres em inglês ou 3.333 caracteres em japonês. Um aviso aparece sempre que um filtro individual excede 10.000 bytes, seja ele dentro de um Segment ou adicionado diretamente a uma Campaign ou Canvas.

Esse erro ocorre muito raramente, mas quando acontece, geralmente envolve filtros de regex que segmentam uma lista de IDs de usuário ou endereços de e-mail. Nesse caso, você pode seguir estas etapas para converter os filtros em um CSV:

1. Exporte os usuários do Segment afetado ou do filtro de regex específico.
2. Limpe o CSV conforme necessário. Você precisa do Braze ID ou do Appboy ID, mas pode remover todas as outras colunas se não forem necessárias. Também recomendamos revisar seus dados para confirmar que estão atualizados (por exemplo, remova usuários que você não está mais tentando segmentar).
3. Importe o arquivo CSV novamente, o que agrupa automaticamente os usuários em um único filtro baseado em CSV altamente eficiente.

Comportamento do usuário

O usuário não está mais em um Segment

Se um usuário não estiver disponível ao criar um Segment, os dados do usuário que determinam sua elegibilidade para o Segment podem ter sido alterados como resultado de sua própria atividade ou de outras Campaigns e Canvas com os quais ele interagiu anteriormente. Se a reelegibilidade estiver ativada, o perfil de usuário mostra os dados mais recentes da Campaign recebida.

Para testar se um usuário específico corresponde ao seu Segment hoje, use a prévia de usuário ou busca de usuários.

Informações de usuários de outros apps aparecem quando filtro por um app específico

Os usuários podem ter vários apps, então selecionar um app específico na seção Apps usados da página de segmentação retornará resultados de usuários que possuem pelo menos esse app. O filtro não retorna resultados apenas para os usuários que possuem exclusivamente esse app.

Filtragem

As opções de filtro mudaram

Suas opções de filtro estão relacionadas ao formato (tipo de dados) que você está enviando à Braze para seu atributo personalizado. Para revisar o tipo de dados que a Braze está reconhecendo para seus atributos personalizados, acesse Data Settings > Custom Attributes.

Se suas opções de filtro mudaram, isso indica que seus dados estão sendo enviados à Braze em um formato (tipo de dados) diferente do anterior. Para descrições detalhadas dos diferentes tipos de dados e suas opções de filtragem, consulte tipos de dados de atributos personalizados.

Lembre-se de que alterar o tipo de dados de um atributo personalizado no dashboard rejeita dados enviados à Braze em um formato diferente. Não é possível alterar o tipo de dados de um atributo personalizado enquanto esse atributo estiver referenciado em Campaigns, Canvas ou Segments ativos; o dashboard exibe um erro e bloqueia a alteração.

A guia Values em um atributo personalizado mostra resultados de uma amostra de aproximadamente 250.000 usuários. Não use a guia Values para confirmar se um valor de atributo específico existe para fins de solução de problemas. Para saber mais, consulte Guia Values.

Atributo personalizado aninhado não disponível como opção de filtro

Se seu atributo personalizado aninhado não está aparecendo como opção de filtro ao criar um Segment, gere o esquema primeiro. Acesse Data Settings > Custom Attributes, encontre o atributo e selecione Generate Schema. Depois de gerado, o atributo ficará disponível no menu suspenso de filtros do Segment. Para saber mais, consulte Gerar um esquema usando o explorador de objetos aninhados.

O Segment é muito maior do que o esperado

Se seu Segment parece muito maior do que você espera, apesar de filtros aparentemente restritivos, verifique se você está usando filtros negativos (is not, does not equal, does not match regex ou not included) com o operador OR no mesmo atributo mais de uma vez. Essa combinação pode segmentar usuários com todos os valores desse atributo.

Para orientações sobre quando usar AND em vez de OR, consulte Quando evitar o operador OR em Criar um Segment.

Análise de dados e relatórios

Mensagens Enviadas ou Destinatários Únicos na análise de dados de Campaigns não corresponde à contagem do Segment

Se a contagem de Mensagens Enviadas ou Destinatários Únicos na análise de dados da sua Campaign não corresponde ao número de usuários no filtro de Segment Has received message from campaign X, pode haver três razões possíveis.

1. Usuários podem ter sido arquivados, ficado órfãos ou sido excluídos desde o lançamento da Campaign
   
   Por exemplo, digamos que 1.000 usuários recebam uma Campaign e você faça uma exportação CSV no mesmo dia. Você verá 1.000 usuários reportados. Ao longo do mês seguinte, 50 desses 1.000 usuários são excluídos (por exemplo, pelo endpoint users/delete). Quando você fizer outra exportação CSV, verá 950 usuários reportados, enquanto a contagem de Destinatários Únicos em Campaign Analytics ainda será 1.000.
   
   Em outras palavras, a métrica Destinatários Únicos é uma contagem incremental, enquanto o segmentador e a exportação CSV fornecem uma contagem de usuários atualmente existentes.
   
   

2. A Campaign tem reelegibilidade configurada, permitindo que os usuários reentrem na Campaign várias vezes
   
   Por exemplo, digamos que uma Campaign de e-mail tem reelegibilidade configurada para zero minutos (os usuários podem reentrar na Campaign desde que atendam aos requisitos do Segment do público), e a Campaign está em execução há mais de um mês. O número de Mensagens Enviadas em Campaign Analytics não corresponderia ao número no Segment porque esse campo incluiria mensagens enviadas a usuários duplicados.
   
   Isso acontece porque a Braze conta usuários únicos como Destinatários Diários Únicos, ou o número de usuários que receberam uma mensagem específica em um dia. Isso significa que usuários reelegíveis são contados mais de uma vez como destinatário único, porque a janela de “unicidade” dura apenas um dia. Isso pode resultar em um número de Destinatários Diários Únicos maior do que o número de perfis de usuário na exportação CSV. Os perfis de usuário no arquivo CSV são verdadeiramente únicos.
   
   

3. Usuários que compartilham um identificador de canal corresponderam ao filtro
   
   O filtro Has received message from campaign X (e outros filtros de “recebimento”) pode corresponder a usuários que compartilham um identificador de canal, como o mesmo token por push ou endereço de e-mail, com outro perfil de usuário que recebeu, abriu ou clicou na mensagem.

Usuário é atribuído a dois apps apesar de ter registrado uma sessão em apenas um app

Ao criar um Segment, você pode direcionar usuários que usaram apps específicos. Um usuário precisa ter tido uma sessão em um app específico para ser atribuído a esse app; no entanto, existem dois cenários em que um usuário ainda pode ser atribuído a um app específico sem ter registrado sessões nele.

O primeiro cenário é quando o campo app_id é preenchido ao usar o endpoint /users/track — especificamente ao usar um objeto de evento ou objeto de compra, como neste exemplo:

1
2
3
4
5
6
7
8
9
10

{
    "events": [
    {
      "external_id": "john_doe123",
      "app_id": "my_web_app_id",
      "name": "Custom Event",
      "time": "2025-08-17T19:20:30+1:00"
    }
  ]
}

O segundo cenário é quando o campo app_id é preenchido ao usar o endpoint /users/track para migrar tokens por push, como neste exemplo:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
"app_group_id": "{YOUR_APP_GROUP_ID}",
"attributes": [
{
      "push_token_import": false,
      "external_id": "external_id1",
      "country": "US",
      "language": "en",
      "{YOUR_CUSTOM_ATTRIBUTE}": "{YOUR_VALUE}",
      "push_tokens": [
        {"app_id": "{APP_ID_OF_OS}", "token": "{PUSH_TOKEN_STRING}"}
      ]
  }
]
}