Skip to content

Curso do Braze LearningAtributos personalizados

Esta página aborda os atributos personalizados, que são uma coleção de características únicas dos seus usuários. Os atributos personalizados são ideais para armazenar informações sobre seus usuários ou dados sobre ações de baixo valor dentro do seu app.

Quando armazenados na Braze, os atributos personalizados podem ser usados para criar segmentos de público e personalizar mensagens usando Liquid. Lembre-se de que a Braze não armazena informações de séries temporais para atributos personalizados, então você não pode gerar gráficos com base neles como faz com eventos personalizados.

Casos de uso

Alguns casos de uso comuns de atributos personalizados incluem:

  • Direcionamento e supressão de públicos por meio da segmentação de usuários com base em características como nível de fidelidade, status de inscrição, idioma preferido ou tipo de plano
  • Personalização de mensagens com Liquid referenciando atributos como o nome do usuário, pontos de recompensas ou categoria favorita
  • Rastreamento de estágios do ciclo de vida e estados do usuário, como estágio de integração, status da conta ou data de término do período de teste
  • Contagem de ações de baixo valor com atributos numéricos, como incrementar um atributo feature_views_count cada vez que um usuário visualiza um recurso
  • Registro de quando ações de baixo valor ocorreram pela última vez usando atributos de tempo, como last_support_ticket_at ou last_password_reset_at
  • Armazenamento de interesses e histórico do usuário como arrays, como gêneros favoritos ou conteúdo visualizado recentemente, para direcionamento baseado em interesses
  • Armazenamento de dados de perfil mais ricos como objetos ou arrays de objetos, como preferências estruturadas ou múltiplos endereços salvos
  • Disparo de mensagens baseadas em ação quando o valor de um atributo muda usando gatilhos de atributo, como enviar uma notificação de upgrade de nível quando o rewards_tier de um usuário muda

Gerenciar atributos personalizados

Para criar e gerenciar atributos personalizados no dashboard, acesse Configurações de dados > Atributos personalizados.

Quatro atributos personalizados que são booleanos.

A coluna Última atualização lista a última vez que o atributo personalizado foi editado, como quando foi definido pela última vez como lista de bloqueio ou ativo.

Nesta página, você pode visualizar, gerenciar, criar ou bloquear atributos personalizados existentes. Selecione o menu ao lado de um atributo personalizado para as seguintes ações:

Lista de bloqueio

Você pode bloquear atributos personalizados individuais pelo menu de ações, ou selecionar e bloquear até 100 atributos em massa.

Quando você bloqueia um atributo personalizado:

  • Dados futuros não serão coletados para esse atributo.
  • Os dados existentes não estarão disponíveis, a menos que o atributo seja desbloqueado.
  • Esse atributo não aparecerá em filtros ou gráficos.

Além disso, se um atributo personalizado bloqueado estiver sendo referenciado por filtros ou gatilhos em outras áreas da Braze, um modal de aviso aparecerá explicando que todas as instâncias dos filtros ou gatilhos que o referenciam serão removidas e arquivadas.

Para mais detalhes sobre bloqueio e exclusão de dados personalizados, consulte Bloquear dados personalizados.

Marcar como informação de identificação pessoal (IPI)

Administradores também podem criar atributos personalizados e marcá-los como IPI nesta página. Esses atributos são visíveis apenas para administradores e usuários do dashboard com a permissão “Visualizar atributos personalizados marcados como IPI”.

Adicionar descrições

Você pode adicionar uma descrição a um atributo personalizado após sua criação, se tiver a permissão de usuário Manage Events, Attributes, Purchases. Selecione Editar descrição para o atributo personalizado e insira o que desejar, como uma nota para sua equipe.

Adicionar tags

Você pode adicionar tags a um atributo personalizado após sua criação, se tiver a permissão de usuário “Manage Events, Attributes, Purchases”. As tags podem então ser usadas para filtrar a lista de atributos.

Remover atributos personalizados

Existem duas maneiras de remover atributos personalizados dos perfis de usuário:

Exportar dados

Para exportar a lista de atributos personalizados como um arquivo CSV, selecione Exportar tudo no topo da página. O arquivo CSV será gerado e um link para download será enviado por e-mail.

Alterar o tipo de atributo personalizado

Pré-requisitos

O atributo personalizado não pode estar em uso em nenhuma campanha, Canvas ou segmento ativo. Se você tentar alterar o tipo de dados enquanto o atributo ainda estiver sendo referenciado, o dashboard exibirá um erro e bloqueará a alteração.

Alterando o tipo de dados

  1. Interrompa quaisquer campanhas ou Canvas ativos que usem o atributo em segmentos ou filtros.
  2. Remova o atributo de todos os filtros de segmento, campanha e Canvas.
  3. Acesse Configurações de dados > Atributos personalizados (ou Eventos personalizados), encontre o atributo e atualize-o para o tipo de dados desejado.
  4. Atualize os valores do atributo nos perfis de usuário existentes para corresponder ao novo tipo de dados (por exemplo, usando o endpoint /users/track).
  5. Reaplique o atributo aos segmentos, campanhas e Canvas relevantes e reative quaisquer campanhas ou Canvas interrompidos.

Informações importantes

  • Os dados de usuários não são atualizados retroativamente. Se um perfil de usuário tinha o atributo com o tipo de dados antigo, esse valor permanece inalterado. O filtro de segmentação procura o novo tipo de dados, então usuários com o valor antigo são excluídos dos segmentos correspondentes até que seu perfil seja atualizado.
  • Novos dados devem corresponder ao novo tipo de dados. Após a alteração, chamadas de API ou eventos do SDK que enviem o tipo de dados anterior para esse atributo não serão aceitos. Apenas valores que correspondam ao novo tipo de dados serão processados.
  • Os filtros não são atualizados automaticamente. Segmentos e filtros de campanha que referenciam o atributo alterado não são atualizados retroativamente. Você deve removê-los e adicioná-los novamente após a alteração.

Visualizar relatórios de uso

O relatório de uso lista todos os Canvas, campanhas e segmentos que usam um atributo personalizado específico. Esta lista não inclui usos de Liquid.

Você pode visualizar até 100 relatórios de uso por vez selecionando as caixas de seleção ao lado dos respectivos atributos personalizados e depois selecionando Visualizar relatório de uso.

Guia valores

Ao visualizar um relatório de uso, selecione a guia Valores para ver os principais valores dos atributos personalizados selecionados com base em uma amostra de aproximadamente 250.000 usuários. Como os resultados são amostrados de um subconjunto de usuários, a amostra não incluirá todos os valores existentes. Isso significa que a guia Valores não deve ser usada para solução de problemas ou para casos de uso que exijam a incorporação de dados de todos os usuários.

Relatório de uso para atributos personalizados selecionados com a guia "Valores" aberta mostrando um gráfico de pizza dos valores do atributo de país, como "US" e "PR".

Definir atributos personalizados

A seguir estão listados os métodos em várias plataformas usados para definir atributos personalizados.

Expandir para documentação por plataforma

Armazenamento de atributos personalizados

Todos os dados armazenados no Perfil de usuário, incluindo dados de atributos personalizados, são retidos indefinidamente enquanto cada perfil estiver ativo.

Para uma referência completa de todos os tipos de dados que podem ser armazenados como atributos personalizados — incluindo booleanos, números, strings, arrays, tempo, objetos e arrays de objetos — consulte Tipos de dados de atributos personalizados.
New Stuff!