Eventos personalizados
Este artigo descreve eventos e propriedades personalizados, histórico de eventos do perfil de usuário, filtros de segmentação relacionados, propriedades de entrada do Canvas, análises de dados relevantes e muito mais. Para saber mais sobre os eventos da Braze em geral, consulte Eventos.
Os eventos personalizados são ações realizadas pelos seus usuários ou atualizações sobre eles. Quando os eventos personalizados são registrados, eles podem disparar qualquer número e tipo de Campaigns de acompanhamento. Depois, você pode usar os filtros de segmentação para segmentar os usuários com base na frequência e em quão recentemente esses eventos personalizados ocorreram. Por isso, os eventos personalizados são mais adequados para rastrear interações de alto valor dos usuários dentro do seu app.
Casos de uso
Alguns casos de uso comuns de eventos personalizados incluem:
- Disparar uma Campaign ou Canvas com base em um evento personalizado usando entrega baseada em ação
- Segmentar usuários pela quantidade de vezes que realizaram um evento personalizado, quando o evento ocorreu pela última vez e informações semelhantes
- Usar a análise de dados de eventos personalizados do dashboard para visualizar um agregado da frequência de cada evento
- Encontrar análises adicionais usando relatórios de funil e retenção
- Aproveitar as propriedades de entrada persistentes para usar metadados do evento do cliente na personalização das etapas do Canvas
- Gerar análises mais sofisticadas com o Currents
- Configurar critérios de saída para definir quando os usuários devem sair do Canvas
Eventos recomendados para rastrear
Ao planejar sua estratégia de eventos personalizados, considere rastrear os tipos de eventos a seguir. Eles costumam impulsionar o engajamento e ajudam você a entender a jornada dos seus usuários.
Atribuição de marketing
Rastreie como os usuários descobrem seu app ou website registrando eventos personalizados que capturam detalhes das campanhas de marketing. Quando os usuários chegarem por campanhas de e-mail, anúncios pagos ou redes sociais, capture os parâmetros UTM como propriedades do evento:
- Nome do evento:
campaign_visitoumarketing_click - Propriedades para rastrear:
utm_source(origem do tráfego, comofacebookounewsletter),utm_medium(tipo de canal, comoemailoupaid_social),utm_campaign(identificador específico da campanha),utm_content(link ou criativo específico) eutm_term(palavras-chave de pesquisa paga)
Assim, você pode segmentar usuários por canal de aquisição, medir o desempenho das campanhas e disparar mensagens de acompanhamento direcionadas com base nas campanhas que converteram.
Comportamento de pesquisa
Rastreie quando os usuários fazem pesquisas no seu app ou website para entender o que eles estão procurando e identificar lacunas de conteúdo:
- Nome do evento:
search_submitted - Propriedades para rastrear:
search_query(o termo de pesquisa inserido),results_count(número de resultados retornados),selected_result(qual resultado o usuário clicou, se houver)
Use esses dados para criar segmentos de usuários interessados em temas específicos, disparar recomendações personalizadas ou identificar pesquisas populares que retornam poucos resultados.
Engajamento com recursos
Rastreie o uso dos principais recursos para entender quais funcionalidades geram valor:
- Etapas de tutorial ou integração: Registre a conclusão de cada etapa para identificar onde os usuários desistem
- Descoberta de recursos: Rastreie quando os usuários usam recursos importantes pela primeira vez
- Interações com conteúdo: Registre quando os usuários salvam, compartilham ou adicionam conteúdo aos favoritos
- Conteúdo gerado pelo usuário: Rastreie quando os usuários criam, editam ou publicam conteúdo
Marcos de conversão
Além da compra em si, rastreie as microconversões que levam à receita:
- Adicionar à lista de desejos ou aos favoritos: Identifique os produtos que os usuários estão considerando
- Comparações de produtos: Rastreie quais produtos os usuários comparam lado a lado
- Início e conclusão de formulários: Meça as desistências em fluxos com várias etapas
- Agendamentos ou reservas: Rastreie o comportamento de agendamento
Melhores práticas
Ao implementar eventos personalizados:
- Use nomes consistentes: Defina uma convenção de nomenclatura (como
snake_caseoucamelCase) e use-a em todos os eventos - Foque nas ações dos usuários: Rastreie o que os usuários fazem, não o que seu sistema faz nos bastidores
- Mantenha as propriedades de eventos planas: Evite objetos muito aninhados nas propriedades de eventos
- Use nomes semânticos: Escolha nomes de eventos que descrevam claramente a ação, como
video_completedem vez devid_end
Para esquemas de eventos de eCommerce prontos, consulte Eventos recomendados de eCommerce.
Gerenciamento de eventos personalizados
Você pode gerenciar, criar ou incluir eventos personalizados na lista de bloqueio no dashboard em Configurações de dados > Eventos personalizados.
Solução de problemas de atributos ou eventos personalizados duplicados
Se você encontrar duas entradas de dados personalizados com o mesmo nome visível, uma delas pode conter um espaço invisível no início ou no final.
Para solucionar e corrigir isso:
- Acesse Data Settings > Custom Attributes ou Custom Events e localize as duas entradas que parecem ter o mesmo nome.
- Confirme se um dos nomes contém espaços ocultos:
- Clique com o botão direito em cada nome e selecione Inspecionar.
- Verifique o valor do texto HTML nas ferramentas de desenvolvedor do navegador.
- Compare os valores (por exemplo,
emailversus ` email`). - Se necessário, consulte Inspecionar e editar páginas e estilos com o Chrome DevTools.
- Decida qual nome deve permanecer como sua chave canônica e padronize a grafia e o uso de maiúsculas/minúsculas exatos.
- Se uma entrada incluir espaços no início ou no final e tiver sido criada diretamente no dashboard, pare de usar essa entrada e migre para a chave canônica:
- Atualize quaisquer fluxos de trabalho do dashboard, importações de CSV e runbooks internos para usar a chave canônica.
- Bloqueie dados personalizados da entrada incorreta quando estiver pronto para descontinuá-la.
- Verifique seus caminhos de ingestão:
- As cargas úteis de API e SDK removem automaticamente espaços no início e no final.
- Nomes criados pelo dashboard não são ajustados automaticamente, então a entrada manual e a governança são necessárias.
Selecione o menu ao lado de um evento personalizado para as seguintes ações:
Lista de bloqueio
Você pode bloquear eventos personalizados individualmente pelo menu de ações ou selecionar e bloquear até 100 eventos em massa.
Quando você bloqueia um evento personalizado:
- Dados futuros não serão coletados para esse evento.
- Os dados existentes não estarão disponíveis, a menos que esse evento seja desbloqueado.
- Esse evento não aparecerá em filtros ou gráficos.
Além disso, se um evento personalizado bloqueado estiver sendo referenciado por filtros ou gatilhos em outras áreas da Braze, aparecerá um modal de alerta explicando que todas as instâncias dos filtros ou gatilhos que fazem referência a ele serão removidas e arquivadas.
Para saber mais sobre como bloquear e excluir dados personalizados, consulte Lista de bloqueio de dados personalizados.
Adição de descrições
Você pode adicionar uma descrição a um evento personalizado depois que ele for criado, desde que tenha a permissão de usuário Manage Events, Attributes, Purchases. Selecione Editar descrição no evento personalizado e insira o que quiser, como uma nota para sua equipe.
Adição de tags
Você pode adicionar tags a um evento personalizado depois que ele for criado, desde que tenha a permissão de usuário “Manage Events, Attributes, Purchases”. Depois, você pode usar as tags para filtrar a lista de eventos.
Exportação de dados
Para exportar a lista de eventos personalizados como um arquivo CSV, selecione Exportar tudo na parte superior da página. O arquivo CSV será gerado, e você receberá um link para download por e-mail.

