Análise de dados

Saiba mais sobre a análise de dados do SDK da Braze, para que você possa entender melhor quais dados a Braze coleta, a diferença entre eventos personalizados e atributos personalizados, e as melhores práticas para gerenciar a análise de dados.

Dica

Durante a sua implementação da Braze, certifique-se de discutir as metas de marketing com sua equipe, para que você possa decidir da melhor forma quais dados deseja rastrear e como deseja rastreá-los com a Braze. Como exemplo, veja nosso estudo de caso de aplicativo de táxi/viagem por aplicativo no final deste guia.

Dados coletados automaticamente

Certos dados de usuários são coletados automaticamente pelo nosso SDK — por exemplo, Primeiro uso do app, Último uso do app, Contagem total de sessões, Sistema operacional do dispositivo, etc. Se você seguir nossos guias de integração para implementar nossos SDKs, poderá aproveitar essa coleta de dados padrão. Verificar essa lista pode ajudar você a evitar armazenar a mesma informação sobre os usuários mais de uma vez. Com exceção do início e do fim de sessão, todos os outros dados rastreados automaticamente não contam para o seu uso de pontos de dados.

Consulte nosso artigo Introdução ao SDK para adicionar processos à lista de permissões que bloqueiam a coleta padrão de determinados itens de dados.

Eventos personalizados

Eventos personalizados são ações realizadas pelos seus usuários; eles são ideais para rastrear interações de alto valor dos usuários com o seu aplicativo. Registrar um evento personalizado pode disparar qualquer número de campanhas de acompanhamento com postergações configuráveis, e possibilita os seguintes filtros de segmentação em torno da recência e frequência desse evento:

A Braze registra o número de vezes que esses eventos ocorreram, bem como a última vez que foram realizados por cada usuário para segmentação. Na página de análise de dados de Custom Events, você pode visualizar de forma agregada com que frequência cada evento personalizado ocorre, assim como por Segment ao longo do tempo para uma análise mais detalhada. Isso é particularmente útil para ver como suas campanhas afetaram a atividade de eventos personalizados, observando as linhas cinzas que a Braze sobrepõe na série temporal para indicar a última vez que uma campanha foi enviada.

Nota

Atributos personalizados incrementais podem ser usados para manter um contador de uma ação do usuário semelhante a um evento personalizado. No entanto, você não poderá visualizar dados de atributos personalizados em uma série temporal. Ações de usuários que não precisam ser analisadas em série temporal devem ser registradas por esse método.

Armazenamento de eventos personalizados

Todos os dados de perfil de usuário (eventos personalizados, atributos personalizados, dados personalizados) são armazenados enquanto esses perfis estiverem ativos.

Propriedades de eventos personalizados

Com as propriedades de eventos personalizados, a Braze permite que você defina propriedades em eventos personalizados e compras. Essas propriedades podem então ser usadas para qualificar ainda mais as condições de disparo, aumentar a personalização no envio de mensagens e gerar análises mais sofisticadas por meio da exportação de dados brutos. Os valores das propriedades podem ser string, número, booleano ou objetos de tempo. No entanto, os valores das propriedades não podem ser objetos de array.

Por exemplo, se um aplicativo de e-commerce quisesse enviar uma mensagem para um usuário quando ele abandona o carrinho, poderia melhorar ainda mais seu público-alvo e permitir maior personalização da campanha adicionando uma propriedade de evento personalizado de cart_value dos carrinhos dos usuários.

As propriedades de eventos personalizados também podem ser usadas para personalização dentro do modelo de mensagem. Qualquer campanha que use entrega baseada em ação com um evento-gatilho pode usar propriedades de eventos personalizados desse evento para personalização de mensagens. Se um aplicativo de jogos quisesse enviar uma mensagem para usuários que completaram uma fase, ele poderia personalizar ainda mais a mensagem com uma propriedade para o tempo que os usuários levaram para completar aquela fase. Neste exemplo, a mensagem é personalizada para três segmentos diferentes usando lógica condicional. A propriedade de evento personalizado chamada time_spent pode ser incluída na mensagem chamando {{event_properties.${time_spent}}}.

