Solução de problemas de Segments

Esta página aborda problemas comuns e perguntas que podem surgir ao criar e gerenciar Segments na Braze.

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 de 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.

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.

Informações são 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.

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 na Análise de dados 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 na Análise de dados 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 com alguém 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}"}
      ]
  }
]
}