Convenções de nomenclatura de eventos

Esta página aborda as convenções adequadas de nomenclatura de eventos e as práticas recomendadas. Ao manter a consistência em sua taxonomia de eventos e atribuições, você manterá seus dados limpos e utilizáveis por usuários novos e existentes da plataforma Braze. Isso ajuda a evitar problemas posteriores, como disparar uma campanha para o público errado ou gerar resultados errados depois de usar o evento errado.

Melhores práticas

• Mantenha sua convenção de nomenclatura clara.
• Use letras maiúsculas e minúsculas e formatação consistente nos nomes dos eventos.
• Evite dar nomes semelhantes aos eventos.
• Evite longas strings de atribuições de eventos, que serão truncadas ou cortadas no dashboard da Braze.

Convenções de nomenclatura

Usar grupos de eventos

Use grupos para diferenciar partes de seu produto para nomear eventos. Ao categorizar seu produto em grupos, qualquer usuário pode entender claramente a que o evento se refere e o que ele faz.

Estrutura de nomenclatura de eventos

A estrutura de nomes mais comum é group_noun_action. Os eventos devem ser todos em letras minúsculas para evitar erros de instrumentação e identificação de propriedades.

Propriedades

Tag um evento e, em seguida, identifique as diferenças usando as propriedades. Isso é útil para eventos que são inerentemente iguais, mas têm pequenas diferenças, como canais para uma campanha. Também podemos ver facilmente como os usuários fluem pelos eventos. Consulte o objeto de propriedades do evento para obter um exemplo e contexto adicional.

Exemplos

Digamos que você faça parte de uma empresa de comércio eletrônico e esteja interessado em rastrear quando os clientes inscreveram-se em seu app e quando assinaram seu boletim informativo. Aqui estão alguns exemplos de nomes de eventos eficazes:

• user_signup
• newsletter_sunscribed

Esses dois nomes de eventos indicam claramente o evento que estão rastreando. Ao criar mais eventos personalizados, certifique-se de manter suas convenções de nomenclatura compreensíveis. Por exemplo, evite usar nomes de eventos como signup_event_1, pois isso não é claro e não transmite o que o evento está rastreando, em comparação com user_signup.