Bloquear dados personalizados
Use o bloqueio para parar de rastrear dados personalizados que não são mais úteis. Use a exclusão para remover permanentemente eventos personalizados e atributos personalizados dos perfis de usuário após o bloqueio. Para pré-preenchimento, gerenciamento de propriedades e configuração de tipos de dados, consulte Gerenciar dados personalizados.
Bloqueando dados personalizados
Ocasionalmente, você pode identificar atributos personalizados, eventos personalizados ou eventos de compra que registram muitos pontos de dados, não são mais úteis para sua estratégia de marketing ou foram registrados por engano.
Para impedir que esses dados sejam enviados à Braze, você pode bloquear um objeto de dados personalizados enquanto sua equipe de engenharia trabalha para removê-lo do backend do seu app ou site. O bloqueio impede que um determinado objeto de dados personalizados seja registrado pela Braze dali em diante, o que significa que ele não aparecerá ao pesquisar um usuário específico.
Para bloquear dados personalizados, você precisa das permissões de usuário listadas no menu suspenso a seguir para o seu espaço de trabalho.
Permissões de usuário para bloqueio de dados personalizados
A soldagem está passando para permissões de usuário granulares. Se você estiver usando as permissões legadas, consulte as definições na Lista de permissões. O acesso antecipado às permissões granulares está disponível para clientes selecionados. Todos os clientes serão migrados para as novas permissões em março de 2026.
- View Campaigns
- Edit Campaigns
- Archive Campaigns
- View Canvases
- Edit Canvases
- Archive Canvases
- View Frequency Capping Rules
- Edit Frequency Capping Rules
- View Message Prioritization
- Edit Message Prioritization
- View Content Blocks
- View Feature Flags
- Edit Feature Flags
- Archive Feature Flags
- View Segments
- Edit Segments
- View IAM Templates
- Edit IAM Templates
- Archive IAM Templates
- View Email Templates
- Edit Email Templates
- Archive Email Templates
- View Webhook Templates
- Edit Webhook Templates
- View Link Templates
- Edit Link Templates
- View Media Library Assets
- Edit Media Library Assets
- Delete Media Library Assets
- View Locations
- Edit Locations
- Archive Locations
- View Promotion Codes
- Edit Promotion Codes
- Export Promotion Codes
- View Preference Centers
- Edit Preference Centers
- View Reports
- Edit Reports
Os dados bloqueados não são enviados pelo SDK, e o dashboard da Braze não processa dados bloqueados de outras fontes (por exemplo, a API). No entanto, o bloqueio não remove dados dos perfis de usuário nem diminui retroativamente a quantidade de pontos de dados gerados por esse objeto de dados personalizados. Os dados bloqueados ficam ocultos, mas ainda podem ser usados para templates em Liquid.
Bloqueando atributos personalizados, eventos personalizados e produtos
Quando um evento ou atributo é bloqueado, qualquer segmento, campanha ou Canvas que use esse evento ou atributo é arquivado.
Para parar de rastrear um atributo personalizado, evento ou produto específico, siga estas etapas:
- Pesquise na página Atributos personalizados, Eventos personalizados ou Produtos.
- Selecione o atributo personalizado, evento ou produto. Para atributos personalizados e eventos, você pode selecionar até 100 para bloquear de uma vez.
- Selecione Blocklist.

Você pode bloquear até 300 atributos personalizados e 300 eventos personalizados. Para impedir a coleta de determinados atributos de dispositivo, consulte nosso guia do SDK.
Atributos personalizados ou eventos personalizados com status Trashed contam para o limite de bloqueio até serem excluídos.
Quando um evento personalizado ou atributo é bloqueado, o seguinte se aplica:
- Nenhum dado enviado à Braze é processado, e eventos e atributos bloqueados não contam mais como pontos de dados
- Os dados existentes ficam indisponíveis, a menos que sejam reativados
- Eventos e atributos bloqueados não aparecem em filtros ou gráficos
- Referências a dados bloqueados em rascunhos de Canvas ativos são carregadas como valores inválidos, o que pode causar erros
- Qualquer coisa que use o evento ou atributo bloqueado é arquivada
Para isso, a Braze envia as informações de bloqueio para cada dispositivo. Isso é importante ao considerar o bloqueio de um grande número de eventos e atributos (centenas de milhares ou milhões), pois seria uma operação intensiva em dados.
Considerações sobre o bloqueio
Bloquear um grande número de eventos e atributos é possível, mas não recomendável. Isso porque, cada vez que um evento é realizado ou um atributo é (potencialmente) enviado à Braze, esse evento ou atributo precisa ser verificado em toda a lista de bloqueio.
Até 300 itens são enviados ao SDK para bloqueio. Se você bloquear mais de 300 itens, esses dados são enviados pelo SDK. Se você não precisar usar o evento ou atributo no futuro, considere removê-lo do código do seu app na próxima versão. Alterações na lista de bloqueio podem levar alguns minutos para se propagar. Você pode reativar qualquer evento ou atributo bloqueado a qualquer momento.
Excluindo dados personalizados
Ao criar campanhas e segmentos direcionados, você pode descobrir que não precisa mais de um evento personalizado ou atributo personalizado. Por exemplo, se você usou um atributo personalizado específico como parte de uma campanha única, pode excluir esses dados após bloqueá-los e remover suas referências do seu app. Você pode excluir qualquer tipo de dado (como strings, números e atributos personalizados aninhados).
Você precisa ser administrador da Braze para excluir dados personalizados.
Para excluir um evento personalizado ou atributo personalizado, faça o seguinte:
- Acesse Configurações de dados > Atributos personalizados ou Eventos personalizados, dependendo do tipo de dado que deseja excluir.
- Vá até o dado personalizado e selecione Ações > Blocklist.
- Após o dado personalizado ter sido bloqueado por 7 dias, selecione Ações > Excluir.
Como a exclusão funciona
Quando você exclui dados personalizados, o seguinte ocorre:
- Para atributos personalizados: Remove permanentemente os dados do atributo do perfil de cada usuário.
- Para eventos personalizados: Remove permanentemente os metadados do evento do perfil de cada usuário.
Quando um atributo ou evento é selecionado para exclusão, seu status é alterado para Trashed. Nos próximos sete dias, é possível restaurar o atributo ou evento. Se você não restaurá-lo após sete dias, os dados são excluídos permanentemente. Se você restaurar o atributo ou evento, ele volta ao estado de bloqueado.
A exclusão não impede o registro adicional dos objetos de dados personalizados nos perfis de usuário. Portanto, certifique-se de que os dados personalizados não estão mais sendo registrados antes de excluir o evento ou atributo.
Informações importantes
Ao excluir dados personalizados, tenha em mente os seguintes detalhes:
- A exclusão é permanente. Os dados não podem ser recuperados.
- Os dados são removidos da plataforma Braze e dos perfis de usuário.
- Você pode “reutilizar” o nome do atributo personalizado ou do evento personalizado após a exclusão. Isso significa que, se você notar que dados personalizados “reaparecem” na Braze após a exclusão, isso pode ser causado por uma integração que não foi interrompida e está enviando dados com o mesmo nome de dado personalizado.
- Pode ser necessário bloquear um item novamente se a exclusão resultar no reaparecimento de dados personalizados. O status de bloqueio não é preservado porque os dados personalizados foram excluídos.
- A exclusão de dados personalizados não registra nenhum ponto de dados e também não gera novos pontos de dados para uso.