1
2
3
4
5
6
7

{% if {{event_properties.${time_spent}}} < 600 %}
Congratulations on beating that level so fast! Check out our online portal where you can play against top players from around the world!
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Talk to villagers for essential tips on how to beat levels!
{% endif %}

As propriedades de eventos personalizados foram projetadas para ajudar você a personalizar suas mensagens ou criar campanhas granulares de entrega baseada em ação. Se você deseja criar segmentos com base na recência e frequência de propriedades de eventos, entre em contato com seu CSM ou com nossa equipe de suporte.

Atributos personalizados

Atributos personalizados são ferramentas extraordinariamente flexíveis que permitem segmentar usuários com maior especificidade do que seria possível com atributos padrão. Atributos personalizados são ótimos para armazenar informações específicas da marca sobre seus usuários. Tenha em mente que a Braze não armazena informações de séries temporais para atributos personalizados, então você não terá gráficos baseados neles como no exemplo anterior de eventos personalizados.

Armazenamento de atributos personalizados

Todos os dados do perfil de usuário (eventos personalizados, atributos personalizados, dados personalizados) são armazenados enquanto esses perfis estiverem ativos.

Tipos de dados de atributos personalizados

Os seguintes tipos de dados podem ser armazenados como atributos personalizados:

Strings (caracteres alfanuméricos)

Atributos do tipo string são úteis para armazenar entrada do usuário, como uma marca favorita, um número de telefone ou a última string de busca dentro do seu aplicativo. Atributos do tipo string estão sujeitos às restrições de comprimento para dados personalizados (479 bytes; aproximadamente 479 caracteres de byte único ou aproximadamente 160 caracteres para scripts de múltiplos bytes, como japonês).

A tabela a seguir descreve as opções de segmentação disponíveis para atributos do tipo string.

Importante

Ao segmentar usando o filtro DOES NOT MATCH REGEX, é necessário que já exista um atributo personalizado com um valor atribuído no perfil desse usuário. A Braze sugere usar a lógica “OR” para verificar se um atributo personalizado está em branco, a fim de segmentar os usuários corretamente.

Dica

Para saber mais sobre como usar nosso filtro de expressões regulares, confira esta documentação sobre expressões regulares compatíveis com Perl (PCRE).
Mais recursos sobre regex:

• Regex com a Braze
• Debugger e testador de regex
• Tutorial de regex

Arrays

Atributos do tipo array são bons para armazenar listas relacionadas de informações sobre seus usuários. Por exemplo, armazenar as últimas 100 peças de conteúdo que um usuário assistiu em um array permitiria uma segmentação específica por interesse.

Arrays de atributos personalizados são conjuntos unidimensionais; arrays multidimensionais não são suportados. Adicionar um elemento a um array de atributo personalizado insere o elemento no final do array, a menos que ele já esteja presente, caso em que ele é movido de sua posição atual para o final do array. Por exemplo, se um array ['hotdog','hotdog','hotdog','pizza'] fosse importado, ele apareceria no atributo de array como ['hotdog', 'pizza'], porque apenas valores únicos são suportados.

Se o array contiver seu número máximo de elementos, o primeiro elemento será descartado e o novo elemento será adicionado ao final. A seguir, alguns exemplos de código mostrando o comportamento do array no Web SDK:

1
2
3
4
5
6

var abUser = appboy.getUser();
// initialize array for this user, assuming max length of favorite_foods is set to 4.
abUser.setCustomUserAttribute('favorite_foods', ['pizza', 'wings', 'pasta']); // => ['pizza', 'wings', 'pasta']
abUser.addToCustomAttributeArray('favorite_foods', 'fries'); // => ['pizza', 'wings', 'pasta', 'fries']
abUser.addToCustomAttributeArray('favorite_foods', 'pizza'); // => ['wings', 'pasta', 'fries', 'pizza']
abUser.addToCustomAttributeArray('favorite_foods', 'ice cream'); // => ['pasta', 'fries', 'pizza', 'ice cream']

