Bloquear dados personalizados
Use o bloqueio para parar de rastrear dados personalizados que não são mais úteis. Depois de bloquear, use a exclusão para remover permanentemente eventos personalizados e atributos personalizados dos perfis de usuário. Para saber sobre pré-preenchimento, gerenciamento de propriedades e configuração de tipos de dados, consulte Gerenciar dados personalizados.
Colocar dados personalizados na lista de bloqueio
Às vezes, você pode identificar atributos personalizados, eventos personalizados ou eventos de compra que registram pontos de dados demais, não são mais úteis para sua estratégia de marketing ou foram registrados por engano.
Para impedir que esses dados sejam enviados para a Braze, você pode colocar um objeto de dados personalizados na lista de bloqueio enquanto sua equipe de engenharia trabalha para removê-lo do backend do seu app ou website. A lista de bloqueio impede que a Braze registre um determinado objeto de dados personalizados daqui para frente. Ou seja, ele não aparece quando você pesquisa um usuário específico.
Escolher entre lista de bloqueio ou exclusão
- A lista de 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 e eventos personalizados excluídos vão para Na lixeira por sete dias, período em que você pode recuperá-los. Depois de sete dias, a Braze os exclui permanentemente. A exclusão não impede a chegada de novos dados, então confirme que suas importações via SDK, API ou CSV não enviam mais esses dados antes de excluir.
A lista de bloqueio envia as informações de bloqueio para o dispositivo de cada usuário e pode consumir muitos dados. Colocar um número muito grande de atributos, eventos ou compras na lista de bloqueio (por exemplo, mais de 100) pode afetar a performance do app. Se você não pretende mais enviar esses dados para a Braze, a exclusão costuma ser a melhor opção depois que a integração parar de enviá-los.
Independentemente de você usar a lista de bloqueio ou a exclusão, esses atributos personalizados, eventos e compras 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 no nível do usuário dos perfis conforme descrito em Como funciona a exclusão.
Os dados na lista de bloqueio não são enviados pelo SDK, e o dashboard da Braze não processa dados bloqueados vindos de outras fontes (por exemplo, a API). No entanto, a lista de bloqueio não remove dados dos perfis de usuário nem reduz retroativamente a quantidade de pontos de dados gerados por aquele objeto de dados personalizados. Os dados bloqueados ficam ocultos e ainda podem ser usados em modelos Liquid.
Pré-requisitos
Para colocar dados personalizados na lista de bloqueio ou excluí-los, você precisa destas permissões:
| Permissão | O que ela permite |
|---|---|
| “Colocar atributos personalizados na lista de bloqueio” ou “Editar atributos personalizados” | Colocar atributos personalizados na lista de bloqueio |
| “Colocar eventos personalizados na lista de bloqueio” ou “Editar eventos personalizados” | Colocar eventos personalizados na lista de bloqueio |
| “Colocar produtos na lista de bloqueio” ou “Editar produtos” | Colocar produtos na lista de bloqueio |
| “Adicionar/remover grupos de apps” | Excluir atributos personalizados ou eventos personalizados (permissão no nível da empresa; administradores da empresa têm esse acesso) |
Se os dados personalizados forem usados em Campaigns, Canvas ou Segments, você também precisa de permissão para editar ou arquivar esses objetos para que a Braze possa remover as referências durante o bloqueio:
Permissões de usuário para colocar dados personalizados na lista de bloqueio
- Ver Campaigns
- Editar Campaigns
- Arquivar Campaigns
- Ver Canvas
- Editar Canvas
- Arquivar Canvas
- Ver regras de limite de frequência
- Editar regras de limite de frequência
- Ver configurações de priorização de mensagens
- Editar configurações de priorização de mensagens
- Excluir configurações de priorização de mensagens
- Ver Content Blocks
- Ver Feature Flags
- Editar Feature Flags
- Arquivar Feature Flags
- Ver Segments
- Editar Segments
- Ver modelos de mensagem no app
- Editar modelos de mensagem no app
- Arquivar modelos de mensagem no app
- Ver modelos de e-mail
- Editar modelos de e-mail
- Arquivar modelos de e-mail
- Ver modelos de webhook
- Editar modelos de webhook
- Ver modelos de link
- Editar modelos de link
- Ver ativos da biblioteca de mídia
- Editar ativos da biblioteca de mídia
- Excluir ativos da biblioteca de mídia
- Ver locais
- Editar locais
- Arquivar locais
- Ver códigos de promoção
- Editar códigos de promoção
- Exportar códigos de promoção
- Ver centros de preferências
- Editar centros de preferências
- Ver relatórios
- Editar relatórios
Colocar atributos personalizados, eventos personalizados e produtos na lista de bloqueio

