Skip to content

Gerenciamento de dados personalizados

Esta página aborda como preencher previamente dados personalizados em suas campanhas e segmentos, dados de listas de bloqueio que não são mais úteis e como gerenciar eventos, atributos e propriedades personalizados.

Para saber como gerenciar atributos personalizados em particular, consulte Gerenciamento de atributos personalizados.

Preenchimento prévio de dados personalizados

Pode haver ocasiões em que você queira configurar campanhas e segmentos usando dados personalizados antes que sua equipe de desenvolvimento tenha integrado esses dados personalizados. O Braze permite que você preencha previamente eventos e atributos personalizados no painel antes que esses dados comecem a ser rastreados, de modo que esses eventos e atributos estejam disponíveis para uso em menus suspensos e como parte do processo de criação de campanhas.

Para preencher previamente eventos e atributos personalizados, faça o seguinte:

  1. Vá para Configurações de dados > Eventos personalizados ou Atributos personalizados ou Produtos.

Navegue até Atributos personalizados, Eventos personalizados ou Produtos.](/docs/pt-br/assets/img_archive/prepopulate_page.png?83c13a3d675018771f68754ebc098403){: style=”max-width:90%;” }

2. Para adicionar um atributo, evento ou produto personalizado, vá para a respectiva página e selecione Add Custom Attributes (Adicionar atributos personalizados ) ou Add Custom Events (Adicionar eventos personalizados ) ou Add Products (Adicionar produtos).

Para atributos personalizados, selecione um tipo de dados para esse atributo (por exemplo, booleano ou cadeia de caracteres). O tipo de dados de um atributo determinará os filtros de segmentação disponíveis para esse atributo.

!Adicionar novo atributo ou evento 3. Selecione Salvar.

Nomeação de eventos e atributos personalizados

Os eventos e atributos personalizados diferenciam maiúsculas de minúsculas. Lembre-se disso quando sua equipe de desenvolvimento integrar esses eventos ou atributos personalizados posteriormente. Eles devem nomear os eventos ou atributos personalizados exatamente como você os nomeou aqui, ou o Braze gerará um evento ou atributo personalizado diferente.

Gerenciamento de propriedades

Depois de criar um evento ou produto personalizado, selecione Gerenciar propriedades desse evento ou produto para adicionar novas propriedades, colocar as propriedades existentes em uma lista de bloqueio e visualizar quais campanhas ou Canvases usam essa propriedade em um evento de acionamento.

!Propriedades personalizadas para um evento personalizado.

Para tornar rastreáveis esses atributos personalizados, eventos, produtos ou propriedades de eventos adicionados, é preciso pedir à sua equipe de desenvolvimento que os crie no SDK usando o nome exato que você usou para adicioná-los anteriormente. Ou você pode usar a API do Braze para importar dados sobre esse atributo. Depois disso, o atributo personalizado, evento ou outro será acionável e aplicado aos seus usuários.

Lista de bloqueio de 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 ao Braze, você pode colocar um objeto de dados personalizado em uma lista de bloqueio enquanto sua equipe de engenharia trabalha para removê-lo do backend do seu aplicativo ou site. A lista de bloqueio impede que um determinado objeto de dados personalizado seja registrado pelo Braze no futuro, o que significa que ele não será exibido ao pesquisar um usuário específico.

Os dados incluídos na lista de bloqueio não serão enviados pelo SDK, e o painel do Braze não processará dados incluídos na lista de bloqueio de outras fontes (por exemplo, a API). No entanto, a lista de bloqueio não remove dados dos perfis de usuário nem diminui retroativamente a quantidade de pontos de dados incorridos para esse objeto de dados personalizado.

Lista de bloqueio de atributos personalizados, eventos personalizados e produtos

Para interromper o rastreamento de um atributo personalizado, evento ou produto específico, siga estas etapas:

  1. Procure-o nas páginas Custom Attributes (Atributos personalizados), Custom Events (Eventos personalizados) ou Products (Produtos ).
  2. Selecione o atributo, evento ou produto personalizado. Para atributos e eventos personalizados, você pode selecionar até 100 para a lista de bloqueio de cada vez.
  3. Selecione Blocklist.

