![Curso do Braze Learning] ( /docs/pt-br/assets/img/bl_icon3.png?90e224bc203230fce2ea8b5e0093b685)Eventos personalizados

Este artigo descreve eventos e propriedades personalizados, filtros de segmentação relacionados, propriedades de entrada do Canva, análises de dados relevantes e muito mais. Para saber mais sobre os eventos do Braze em geral, consulte Eventos.

Os eventos personalizados são ações realizadas por seus usuários ou atualizações sobre eles. Quando os eventos personalizados são registrados, eles podem disparar qualquer número e tipo de campanhas de acompanhamento. Em seguida, é possível usar os filtros de segmentação para segmentar os usuários com base na frequência e na frequência com que esses eventos personalizados ocorreram recentemente. Isso faz com que os eventos personalizados sejam mais adequados para o rastreamento de interações de alto valor com o usuário dentro do seu aplicativo.

Casos de uso

Alguns casos de uso comuns de eventos personalizados incluem:

• Acionamento de uma campanha ou Canva com base em um evento personalizado usando a entrega baseada em ação
• Segmentação de usuários por quantas vezes eles realizaram um evento personalizado, quando foi a última vez que o evento ocorreu e similares
• Usar a análise de eventos personalizada do dashboard para visualizar um agregado da frequência com que cada evento ocorreu
• Encontrar análises de dados adicionais usando relatórios de funil e retenção
• Aproveitamento das propriedades de entrada persistente para usar metadados do evento do cliente para personalização nas etapas do Canva
• Geração de análises de dados mais sofisticadas com o Currents
• Configuração de eventos de exceção do Canvas para definir quando os usuários não devem avançar para a próxima etapa do Canva

Gerenciamento de eventos personalizados

Você pode gerenciar, criar ou colocar em lista de bloqueio eventos personalizados no dashboard acessando Configurações de dados > Eventos personalizados.

Selecione o menu ao lado de um evento personalizado para as seguintes ações:

Colocando na lista de bloqueio

Você pode colocar em uma lista de bloqueio eventos personalizados individuais por meio do menu de ações ou selecionar e colocar em uma lista de bloqueio até 10 eventos em massa.

Quando você bloqueia um evento personalizado:

• Os 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 será exibido em filtros ou gráficos.

Além disso, se um evento personalizado bloqueado for atualmente referenciado por filtros ou disparadores em outras áreas do Braze, será exibido um modal de aviso explicando que todas as instâncias dos filtros ou disparadores que o referenciam serão removidas e arquivadas.

Adição de descrições

É possível adicionar uma descrição a um evento personalizado depois que ele for criado se você tiver a permissão de usuário Manage Events, Attributes, Purchases. Selecione Editar descrição para o 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 se tiver a permissão de usuário “Manage Events, Attributes, Purchases” (Gerenciar eventos, atributos e compras). As tags podem então ser usadas para filtrar a lista de eventos.

Visualização de relatórios de uso

O relatório de uso lista todos os canvas, campanhas e segmentos que usam um evento personalizado específico. A lista não inclui os usos do Liquid.

Você pode visualizar até 10 relatórios de utilização ao mesmo tempo, marcando as caixas de seleção de vários eventos personalizados e, em seguida, selecionando Exibir relatório de utilização.

Exportação de dados

Para exportar a lista de eventos personalizados como um arquivo CSV, selecione o botão Exportar tudo na parte superior da página. O arquivo CSV será gerado e um link para baixar será enviado para você por e-mail.

Registro de eventos personalizados

Os eventos personalizados exigem configuração adicional. Consulte a lista abaixo para obter a documentação sobre cada plataforma, onde encontrará informações sobre os métodos usados para registrar eventos personalizados e como adicionar propriedades e quantidades aos seus eventos personalizados.

Armazenamento de eventos personalizados

Todos os dados armazenados no perfil do usuário, inclusive os metadados de eventos personalizados (primeira ou última ocorrência, contagem total e X em Y durante 30 dias), são retidos indefinidamente enquanto cada perfil estiver ativo.

Filtros de segmentação

