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.
Bloqueio de dados personalizados
Ocasionalmente, você pode identificar atributos personalizados, eventos personalizados ou eventos de compra que registram pontos de dados em excesso, 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 personalizado enquanto sua equipe de engenharia trabalha para removê-lo do backend do seu app ou website. O bloqueio impede que um determinado objeto de dados personalizado seja registrado pela Braze daquele momento em diante, o que significa que ele não aparece ao buscar um usuário específico.
Escolhendo entre bloqueio e exclusão
- O bloqueio mantém os atributos personalizados, eventos ou compras existentes nos perfis de usuário, mas a Braze deixa de processar novos dados para esses objetos.
- A exclusão remove esses dados dos perfis de usuário. Atributos personalizados e eventos excluídos são movidos para a Lixeira por sete dias, durante os quais você pode recuperá-los. Após sete dias, a Braze os exclui permanentemente. A exclusão não impede a chegada de novos dados, então confirme se o SDK, a API ou as importações de CSV já não enviam mais esses dados antes de excluir.
O bloqueio envia as informações de bloqueio para o dispositivo de cada usuário, o que pode ser intensivo em dados. Bloquear um número muito grande de atributos, eventos ou compras (por exemplo, mais de 100) pode afetar a performance do app. Se você não planeja mais enviar esses dados à Braze, a exclusão geralmente é a melhor abordagem após interromper o envio pela integração.
Independentemente de você optar pelo bloqueio ou pela exclusão, os atributos personalizados, eventos e compras em questão deixam de aparecer na página Gerenciar espaço de trabalho e são removidos como filtros de Segment. Se você excluir dados personalizados, a Braze remove esses dados de nível de usuário dos perfis de acordo com Como a exclusão funciona.
Para bloquear dados personalizados, você precisa das permissões de usuário listadas no menu suspenso a seguir para seu espaço de trabalho.
Permissões de usuário para bloqueio de dados personalizados
- Visualizar Campaigns
- Editar Campaigns
- Arquivar Campaigns
- Visualizar Canvas
- Editar Canvas
- Arquivar Canvas
- Visualizar regras de limite de frequência
- Editar regras de limite de frequência
- Visualizar priorização de mensagens
- Editar priorização de mensagens
- Visualizar Content Blocks
- Visualizar Feature Flags
- Editar Feature Flags
- Arquivar Feature Flags
- Visualizar Segments
- Editar Segments
- Visualizar modelos de mensagem no app
- Editar modelos de mensagem no app
- Arquivar modelos de mensagem no app
- Visualizar modelos de e-mail
- Editar modelos de e-mail
- Arquivar modelos de e-mail
- Visualizar modelos de webhook
- Editar modelos de webhook
- Visualizar modelos de link
- Editar modelos de link
- Visualizar ativos da biblioteca de mídia
- Editar ativos da biblioteca de mídia
- Excluir ativos da biblioteca de mídia
- Visualizar locais
- Editar locais
- Arquivar locais
- Visualizar códigos de promoção
- Editar códigos de promoção
- Exportar códigos de promoção
- Visualizar centrais de preferências
- Editar centrais de preferências
- Visualizar relatórios
- Editar relatórios
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 incorridos por esse objeto de dados personalizado. Os dados bloqueados ficam ocultos, mas ainda podem ser usados em templates Liquid.
Bloqueio de atributos personalizados, eventos personalizados e produtos

Quando um evento ou atributo é bloqueado, qualquer Segment, Campaign ou Canvas que utilize esse evento ou atributo é arquivado.
Para parar de rastrear um atributo personalizado, evento ou produto específico, siga estas etapas:
- Busque-o nas páginas Custom Attributes, Custom Events ou Products.
- Selecione o atributo personalizado, evento ou produto. Para atributos e eventos personalizados, é possível selecionar até 100 para bloquear de uma vez.
- Selecione Blocklist.

Você pode bloquear até 300 atributos personalizados e 300 eventos personalizados. Para evitar a coleta de determinados atributos de dispositivo, consulte nosso guia do SDK.

Atributos personalizados ou eventos personalizados com status de Lixeira contam para o limite de bloqueio até que sejam excluídos.
Quando um evento ou atributo personalizado é 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
- Tudo que utiliza o evento ou atributo bloqueado é arquivado
Para isso, a Braze envia as informações de bloqueio para cada dispositivo. Esse é um ponto importante ao considerar o bloqueio de um número muito grande de eventos e atributos (centenas de milhares ou milhões), pois é uma operação intensiva em dados.
Considerações sobre o bloqueio
Bloquear um número alto de eventos e atributos é possível, mas não recomendável. Isso ocorre porque, cada vez que um evento é executado 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 a partir do 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. As 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 adicioná-los à lista de bloqueio e remover suas referências do seu app. Você pode excluir qualquer tipo de dado (como strings, números e atributos personalizados aninhados).

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 você deseja excluir.
- Acesse o dado personalizado e selecione Ações > Adicionar à lista de bloqueio.
- Após o dado personalizado ter permanecido na lista de bloqueio 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 Lixeira. Nos próximos sete dias, é possível recuperar o atributo ou evento. Se você não recuperá-lo após sete dias, os dados são excluídos permanentemente. Se você recuperar o atributo ou evento, ele voltará ao estado de lista de bloqueio.
A exclusão não impede o registro adicional dos objetos de dados personalizados nos perfis de usuário, então certifique-se de que o dado personalizado não está mais sendo registrado 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 da 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 adicionar um item à lista de bloqueio novamente se a exclusão resultar no reaparecimento de dados personalizados. O status de lista de bloqueio não é preservado porque o dado personalizado é excluído.
- 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.