Solucionar problemas de segmentos

Erros

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

Esse erro raro ocorre se o público-alvo contiver muitos valores de regex, valores de regex excessivamente longos, filtros excessivamente detalhados (como “é qualquer um dos 30.000 códigos postais”) ou muitos filtros. Isso inclui todos os filtros em uma campanha ou público do Canva, quer os filtros estejam localizados nos segmentos referenciados ou adicionados como filtros na etapa do público-alvo.

Quando você adiciona filtros de segmento a uma campanha ou Canva, esses filtros são traduzidos em consultas no Braze (a contagem de caracteres dessas consultas não é 1:1 para o número de caracteres que um usuário do dashboard vê). Quando a Braze envia uma campanha ou uma tela, executamos uma consulta que combina todos os filtros do público direcionado. Aplicamos um limiar que limita o número de caracteres na consulta resultante para um público-alvo. Para uma determinada campanha ou Canva, somamos a contagem de caracteres em todos os segmentos referenciados, incluindo todos os filtros adicionais. Para um determinado segmento, somamos a contagem de caracteres em todos os filtros e valores de filtro.

Seu painel exibirá um erro quando uma campanha, Canva ou segmento exceder o limite e não puder ser lançado. Se você receber esse erro, simplifique seu público-alvo antes de iniciar novamente, inclusive:

• Se o seu público fizer referência a vários segmentos, certifique-se de que os segmentos não tenham redundâncias, como o fato de os mesmos filtros aparecerem em vários segmentos.
• Certifique-se de que não esteja fazendo referência a dados desatualizados nos filtros de segmento. Por exemplo, um filtro desatualizado pode procurar usuários que não receberam uma determinada etapa do Canva na semana passada, mesmo que o Canva tenha sido interrompido há meses.
• Os segmentos que são apenas listas de IDs de usuários ou e-mails (que geralmente usam um filtro regex) podem ser convertidos em uma importação de CSV e simplificados em um único filtro CSV.
• Se você tiver CDI, poderá criar um segmento de CDI que extraia o grupo diretamente de seu data warehouse.

Você também pode entrar em contato com o Suporte para obter mais assistência com a otimização do filtro.

X campanhas ou telas ativas ou paradas excedem o limite de complexidade do público

Esse banner é exibido na parte superior de uma lista de campanhas ou telas sempre que campanhas ou telas ativas ou paradas têm públicos que excedem o limite de complexidade do público. Selecione o banner para filtrar a lista apenas para as campanhas ou Canvas que excedem o limite e, em seguida, siga as etapas de solução de problemas em O público-alvo é muito complexo para ser lançado.

O filtro excede 10.000 bytes ou é muito longo para ser salvo

O Braze limita os filtros de segmentos individuais a um máximo de 10.000 bytes, o que equivale a 10.000 caracteres ingleses ou 3.333 caracteres japoneses. Um aviso é exibido sempre que um filtro individual excede 10.000 bytes, quer o filtro esteja em um segmento ou seja adicionado diretamente à campanha ou ao Canva.

Esse erro ocorre muito raramente, mas, quando ocorre, é normalmente com filtros regex que direcionam 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 segmento afetado ou do filtro 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 elas não forem necessárias. Também recomendamos revisar seus dados para confirmar se são recentes (por exemplo, remover usuários que não estão mais tentando fazer o direcionamento).
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 segmento

Se um usuário não estiver disponível durante a criação de um segmento, os dados de usuários que determinam a elegibilidade do segmento poderão ter sido alterados como resultado de sua própria atividade ou de outras campanhas e Canvases com os quais ele interagiu anteriormente. Se a reelegibilidade estiver ativada, o perfil do usuário mostrará os dados mais recentes da campanha recebida.

As informações são exibidas para usuários de outros aplicativos quando eu filtro para um aplicativo específico

Os usuários podem ter vários aplicativos, portanto, a seleção de um aplicativo específico na seção Aplicativos usados da página de segmentação produzirá resultados para os usuários que têm pelo menos esse aplicativo. O filtro não produz resultados para os usuários que têm exclusivamente esse app.

Filtragem

Opções de filtro alteradas

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

Se as opções de filtro tiverem mudado, isso é uma indicação de que os dados estão sendo passados para o Braze em um formato (tipo de dados) diferente do anterior. Para obter descrições detalhadas de diferentes tipos de dados e suas opções de filtragem, consulte tipos de dados de atributos personalizados.

Lembre-se de que a alteração do tipo de dados de um atributo personalizado no dashboard rejeitará os dados que forem enviados ao Braze em um formato diferente.

Análise de dados e relatórios

A mensagem enviada ou os destinatários únicos na análise de dados da campanha não correspondem à contagem do segmento

Se a contagem da análise de dados da sua campanha de Mensagens enviadas ou Destinatários únicos não corresponder ao número de usuários no filtro de segmento Has received message from campaign X, pode haver dois motivos possíveis para isso:

1. Os usuários podem ter sido arquivados, tornados órfãos ou excluídos desde o lançamento da campanha
   
   Por exemplo, digamos que 1.000 usuários recebam uma campanha e você faça uma exportação CSV no mesmo dia. Você verá 1.000 usuários relatados. No mês seguinte, 50 desses 1.000 usuários são excluídos (por exemplo, pelo endpoint users/delete). Quando fizer outra exportação CSV, verá 950 usuários relatados, enquanto a contagem de Unique Recipient (destinatário único ) no Campaign Analytics ainda é de 1.000.
   
   Em outras palavras, a métrica Unique Recipients é uma contagem incrementada, enquanto o segmentador e a exportação CSV fornecem uma contagem de usuários existentes no momento.
   
   

2. A campanha tem a reelegibilidade definida, de modo que os usuários podem entrar novamente na campanha várias vezes
   
   Por exemplo, digamos que uma campanha de e-mail tenha a reelegibilidade definida como zero minutos (os usuários podem entrar novamente na campanha desde que atendam aos requisitos do segmento de público) e a campanha esteja em execução há mais de um mês. O número de mensagens enviadas no Campaign Analytics não corresponderia ao número no segmento porque esse campo incluiria mensagens enviadas a usuários duplicados.
   
   Isso ocorre porque o Braze conta os usuários únicos como Unique Daily Recipients, ou o número de usuários que receberam uma determinada mensagem em um dia. Isso significa que os usuários reelegíveis serão contados mais de uma vez como um destinatário único, porque a janela “única” dura apenas um dia. Isso pode fazer com que o número de destinatários diários exclusivos seja maior do que o número de perfis de usuário na exportação CSV. Os perfis de usuário no arquivo CSV serão realmente exclusivos.

O usuário é atribuído a dois aplicativos, apesar de registrar uma sessão em apenas um aplicativo

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

O primeiro cenário é se o campo app_id for preenchido ao usar o ponto de extremidade /users/track - especificamente ao usar um 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 for preenchido ao usar o ponto de extremidade /users/track para migrar a criação de tickets, como neste exemplo:

1
2
3
4
5
6
7
8
9
10
11
12
13
"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}"}
      ]
  }
]