Guia completo de taxonomia de eventos e propriedades

Como nomear eventos, propriedades de evento e propriedades de usuário de forma consistente — e os erros a evitar para que seus dados sejam confiáveis.

Antes de começar, se você precisa de ajuda com a taxonomia do seu produto, me escreva em guido@bildungdata.com

Recomendações gerais

• Taxonomia consistente: escolha uma taxonomia para seus eventos e propriedades e mantenha-a. Isso é muito mais importante do que o tipo de taxonomia que você escolher (camelCase, snakecase, etc).
• Use a mesma taxonomia entre plataformas: use a mesma taxonomia em todas as suas plataformas — Android, iOS, Web, Server-Side, etc.
• Use a mesma taxonomia em todas as ferramentas em que você trackea eventos: se você envia um evento para várias ferramentas de MarTech (Mixpanel, OneSignal, Appsflyer, etc), use a mesma taxonomia em todas elas.
• Não trackeie dados privados dos usuários: não envie dados pessoais para nenhuma ferramenta. Ex: cartão de crédito, saldos, etc.

→ TLDR: seja consistente e use a mesma taxonomia em todos os lugares.

Taxonomia — EVENTOS

• Eventos: os eventos são (1) ações realizadas pelos usuários (ex: realizar uma compra), ou (2) ações que acontecem com os usuários (ex: atualizar um saldo por meio de um processo de backend).
• Taxonomia recomendada: queremos uma taxonomia fácil de ler para o olho humano. Por isso, a taxonomia que recomendamos é "objeto + verbo no passado". Ex: Item Viewed, Item Purchased, Video Played.
• Use espaços para separar as palavras. Isso facilita a leitura para qualquer pessoa.
• Use maiúsculas e minúsculas adequadamente (ex: Video Played).
• Evite usar taxonomias como camelCase ou snakecase, simplesmente porque são mais difíceis de ler e, portanto, menos legíveis para o olho humano (se preferir alguma dessas, use — mas seja consistente).
• Use tags para identificar a qual fluxo pertence cada evento: se sua plataforma tem muitos fluxos (onboarding, checkout, etc), é conveniente identificar a qual fluxo pertence cada evento para encontrá-los mais fácil na hora de montar um relatório. Para isso, você pode usar Tags no Mixpanel.
• Não use nomes muito específicos: por exemplo, não use "User Signed Up With Facebook". Use "User Signed Up" e use propriedades do evento para detalhar o método (signupmethod = Facebook).
• Idioma: escolha um idioma que todos entendam. Em igualdade de condições, recomendamos inglês.

→ TLDR: use uma taxonomia fácil de entender: Objeto + Verbo no passado. Separe as palavras com espaços. Use maiúsculas e minúsculas. Ex: Item Viewed, Video Watched.

Taxonomia — PROPRIEDADES DE EVENTOS

• Propriedades de evento: as propriedades de evento servem para enriquecer os dados de um evento. Por exemplo, para o evento "Item Purchased", podemos enviar o tipo de produto comprado (type = 'Coffee'), ou o preço do item (price = 3.14).
• Taxonomia: recomendamos uma taxonomia diferente da usada para eventos, simplesmente para que seja fácil diferenciar uma propriedade de um evento.
• Recomendamos snakecase com todas as palavras em minúsculas.
• Exemplos: signupmethod, errortype, amountpurchased, itemprice, itemcategory.
• Existem diferentes tipos de propriedades de evento: (1) String — valor alfanumérico (ex: userid = "abc123"); (2) Numeric — inteiros ou decimais (ex: price = 3.14); (3) Boolean — true ou false (ex: completedonboarding = true); (4) Timestamp — datas no formato ISO 8601 (ex: lastlogin = "2025-06-12T14:23:00Z"); (5) List — lista de valores (ex: favoriteditems = ["milk", "bread"]).
• Taxonomia consistente entre eventos: se você trackeia a mesma propriedade em diferentes eventos, é muito importante usar o mesmo nome em todos os casos.
• Ex: quando um usuário vê um produto (Item Viewed) e quando um usuário compra um produto (Item Purchased), queremos guardar a categoria do mesmo (propriedade: itemcategory). Envie itemcategory nos dois eventos sem nenhuma variação (espaços, maiúsculas, etc).
• Evento específico vs Evento + Propriedade: um mesmo dado pode ser guardado como parte do evento ou como uma propriedade. Por exemplo: há ações que podem ser feitas a partir de várias telas — é possível adicionar um item ao carrinho a partir de Categorias ou dos resultados de Busca:
• Opção 1 — criar dois eventos específicos: Item Added From Category, Item Added From Search.
• Opção 2 — criar um único evento com uma propriedade: Item Added (propriedade: from; valores: Category, Search).

→ Para escolher a melhor opção, pense em como / com que frequência vai usá-lo; montar um relatório filtrando por uma propriedade leva mais tempo. Se você for fazer esse relatório com frequência, talvez seja melhor a Opção 1.

• Propriedades trackeadas automaticamente: o SDK client-side do Mixpanel trackeia automaticamente certas propriedades em todos os eventos. Têm a seguinte taxonomia: $browser, $device, $screenwidth.

→ TLDR: as propriedades enriquecem os eventos. Existem 5 tipos de propriedades. Use uma taxonomia diferente da de Eventos para diferenciá-los facilmente.

Taxonomia — PROPRIEDADES DE USUÁRIOS

• Usuários: indivíduos específicos que completam ações dentro do seu produto.
• Propriedades de usuário: as propriedades de usuário servem para enriquecer o perfil do usuário. Por exemplo: name, city, currentplan, numberoftransactions.
• Existem diferentes tipos de propriedades de usuário: em geral, os tipos são iguais aos das propriedades de evento: (1) String, (2) Numeric, (3) Boolean, (4) Timestamp, (5) List.
• Taxonomia: recomendamos a mesma taxonomia que para propriedades de evento, para diferenciá-las facilmente dos eventos.
• Use snakecase com todas as palavras em minúsculas.
• Exemplos: firstname, plantype, city, signupmethod.
• São mutáveis — podem mudar no tempo: as propriedades de usuário podem mudar ao longo do tempo (mutáveis), mas nem todas mudam. Por exemplo: name ou userid são duas propriedades que não mudam; já plantype ou totalpurchases serão atualizadas para sempre mostrar o último estado.
• Propriedades incrementais: as propriedades incrementais servem para trackear o valor histórico de propriedades-chave. Por exemplo: se queremos saber o total histórico de compras de cada usuário, podemos trackear a propriedade incremental totalpurchases, que somará +1 a cada nova compra.
• Propriedades trackeadas automaticamente: o SDK client-side do Mixpanel trackeia automaticamente certas propriedades em todos os usuários. Têm a seguinte taxonomia: $city, $region, $countrycode.

→ TLDR: as propriedades de usuário enriquecem o perfil dos usuários. São mutáveis — podem mudar com o tempo.