A tabela a seguir mostra os filtros disponíveis para segmentar usuários por eventos personalizados.

Análise de dados

O Braze nota o número de vezes que os eventos personalizados ocorreram e a última vez que foram realizados por cada usuário para segmentação. Visualize essas análises de dados acessando Analytics > Relatório de eventos personalizados.

Na página Custom Events Report (Relatório de eventos personalizados ) no dashboard, você pode visualizar de forma agregada a frequência com que cada evento personalizado ocorre. As linhas cinzas sobrepostas na série temporal indicam a última vez que uma campanha foi enviada, o que é útil para visualizar como suas campanhas afetaram a atividade do evento personalizado.

Também é possível usar filtros para dividir os eventos personalizados por hora, usuários médios mensais (MAU), segmentos ou fórmulas de KPI.

Por que a análise de dados de eventos personalizados não está sendo exibida

Os segmentos criados com dados de eventos personalizados não podem mostrar dados históricos anteriores à sua criação.

Propriedades de eventos personalizados

As propriedades de eventos personalizados são metadados ou atributos personalizados de eventos que descrevem uma ocorrência específica de um evento. Essas propriedades podem ser usadas para qualificar ainda mais as condições de disparo, aumentar a personalização no envio de mensagens, rastrear conversões e gerar análises mais sofisticadas por meio da exportação de dados brutos.

As propriedades de eventos personalizados não são armazenadas no perfil do Braze e, portanto, não consomem pontos de dados (consulte Pontos de dados para exceções).

Formato esperado

Os valores de propriedade devem ser um objeto em que as chaves são os nomes de propriedade e os valores são os valores de propriedade. Os nomes de propriedades devem ser strings não vazias com 255 caracteres ou menos, sem cifrões à esquerda ($).

Os valores de propriedade podem ser qualquer um dos seguintes tipos de dados:

Os objetos de propriedade de evento que contêm valores de vetor ou objeto podem ter uma carga útil de propriedade de evento de até 100 KB.

É possível alterar o tipo de dados da propriedade do evento personalizado, mas esteja ciente dos impactos da alteração dos tipos de dados após a coleta dos dados.

Uso de propriedades de eventos personalizados

As propriedades de eventos personalizados podem ser usadas para qualificar os disparos de campanhas, rastrear conversões e personalizar o envio de mensagens.

Mensagens de gatilho

Use as propriedades de eventos personalizados para restringir ainda mais seu público para uma determinada campanha ou Canva. Por exemplo, se você tiver um aplicativo de comércio eletrônico e quiser enviar uma mensagem a um usuário quando ele abandonar o carrinho, poderá adicionar uma propriedade de evento personalizado de cart value para melhorar o público-alvo e permitir maior personalização da campanha.

As propriedades de eventos personalizados aninhados também são suportadas na entrega baseada em ação.

Personalização de mensagens

Você também pode usar propriedades de eventos personalizados para personalização no modelo de envio de mensagens. Qualquer campanha que use entrega baseada em ação com um evento de gatilho pode usar propriedades de evento personalizado desse evento para personalização de envio de mensagens.

Por exemplo, se você tiver um app de jogos e quiser enviar uma mensagem aos usuários que concluíram um nível, poderá personalizar ainda mais sua mensagem com uma propriedade para o tempo que os usuários levaram para concluir esse nível. Nesse exemplo, a mensagem é personalizada para três segmentos diferentes usando a lógica condicional. A propriedade do 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 %}
Incredible work, hero! Are you ready to test your skills against other powerful heroes? Visit the Arena for real-time battles with top players from around the globe.
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Great job, hero! Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Well done, hero! Talk to villagers for tips on how to beat levels faster and unlock more rewards.
{% endif %}

Para obter uma lista completa de Liquid tags que farão com que as mensagens no app sejam entregues como mensagens in-app modeladas, consulte Perguntas frequentes.

Considerações sobre os filtros