O número padrão e máximo de elementos em um array é 500. Você pode atualizar o número máximo de arrays no dashboard da Braze, em Data Settings > Custom Attributes. Arrays que excedem o número máximo de elementos são truncados para conter o número máximo de elementos.

Nota

Se um atributo personalizado do tipo array aparece no perfil de um usuário, mas não mostra nenhum valor, verifique o Max Length do atributo em Data Settings > Custom Attributes. Um Max Length de 0 impede que valores sejam exibidos no perfil. Para etapas de solução de problemas, consulte Tipos de dados de atributos personalizados.

A tabela a seguir descreve as opções de segmentação disponíveis para atributos do tipo array.

Nota

Usamos expressões regulares compatíveis com Perl (PCRE).

Datas

Atributos de tempo são úteis para armazenar a última vez que uma ação específica foi realizada, permitindo que você ofereça mensagens de reengajamento de conteúdo específico aos seus usuários.

Nota

A última data em que um evento personalizado ou evento de compra ocorreu é registrada automaticamente e não deve ser registrada novamente por meio de um atributo personalizado de tempo.

Filtros de data que usam datas relativas (por exemplo, mais de 1 dia atrás, menos de 2 dias atrás) medem 1 dia como 24 horas. Qualquer campanha que você executar usando esses filtros incluirá todos os usuários em incrementos de 24 horas. Por exemplo, “último uso do app há mais de 1 dia” capturará todos os usuários que “usaram o app pela última vez há mais de 24 horas” a partir do momento exato em que a campanha é executada. O mesmo se aplica a campanhas configuradas com intervalos de datas mais longos — cinco dias a partir da ativação significarão as 120 horas anteriores.

A tabela a seguir descreve as opções de segmentação disponíveis para atributos de tempo.

Números

Atributos numéricos possuem uma grande variedade de casos de uso. Atributos personalizados de números incrementais são úteis para armazenar o número de vezes que uma determinada ação ou evento ocorreu. Números padrão têm todos os tipos de usos, como registrar tamanho de calçado, medida de cintura ou o número de vezes que um usuário visualizou um determinado recurso ou categoria de produto.

Nota

Valores monetários gastos não devem ser registrados por este método. Em vez disso, devem ser registrados por meio dos nossos métodos de compra.

A tabela a seguir descreve as opções de segmentação disponíveis para atributos numéricos.

Booleanos (verdadeiro/falso)

Atributos booleanos são úteis para armazenar status de inscrição e outros dados binários simples sobre seus usuários. As opções de entrada que fornecemos permitem encontrar usuários que tiveram uma variável explicitamente definida como booleana, além daqueles que ainda não possuem nenhum registro desse atributo.

A tabela a seguir descreve as opções de segmentação disponíveis para atributos booleanos.

Eventos de compra / rastreamento de receita

Usar nossos métodos de compra para registrar compras no app estabelece o Valor do Tempo de Vida (LTV) para cada perfil de usuário individual. Esses dados são visualizáveis na nossa página de receita em gráficos de séries temporais.

A tabela a seguir descreve as opções de segmentação disponíveis para eventos de compra.

Nota

Se você deseja segmentar pelo número de vezes que uma compra específica ocorreu, também deve registrar essa compra individualmente como um atributo personalizado de incremento.

Caso de uso de táxi/viagem por aplicativo

Para este exemplo, vamos considerar um app de viagem por aplicativo que deseja decidir quais dados de usuários coletar. As seguintes perguntas e processo de brainstorming são um ótimo modelo para as equipes de marketing e desenvolvimento seguirem. Até o final deste exercício, ambas as equipes devem ter uma compreensão sólida de quais eventos e atributos personalizados fazem sentido coletar para ajudar a alcançar seu objetivo.

Questão do estudo de caso 1: Qual é o objetivo?

O objetivo deles é simples: eles querem que os usuários chamem táxis pelo app.

Questão do estudo de caso 2: Quais são as etapas intermediárias no caminho para esse objetivo a partir da instalação do app?

1. Eles precisam que os usuários comecem o processo de registro e preencham suas informações pessoais.
2. Eles precisam que os usuários concluam e verifiquem o processo de registro inserindo um código no app que recebem via SMS.
3. Eles precisam tentar chamar um táxi.
4. Para chamar um táxi, ele deve estar disponível quando for procurado.

