Gerenciar dados personalizados
Esta página aborda como preencher previamente dados personalizados em suas campanhas e segmentos, gerenciar eventos e atributos personalizados e suas propriedades, e configurar tipos de dados. Para colocar dados personalizados na lista de bloqueio e excluí-los, consulte Lista de bloqueio de dados personalizados.
Para saber como gerenciar atributos personalizados em particular (incluindo adicionar descrições, adicionar tags e marcar atributos como IPI), consulte Gerenciar atributos personalizados.
Pré-preencher dados personalizados
Às vezes, você pode querer configurar Campaigns e Segments usando dados personalizados antes que sua equipe de desenvolvimento tenha integrado esses dados. A Braze permite pré-preencher eventos e atributos personalizados no dashboard antes que esses dados comecem a ser rastreados. Assim, esses eventos e atributos ficam disponíveis nos menus suspensos e no processo de criação de campanhas.
Para pré-preencher eventos e atributos personalizados, faça o seguinte:
- Acesse Configurações de dados > Eventos personalizados, Atributos personalizados ou Produtos. Para ver um passo a passo específico da página Produtos, consulte Produtos.
- Para adicionar um atributo personalizado, evento ou produto, acesse a página correspondente e selecione Adicionar atributos personalizados, Adicionar eventos personalizados ou Adicionar produtos.
Para atributos personalizados, selecione um tipo de dados para esse atributo (por exemplo, booleano ou string). O tipo de dados de um atributo determina os filtros de segmentação disponíveis para ele.
- Selecione Salvar.
Nomeação de eventos e atributos personalizados
Eventos e atributos personalizados diferenciam maiúsculas de minúsculas. Lembre-se disso quando sua equipe de desenvolvimento integrar esses eventos ou atributos personalizados mais tarde. Ela precisa nomeá-los exatamente como você os nomeou aqui. Caso contrário, a Braze vai gerar um evento ou atributo personalizado diferente.
Gerenciamento de propriedades
Depois de criar um evento personalizado ou produto, selecione Gerenciar propriedades para esse evento ou produto. Nessa tela, você pode adicionar novas propriedades, colocar propriedades existentes na lista de bloqueio e ver quais Campaigns ou Canvas usam essa propriedade em um evento-gatilho.
Para colocar propriedades de eventos ou produtos na lista de bloqueio, use o menu de ações na página de propriedades. Para bloquear completamente atributos personalizados, eventos ou produtos, consulte Lista de bloqueio de dados personalizados.
Para tornar rastreáveis esses atributos personalizados, eventos, produtos ou propriedades de eventos adicionados, peça à sua equipe de desenvolvimento para criá-los no SDK usando exatamente o mesmo nome que você usou ao adicioná-los. Você também pode usar a API da Braze para importar dados desse atributo. Depois disso, o atributo personalizado, evento ou outro item passa a ser acionável e é aplicado aos seus usuários.
Note:
All user profile data (custom events, custom attributes, custom data) is stored as long as those profiles are active.
Detecção do tipo de dado entre ambientes
A Braze detecta automaticamente o tipo de dado de um atributo personalizado com base no primeiro valor recebido. Se o seu ambiente de desenvolvimento enviar primeiro um valor numérico, como 100, o atributo será armazenado como número. Se o primeiro valor do seu ambiente de produção chegar como string (por exemplo, "100" entre aspas), o atributo será armazenado como string.
Para evitar isso, garanta que sua integração envie tipos de dados consistentes em todos os ambientes. Se o tipo errado já estiver definido, você pode forçar o tipo de dado correto em Configurações de dados > Atributos personalizados usando o menu suspenso de tipo de dado.
Forçar comparações de tipos de dados
A Braze reconhece automaticamente os tipos de dados para os dados de atributos enviados a ela. No entanto, caso vários tipos de dados sejam aplicados a um único atributo, é possível forçar o tipo de dados de qualquer atributo para que a Braze saiba o que ele é. Selecione na lista suspensa da coluna Data Type.
A partir de 30 de março de 2026, a detecção automática só define um tipo de dados na ingestão inicial. Para alterar o tipo de dados após a ingestão inicial, atualize-o manualmente seguindo as etapas abaixo.
Forçar tipos de dados não se aplica a propriedades de eventos ou propriedades de compra.
Se você optar por forçar o tipo de dados de um atributo, todos os dados recebidos que não forem do tipo especificado serão convertidos para esse tipo. Se essa conversão for impossível (por exemplo, uma string contendo letras sendo convertida em um número), os dados serão ignorados. Todos os dados ingeridos antes da alteração do tipo continuarão armazenados como o tipo antigo (e, portanto, podem não ser Segmentáveis), e um aviso aparecerá ao lado do atributo nos perfis dos usuários afetados.
Dados existentes após uma alteração de tipo
Forçar uma alteração de tipo de dados afeta apenas os novos dados que chegam à Braze. Todos os dados ingeridos antes da alteração de tipo continuam armazenados como o tipo antigo e podem não ser Segmentáveis com os filtros do novo tipo. Um aviso aparece nos perfis dos usuários afetados. Para novos dados recebidos, se um valor não corresponder ao tipo forçado, a Braze pode convertê-lo para o tipo forçado (por exemplo, a string "100" para o número 100). Valores que não podem ser convertidos são ignorados e não atualizam o atributo.
Se você precisar que todos os dados de usuários existentes correspondam ao novo tipo, será necessário reenviar os valores do atributo para esses usuários por meio do SDK, da API ou de uma importação CSV. Não há conversão em massa automática para dados existentes.
Coerção de tipos de dados
| Tipo de dados forçado | Descrição |
|---|---|
| Booleano | As entradas 1, true, t (não diferenciam maiúsculas de minúsculas) são armazenadas como true |
| Booleano | As entradas 0, false, f (não diferenciam maiúsculas de minúsculas) são armazenadas como false |
| Número | Números inteiros ou de ponto flutuante (como 1, 1.5) são armazenados como números |
| Número | Strings numéricas (como "100" ou "3.14") podem ser convertidas em números quando o atributo é forçado para Número |
| String | Valores numéricos podem ser convertidos para sua forma de string quando o atributo é forçado para String |
Para saber mais sobre opções de filtro específicas expostas por diferentes comparações de tipos de dados, confira Configurando relatórios. Para saber mais sobre os diferentes tipos de dados disponíveis, consulte Tipos de dados.
Os dados enviados à Braze são imutáveis e não podem ser excluídos ou modificados depois que a Braze os recebe. No entanto, é possível usar qualquer uma das etapas listadas nas seções anteriores para exercer controle sobre o que está sendo rastreado no dashboard. Para colocar na lista de bloqueio ou excluir dados personalizados, consulte Lista de bloqueio de dados personalizados.