• Chamadas de API: Ao fazer chamadas de API e usar o filtro “is blank” (está em branco), uma propriedade de evento personalizado é considerada “em branco” se for excluída da chamada. Por exemplo, se você incluísse "event_property": "", seus usuários seriam considerados “não em branco”.
• Inteiros: Ao filtrar uma propriedade de evento personalizado de número e o número for muito grande, não use o filtro “exactly”. Se um número for muito grande, ele poderá ser arredondado em um determinado comprimento, de modo que seu filtro não funcionará como esperado.

Segmentação

Use a segmentação de propriedades de eventos para direcionar os usuários com base em eventos personalizados realizados e nas propriedades associadas a esses eventos. Isso aumenta suas opções de filtragem ao segmentar por compra e eventos personalizados.

As propriedades de eventos personalizados são atualizadas em tempo real para qualquer segmento que as utilize. Você pode gerenciar as propriedades acessando Configurações de dados > Eventos personalizados e selecionando Gerenciar propriedades para o evento personalizado associado. As propriedades de eventos personalizados usadas em determinados filtros de segmento têm um histórico de análise máximo de 30 dias.

Os filtros de segmentação de propriedades de eventos incluem:

• Realizou um evento personalizado com a propriedade A com o valor B, X vezes nos últimos Y dias.
• Fez compras com a propriedade A no valor B, X vezes nos últimos Y dias.
• Adiciona a capacidade de segmentar em 1, 3, 7, 14, 21 e 30 dias.

Os dados só são registrados para uma determinada propriedade de evento depois que ela é ativada pelo gerente de sucesso do cliente, e as propriedades de evento só ficam disponíveis a partir dessa data.

Pontos de dados

Com relação ao uso da inscrição, as propriedades de eventos personalizados ativadas para segmentação com os seguintes filtros são todas contadas como pontos de dados separados, além do ponto de dados contado pelo próprio evento personalizado:

• X Custom Event Property in Y Days
• X Purchase Property in Y Days

Propriedades de entrada da tela e propriedades de evento

É possível usar canvas_entry_properties e event_properties em suas jornadas de usuário do Canva. Consulte as propriedades de entrada do Canva e as propriedades de evento para obter mais informações e exemplos.

• propriedades de entrada da tela
• propriedades do evento

1
2
3
4
5
6
{% if  {{canvas_entry_properties.${product_name}}} == "shoes" %}
  Your order is set to ship soon. While you're waiting, why not step up your shoe care routine with a little upgrade? Check out our selection of shoelaces and premium shoe polish.
{% else %}
  Your order will be on its way shortly. If you missed something, you have until the end of the week to add more items to your cart for the same discounts.
{% endif %}

Objetos aninhados

Você pode usar objetos aninhados (objetos dentro de outro objeto) para enviar dados JSON aninhados como propriedades de eventos e compras personalizados. Esses dados aninhados podem ser usados para modelar informações personalizadas em mensagens, disparar envios de mensagens e segmentar usuários.

Para saber mais, consulte nossa página dedicada a objetos aninhados.

Armazenamento de propriedades de eventos personalizados

As propriedades de eventos personalizados são projetadas para ajudá-lo a aumentar a precisão do direcionamento e fazer com que as mensagens pareçam ainda mais personalizadas. As propriedades de eventos personalizados podem ser armazenadas no Braze a curto e longo prazo.

Você pode segmentar com base nos valores das propriedades do evento de duas maneiras:

1. Dentro de 30 dias: A equipe de suporte da Braze pode ativar a segmentação de propriedades de eventos com base na frequência e na recorrência de valores específicos de propriedades de eventos nos segmentos Braze. Se quiser aproveitar as propriedades do evento dentro dos segmentos, entre em contato com o executivo de contas do Braze ou com o gerente de sucesso do cliente. Essa opção afetará o uso de dados.
   
   
2. Dentro e além de 30 dias: Para cobrir a segmentação de propriedades de eventos de curto e longo prazo, você pode usar extensões de segmento. Esse recurso segmenta os usuários com base em eventos personalizados e propriedades de eventos rastreados nos últimos dois anos. Essa opção não afetará o uso de dados.

Entre em contato com o gerente de sucesso do cliente Braze para obter recomendações sobre a melhor abordagem, dependendo de suas necessidades específicas.