Quando um evento ou atributo é colocado na lista de bloqueio, qualquer Segment, Campaign 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 o item nas páginas Atributos personalizados, Eventos personalizados ou Produtos. Para o gerenciamento específico de produtos, consulte também Produtos.
- Selecione o atributo personalizado, evento ou produto. Para atributos e eventos personalizados, você pode selecionar até 100 itens de uma vez para colocar na lista de bloqueio.
- Selecione Lista de bloqueio.

Você pode colocar até 300 atributos personalizados e 300 eventos personalizados na lista de bloqueio. Para impedir a coleta de determinados atributos de dispositivo, consulte nosso guia do SDK.

Atributos personalizados ou eventos personalizados com status Na lixeira contam para o limite da lista de bloqueio até serem excluídos.
Quando um evento ou atributo personalizado é colocado na lista de bloqueio, acontece o seguinte:
- Nenhum dado enviado para a Braze é processado, e eventos e atributos bloqueados deixam de contar como pontos de dados
- Os dados existentes ficam indisponíveis, a menos que sejam reativados
- Eventos e atributos bloqueados não aparecem em filtros nem em 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 o que usa o evento ou atributo bloqueado é arquivado
Para isso, a Braze envia as informações da lista de bloqueio para cada dispositivo. Isso é importante quando você pensa em bloquear um número enorme de eventos e atributos (centenas de milhares ou milhões), pois é uma operação que consome muitos dados.
Considerações sobre a lista de bloqueio
É possível colocar um grande número de eventos e atributos na lista de bloqueio, mas isso não é recomendado. Isso porque, sempre que um evento é realizado ou um atributo é (potencialmente) enviado para a 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ê colocar mais de 300 itens na lista de bloqueio, esses dados serã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 no próximo lançamento. 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.
Excluir dados personalizados
À medida que você cria Campaigns e Segments direcionados, pode perceber 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 Campaign única, pode excluir esses dados depois de colocá-los na lista de bloqueio e remover as referências a eles no seu app. Você pode excluir qualquer tipo de dado (como strings, números e atributos personalizados aninhados).

Somente usuários com a permissão “Add/Remove App Groups” no nível da empresa podem excluir dados personalizados. Consulte Pré-requisitos.
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 os dados personalizados e selecione Ações > Lista de bloqueio.
- Depois que os dados personalizados estiverem na lista de bloqueio por 7 dias, selecione Ações > Excluir.
Como funciona a exclusão
Quando você exclui dados personalizados, acontece o seguinte:
- Para atributos personalizados: Os dados do atributo são removidos permanentemente do perfil de cada usuário.
- Para eventos personalizados: Os metadados do evento são removidos permanentemente do perfil de cada usuário.
Quando um atributo ou evento é selecionado para exclusão, o status dele muda para Na lixeira. Nos sete dias seguintes, é possível recuperar o atributo ou evento. Se você não recuperá-lo em sete dias, os dados são excluídos permanentemente. Se você recuperar o atributo ou evento, ele volta para o estado de lista de bloqueio.
A exclusão não impede que os objetos de dados personalizados continuem sendo registrados nos perfis de usuário. Então, confira se os dados personalizados não estão mais sendo registrados antes de excluir o evento ou atributo.
Coisas para saber
Ao excluir dados personalizados, lembre-se dos 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ê perceber que dados personalizados “reapareceram” na Braze após a exclusão, a causa pode ser uma integração que não foi interrompida e está enviando dados com o mesmo nome.
- Talvez seja necessário colocar um item na lista de bloqueio novamente se os dados personalizados reaparecerem após a exclusão. O status de lista de bloqueio não é preservado, porque os dados personalizados são 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.