Ir para o conteúdo

Curso do Braze LearningEventos 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:

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_visit ou marketing_click
  • Propriedades para rastrear: utm_source (origem do tráfego, como facebook ou newsletter), utm_medium (tipo de canal, como email ou paid_social), utm_campaign (identificador específico da campanha), utm_content (link ou criativo específico) e utm_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_case ou camelCase) 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_completed em vez de vid_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:

  1. Acesse Data Settings > Custom Attributes ou Custom Events e localize as duas entradas que parecem ter o mesmo nome.
  2. Confirme se um dos nomes contém espaços ocultos:
    1. Clique com o botão direito em cada nome e selecione Inspecionar.
    2. Verifique o valor do texto HTML nas ferramentas de desenvolvedor do navegador.
    3. Compare os valores (por exemplo, email versus ` email`).
    4. Se necessário, consulte Inspecionar e editar páginas e estilos com o Chrome DevTools.
  3. Decida qual nome deve permanecer como sua chave canônica e padronize a grafia e o uso de maiúsculas/minúsculas exatos.
  4. 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.
  5. 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.

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:

  1. Acesse Público > Pesquisar usuários e selecione um usuário para abrir o perfil dele.
  2. 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.

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.

Gráfico de contagem de eventos personalizados na página Eventos personalizados do dashboard, mostrando tendências de um evento personalizado

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.

Filtros do gráfico de eventos personalizados

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.

New Stuff!