Vários atributos personalizados selecionados que estão na lista de bloqueio da página Atributos personalizados.](/docs/pt-br/assets/img_archive/blocklist_custom_attr.png?25228d70e3157dcc9b0e340209d7dacd)

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

Quando um evento ou atributo personalizado é colocado em uma lista de bloqueio, aplica-se o seguinte:

  • Nenhum dado enviado ao Braze será processado, e os eventos e atributos incluídos na lista de bloqueio não serão mais contados como pontos de dados
  • Os dados existentes ficarão indisponíveis, a menos que sejam reativados
  • Os eventos e atributos incluídos em listas de bloqueio não serão exibidos em filtros ou gráficos
  • As referências a dados da lista de bloqueio em rascunhos de Canvases ativos serão carregadas como valores inválidos, o que pode causar erros
  • Qualquer coisa que use o evento ou atributo da lista de bloqueio será arquivada

Para isso, o Braze envia as informações da lista de bloqueio para cada dispositivo. Isso é importante quando se pensa em colocar na lista de bloqueio um grande número de eventos e atributos (centenas de milhares ou milhões), pois seria uma operação com uso intensivo de dados.

Considerações sobre listas de bloqueio

É possível colocar na lista de bloqueio um grande número de eventos e atributos, mas não é aconselhável. Isso ocorre porque toda vez que um evento é realizado ou um atributo é (potencialmente) enviado ao Braze, esse evento ou atributo precisa ser verificado em relação a toda a lista de bloqueios.

Até 300 itens são enviados ao SDK para inclusão na lista de 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 aplicativo na próxima versão. As alterações na lista de bloqueios podem levar alguns minutos para serem propagadas. Você pode reativar qualquer evento ou atributo da blocklist a qualquer momento.

Exclusão de dados personalizados

À medida que você cria campanhas e segmentos direcionados, 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, poderá excluir esses dados após colocá-los na lista de bloqueio e remover suas referências do seu aplicativo. Você pode excluir qualquer tipo de dados (como cadeias de caracteres, números e atributos personalizados aninhados).

Para excluir um evento personalizado ou atributo personalizado, faça o seguinte:

  1. Vá para Configurações de dados > Atributos personalizados ou Eventos personalizados, dependendo do tipo de dados que você deseja excluir.
  2. Vá para os dados personalizados e selecione Actions > Blocklist.
  3. Depois que seus dados personalizados estiverem na lista de bloqueio por 7 dias, selecione Actions > Delete.

Como funciona a exclusão

Quando você exclui dados personalizados, ocorre o seguinte:

  • Para atributos personalizados: Remove permanentemente os dados de 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 restaurar o atributo ou evento. Se você não restaurá-lo após sete dias, os dados serão excluídos permanentemente. Se você restaurar 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, portanto, certifique-se de que os dados personalizados não estejam mais sendo registrados antes de excluir o evento ou atributo.

Coisas para saber

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 o nome do evento personalizado após a exclusão. Isso significa que se você notar que os dados personalizados “reaparecem” no 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 dados personalizados.
  • Talvez seja necessário colocar um item na lista de bloqueio novamente se a exclusão resultar no reaparecimento de dados personalizados. O status da 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.

Forçar comparações de tipos de dados

A Braze reconhece automaticamente os tipos de dados para os dados de atributos que nos são enviados. No entanto, caso vários tipos de dados sejam aplicados a um único atributo, você pode forçar o tipo de dados de qualquer atributo para nos informar qual é. Selecione na lista suspensa da coluna Data Type (Tipo de dados ).

Tipo de dados de atributos personalizados](/docs/pt-br/assets/img_archive/custom_events_view_data_type_dropdown.png?4456d3d8c2b1e7b516e0895d15f0b9e9)

Coerção de tipos de dados

Para obter mais informações sobre opções de filtro específicas expostas por diferentes comparações de tipos de dados, consulte Configurar relatórios. Para obter mais informações sobre os diferentes tipos de dados disponíveis, consulte Tipos de dados de atributos personalizados.

New Stuff!