Solução de problemas de Segments

Encontre seu sintoma 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. Lançamento bloqueado: Se você vir um erro de complexidade de público ou de filtro de 10.000 bytes em uma Campaign ou Canvas, comece com Erros (solução alternativa com CSV, simplificação de filtros).
2. Pré-visualização de 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 mostra 0 usuários ou parece 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 seja concluído. Para mais informações, consulte Calculando estatísticas exatas.
4. Verifique os valores dos filtros: Procure erros de digitação, incompatibilidades de tipo de dado, referências desatualizadas a etapas do Canvas e filtros negativos + lógica OR.
5. Verifique a complexidade: Se o lançamento estiver bloqueado, consulte O público-alvo é complexo demais para ser lançado.
6. Fale com o Suporte: Se ainda estiver bloqueado, entre em contato com o suporte da Braze.

O Segment mostra zero usuários

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

• Selecione Calcular estatísticas exatas no painel Usuários contatáveis para obter uma contagem precisa. Salve o Segment primeiro. Para mais informações, consulte Considerações sobre contagens estimadas.
• Se a Pré-visualização de usuário retornar zero usuários para um Segment pequeno, isso não significa necessariamente que o Segment está vazio. Execute Calcular estatísticas exatas para confirmar. Para mais informações, consulte Pré-visualização de usuário.

Associação retroativa ao Segment

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

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

Erros

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

Esse erro raro ocorre quando seu público-alvo contém muitos valores regex, valores regex excessivamente longos, filtros excessivamente 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 os filtros localizados dentro dos Segments referenciados ou adicionados como filtros na etapa Público-alvo.

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 é 1:1 em relação ao número de caracteres que um usuário do dashboard vê). Quando a Braze envia uma Campaign ou Canvas, executamos uma consulta que combina todos os filtros no público-alvo. Aplicamos um limite restringindo o número de caracteres na consulta resultante para um 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 valores de filtro.

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

• Se seu público referencia múltiplos Segments, certifique-se de que os Segments não tenham redundâncias, como os mesmos filtros aparecendo em múltiplos Segments.
• Certifique-se de que você 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 tenha sido interrompido há meses.
• Segments que são apenas listas de IDs de usuários ou e-mails (que frequentemente usam um filtro regex) podem ser convertidos em uma importação de CSV e simplificados em um único filtro baseado em CSV.
• Se você tem CDI, pode ser possível criar um Segment CDI que extrai o grupo diretamente do seu data warehouse.

Você também pode falar com o Suporte para obter assistência adicional com 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 recém-criados não podem exceder o limite. Se você editar ou clonar uma Campaign ou Canvas isento, não poderá 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 têm 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.

O filtro excede 10.000 bytes ou é longo demais para salvar

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

Esse erro ocorre muito raramente, mas quando ocorre, normalmente é com filtros regex que visam uma lista de IDs de usuários 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 regex específico.
2. Limpe o CSV conforme necessário. Você precisa do Braze ID ou 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 está disponível ao criar um Segment, os dados do usuário que determinam sua elegibilidade para o Segment podem ter mudado como resultado de sua própria atividade ou de outras Campaigns e Canvas com os quais interagiu anteriormente. Se a reelegibilidade estiver ativada, o perfil do usuário mostrará os dados mais recentes da Campaign recebida.

Para testar se um usuário específico corresponde ao seu Segment hoje, use a Pré-visualização de usuário ou busca de usuário.

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

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

Filtragem

As opções de filtro mudaram

Suas opções de filtro estão relacionadas ao formato (tipo de dado) que você está enviando para a Braze para seu atributo personalizado. Para revisar o tipo de dado que a Braze está reconhecendo para seus atributos personalizados, navegue até Configurações de dados > Atributos personalizados.

Se suas opções de filtro mudaram, isso é uma indicação de que seus dados estão sendo enviados para a Braze em um formato (tipo de dado) 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.

Tenha em mente que alterar o tipo de dado de um atributo personalizado no dashboard rejeitará dados que são enviados para a Braze em um formato diferente. Não é possível alterar o tipo de dado de um atributo personalizado enquanto esse atributo estiver referenciado em Campaigns, Canvas ou Segments ativos; o dashboard exibirá um erro e bloqueará a alteração.

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

O Segment é muito maior do que o esperado

Se o seu Segment parece muito maior do que o esperado apesar de filtros aparentemente restritivos, verifique se você está usando filtros negativos (não é, não é igual a, não corresponde ao regex ou não incluído) com o operador OR no mesmo atributo mais de uma vez. Essa combinação pode segmentar usuários com todos os valores para o 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 da Campaign não corresponde à contagem do Segment

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

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 recebem uma Campaign e você faz uma exportação CSV no mesmo dia. Você verá 1.000 usuários reportados. No 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 Analytics da Campaign 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 existentes atualmente.
   
   

2. A Campaign tem reelegibilidade configurada, então os usuários podem reentrar na Campaign múltiplas 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 de público), e a Campaign está rodando há mais de um mês. O número de Mensagens enviadas em Analytics da Campaign não corresponderia ao número no Segment porque esse campo incluiria mensagens enviadas a usuários duplicados.
   
   Isso ocorre 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 no número de Destinatários diários únicos sendo 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 Recebeu mensagem da campaign X (e outros filtros de “recebeu”) 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.

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

Ao criar um Segment, você pode segmentar 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 é se 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 é se o campo app_id é preenchido ao usar o endpoint /users/track para migrar tokens de 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}"}
      ]
  }
]
}