Essas ações poderiam então ser marcadas como os seguintes eventos personalizados:

• Início do registro
• Registro concluído
• Chamadas de táxi bem-sucedidas
• Tentativas de táxi malsucedidas

Depois de implementar os eventos, você pode executar as seguintes campanhas:

1. Envie mensagens para os usuários que começaram o registro, mas não dispararam o evento de registro concluído em um determinado período de tempo.
2. Envie mensagens de parabéns aos usuários que completam o registro.
3. Envie desculpas e crédito promocional aos usuários que tiveram tentativas de chamar táxi malsucedidas que não foram seguidas por uma tentativa bem-sucedida dentro de um determinado período de tempo.
4. Envie promoções para usuários avançados com muitas chamadas de táxi bem-sucedidas para agradecê-los por sua fidelidade.

E muito mais!

Questão do estudo de caso 3: Que outras informações podemos querer saber sobre nossos usuários para orientar nosso envio de mensagens?

• Se eles têm ou não algum crédito promocional?
• A avaliação média que eles dão aos seus motoristas?
• Códigos promocionais únicos para o usuário?

Essas características poderiam então ser marcadas como os seguintes atributos personalizados:

• Saldo de crédito promocional (tipo decimal)
• Classificação média do motorista (tipo numérico)
• Código promocional único (tipo string)

Adicionar esses atributos daria a você a capacidade de enviar campanhas para os usuários, como:

1. Lembrar os usuários que não fizeram login em sete dias, mas que têm um crédito promocional, que seu crédito existe e que eles devem voltar ao app para usá-lo!
2. Enviar mensagens aos usuários que dão baixas avaliações aos motoristas para obter feedback direto dos clientes e entender por que eles não gostaram de suas viagens.
3. Usar nossos recursos de modelo de mensagem e personalização para incluir o atributo de código promocional exclusivo no envio de mensagens direcionadas aos usuários.

Boas práticas

Boas práticas gerais

Use propriedades de eventos

• Nomeie um evento personalizado com algo que descreva uma ação que um usuário realiza.
• Use generosamente as propriedades de eventos personalizados para representar dados importantes sobre um evento.
• Por exemplo, em vez de capturar um evento personalizado separado para cada um dos 50 filmes assistidos, seria mais eficaz simplesmente capturar “assistiu a um filme” como evento e incluir uma propriedade de evento com o nome do filme.

Boas práticas de desenvolvimento

Defina IDs de usuário para cada usuário

Os IDs de usuário devem ser definidos para cada um dos seus usuários. Eles devem ser imutáveis e acessíveis quando um usuário abre o app. Recomendamos fortemente fornecer esse identificador, pois ele permitirá que você:

• Rastreie seus usuários em vários dispositivos e plataformas, melhorando a qualidade dos seus dados comportamentais e demográficos.
• Importe dados sobre seus usuários usando nossa API de dados de usuários.
• Direcione usuários específicos com nossa API de envio de mensagens tanto para mensagens gerais quanto transacionais.

Os IDs de usuário devem ter menos de 512 caracteres e devem ser privados e não facilmente obtidos (por exemplo, não devem ser um endereço de e-mail ou nome de usuário em texto simples). Se esse identificador não estiver disponível, a Braze atribuirá um identificador único aos seus usuários, mas você não terá as capacidades listadas para IDs de usuário. Evite definir IDs de usuário para usuários para os quais você não possui um identificador único vinculado a eles como indivíduos. Passar um identificador de dispositivo não oferece nenhum benefício em comparação com o rastreamento automático de usuários anônimos que a Braze oferece por padrão. Veja a seguir alguns exemplos de IDs de usuário adequados e inadequados.

Boas opções para IDs de usuário:

• Endereço de e-mail com hash ou nome de usuário único
• Identificador único de banco de dados

Estes não devem ser usados como IDs de usuário:

• ID de dispositivo
• Número aleatório ou ID de sessão
• Qualquer ID não único
• Endereço de e-mail
• ID de usuário de outro fornecedor terceirizado