Não existe um limite fixo no dashboard para a quantidade de eventos personalizados ou atributos personalizados distintos que você pode definir ou armazenar em um perfil. Os limites práticos dependem do formato dos dados, do volume de ingestão e do desempenho do espaço de trabalho. Se você planeja rastrear um catálogo muito grande de eventos ou atributos, converse com a equipe da sua conta Braze sobre modelagem e boas práticas de higiene de dados (por exemplo, incluir na lista de bloqueio os dados não utilizados).
Visualização de relatórios de uso
O relatório de uso lista todos os Canvas, Campaigns e Segments que usam um evento personalizado específico. Essa lista não inclui usos em Liquid.
Você pode visualizar até 100 relatórios de uso por vez. Para isso, marque as caixas de seleção ao lado dos eventos personalizados desejados e selecione Exibir relatório de uso.
Registro de eventos personalizados
Os eventos personalizados exigem uma configuração adicional. Consulte a documentação de cada plataforma a seguir para conhecer os métodos usados para registrar eventos personalizados e saber como adicionar propriedades e quantidades a eles.
Expandir para ver a documentação por plataforma
Armazenamento de eventos personalizados
Todos os dados armazenados no perfil do usuário, incluindo metadados de eventos personalizados (primeira ou última ocorrência, contagem total e X em Y nos últimos 30 dias), são mantidos indefinidamente enquanto cada perfil estiver ativo.
Visualizar o histórico de eventos de um usuário
Use a guia Histórico de eventos no perfil de um usuário para ver os eventos personalizados e as compras mais recentes dele. Assim, você confirma se a sua integração está registrando os eventos corretamente e soluciona problemas de usuários específicos direto no dashboard.
Para visualizar o histórico de eventos de um usuário:
- Acesse Público > Pesquisar usuários e selecione um usuário para abrir o perfil dele.
- Selecione a guia Histórico de eventos.
A guia lista os eventos personalizados e as compras do usuário dos últimos 30 dias. São exibidos até os 100 eventos mais recentes, do mais novo para o mais antigo.
Cada evento inclui:
- Tipo de evento: Se o evento é um evento personalizado ou uma compra.
- Nome do evento: O nome do evento da forma como foi registrado.
- Horário: Quando o evento ocorreu.
- Propriedades: As propriedades completas do evento para aquela ocorrência, exibidas em JSON.
Os casos de uso comuns incluem:
- Verificar se a sua integração de SDK ou API está enviando eventos como esperado durante o desenvolvimento ou após um lançamento.
- Descobrir por que um usuário entrou ou não em uma Campaign ou em um Canvas disparado por evento.
- Investigar um problema de suporte de um usuário específico sem precisar configurar uma exportação de dados.