Importante

Para maior segurança, recomendamos adicionar nosso recurso de autenticação do SDK para evitar a simulação de usuários.

Dê nomes legíveis a eventos e atributos personalizados

Imagine que você é um profissional de marketing que começa a usar a Braze um ou dois anos após a implementação. Ler uma lista suspensa cheia de nomes como “usr_no_acct” sem contexto adicional pode ser intimidador. Dar aos seus eventos e atributos nomes identificáveis e legíveis facilitará as coisas para todos os usuários da sua plataforma. Considere as seguintes boas práticas:

• Não comece um evento personalizado com um caractere numérico. A lista suspensa é ordenada alfabeticamente, e começar com um caractere numérico torna mais difícil segmentar pelo filtro de sua escolha.
• Tente não usar abreviações obscuras ou jargão técnico quando possível.
  • Exemplo: usr_ctry pode ser adequado como nome de variável para o país de um usuário dentro de um código, mas o atributo personalizado deve ser enviado à Braze como algo como user_country para dar mais clareza a um profissional de marketing que estiver usando o dashboard futuramente.

Registre atributos apenas quando eles mudarem

Contamos cada atributo enviado à Braze como um ponto de dados, mesmo que o atributo enviado contenha o mesmo valor salvo anteriormente. Registrar dados somente quando eles mudam ajuda a evitar o uso redundante de pontos de dados e oferece uma experiência mais fluida, evitando chamadas de API desnecessárias.

Evite gerar nomes de eventos programaticamente

Se você está constantemente criando novos nomes de eventos, será impossível segmentar seus usuários de forma significativa. De modo geral, você deve capturar eventos genéricos (“Assistiu a um vídeo” ou “Leu um artigo”) em vez de eventos altamente específicos, como (“Assistiu Gangnam Style” ou “Leu artigo: Melhores 10 restaurantes para almoço em Midtown Manhattan”). Os dados específicos sobre o evento devem ser incluídos como uma propriedade de evento, não como parte do nome do evento.

Limitações e restrições técnicas

Tenha em mente as seguintes limitações e restrições ao implementar eventos personalizados:

Restrições de comprimento

A Braze impõe um limite de comprimento em bytes (479 bytes) para nomes de eventos personalizados, nomes de atributos personalizados (chaves) e valores de string de eventos personalizados. Valores que excederem esse limite serão truncados. Quando expresso em caracteres, isso corresponde a aproximadamente 479 caracteres de byte único (por exemplo, ASCII), ou aproximadamente 160 caracteres para scripts multibyte, como japonês (assumindo cerca de 3 bytes por caractere em UTF-8). Idealmente, mantenha nomes e valores o mais curtos possível para melhorar o desempenho de rede e bateria do seu app — se possível, limite-os a 50 caracteres.

Restrições de conteúdo

O seguinte conteúdo será removido programaticamente dos seus atributos e eventos. Tome cuidado para não usar o seguinte:

• Espaços em branco no início e no final
• Quebras de linha
• Todos os não dígitos em números de telefone
  • Exemplo: “(732) 178-1038” será condensado para “7321781038”
• Caracteres que não são espaços em branco devem ser convertidos em espaços
• $ não deve ser usado como prefixo para nenhum evento personalizado
• Quaisquer valores de codificação UTF-8 inválidos
  • “My \x80 Field” será condensado para “My Field”

Chaves reservadas

As seguintes chaves são reservadas e não podem ser usadas como propriedades de eventos personalizados:

• time
• product_id
• quantity
• event_name
• price
• currency

Definições de valores

• Valores inteiros são de 64 bits
• Decimais têm 15 dígitos decimais por padrão

Analisando um campo de nome genérico

Se existir apenas um único campo de nome genérico para um usuário (por exemplo, ‘JohnDoe’), você pode atribuir esse título completo ao atributo de nome do seu usuário. Além disso, você pode tentar separar o nome e o sobrenome do usuário usando espaços, mas esse último método carrega o risco potencial de nomear incorretamente alguns dos seus usuários.