Para visualizar a guia Histórico de eventos, você precisa das permissões de usuário Pesquisar usuários, Visualizar IPI e Visualizar propriedades de eventos do usuário, já que as propriedades de eventos podem conter dados pessoais. Para saber mais, consulte Permissões de usuários da empresa.
Filtros de segmentação
A tabela a seguir mostra os filtros disponíveis para segmentar usuários por eventos personalizados.
| Opções de segmentação | Filtro suspenso | Opções de entrada |
|---|---|---|
| Verificar se o evento personalizado ocorreu mais de X vezes | MAIS DE | NÚMERO |
| Verificar se o evento personalizado ocorreu menos de X vezes | MENOS DE | NÚMERO |
| Verificar se o evento personalizado ocorreu exatamente X vezes | EXATAMENTE | NÚMERO |
| Verificar se a última ocorrência do evento personalizado foi após a data X | APÓS | HORA |
| Verificar se a última ocorrência do evento personalizado foi antes da data X | ANTES DE | HORA |
| Verificar se a última ocorrência do evento personalizado foi há mais de X dias | MAIS DE | NÚMERO DE DIAS ATRÁS (número positivo) |
| Verificar se a última ocorrência do evento personalizado foi há menos de X dias | MENOS DE | NÚMERO DE DIAS ATRÁS (número positivo) |
| Verificar se o evento personalizado ocorreu mais de X vezes (máximo = 50) | MAIS DE | nos últimos Y dias (Y = 1,3,7,14,21,30) |
| Verificar se o evento personalizado ocorreu menos de X vezes (máximo = 50) | MENOS DE | nos últimos Y dias (Y = 1,3,7,14,21,30) |
| Verificar se o evento personalizado ocorreu exatamente X vezes (máximo = 50) | EXATAMENTE | nos últimos Y dias (Y = 1,3,7,14,21,30) |
Análise de dados
A Braze registra o número de vezes que os eventos personalizados ocorreram e a última vez que cada usuário os realizou, para uso na segmentação. Para saber mais sobre configuração de relatórios, filtros e opções de exportação, consulte Relatório de eventos personalizados.
Na página Relatório de eventos personalizados, você pode ver de forma agregada com que frequência cada evento personalizado ocorre. As linhas cinzas sobrepostas à série temporal indicam a última vez que uma Campaign foi enviada. Isso ajuda a ver como suas Campaigns afetaram a atividade dos eventos personalizados.

Você também pode usar Filtros para detalhar seus eventos personalizados por hora, média mensal de usuários (MAU), Segments ou fórmulas de KPI.


Incremente atributos personalizados para manter um contador de uma ação do usuário, de forma semelhante a um evento personalizado. No entanto, não é possível visualizar dados de atributos personalizados em uma série temporal. Use esse método para registrar ações do usuário que não precisam ser analisadas em uma série temporal.
Por que a análise de dados de eventos personalizados não está aparecendo
Segments criados com dados de eventos personalizados não mostram dados históricos anteriores à data de criação.
Propriedades de eventos personalizados
As propriedades de eventos personalizados são metadados ou atributos de eventos personalizados que descrevem uma ocorrência específica de um evento. Essas propriedades podem ser usadas para qualificar ainda mais as condições de gatilho, aumentar a personalização no envio de mensagens, rastrear conversões e gerar análises de dados mais sofisticadas por meio da exportação de dados brutos.
Para saber mais, consulte Propriedades de eventos personalizados.