Skip to content

![Curso de aprendizado do Braze](/docs/pt-br/assets/img/bl_icon3.png?5f6465f63e399dec15d7020b6f4d2452) Eventos personalizados

Este artigo descreve eventos e propriedades personalizados, filtros de segmentação relacionados, propriedades de entrada do Canvas, análises 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 eventos personalizados são registrados, eles podem acionar qualquer número e tipo de campanhas de acompanhamento. Em seguida, é possível usar 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 rastrear interações de usuário de alto valor dentro do seu aplicativo.

Casos de uso

Alguns casos de uso comuns de eventos personalizados incluem:

  • Acionamento de uma campanha ou Canvas com base em um evento personalizado usando a entrega baseada em ação
  • Segmentar os usuários de acordo com o número de vezes que eles realizaram um evento personalizado, quando foi a última vez que o evento ocorreu e similares
  • Usar a análise de eventos personalizada do painel para visualizar um agregado da frequência com que cada evento ocorreu
  • Encontrar análises adicionais usando relatórios de funil e retenção
  • Aproveitamento de propriedades de entrada persistentes para usar metadados do evento do cliente para personalização nas etapas do Canvas
  • Geração de análises mais sofisticadas com o Currents
  • Configuração de critérios de saída para definir quando os usuários devem sair do Canvas

Gerenciamento de eventos personalizados

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

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

Lista de bloqueio

Você pode colocar na lista de bloqueio eventos personalizados individuais por meio do menu de ações ou selecionar e colocar na lista de bloqueio até 100 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 acionadores em outras áreas do Braze, será exibido um modal de aviso explicando que todas as instâncias dos filtros ou acionadores que o referenciam serão removidas e arquivadas.

Adição de descrições

Você pode adicionar uma descrição a um evento personalizado depois que ele for criado se tiver a permissão de usuário Manage Events, Attributes, Purchases. Selecione Edit description (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 Canvases, campanhas e segmentos que usam um evento personalizado específico. A lista não inclui os usos do Liquid.

Você pode visualizar até 100 relatórios de utilização ao mesmo tempo, marcando as caixas de seleção de vários eventos personalizados e 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 download será enviado a você por e-mail.

Registro de eventos personalizados

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

Expand for documentation by platform

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 em 30 dias), são mantidos 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álises

O Braze registra 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 acessando Analytics > Relatório de eventos personalizados.

Na página Custom Events Report (Relatório de eventos personalizados ) no painel, 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 de eventos personalizados.

Gráfico de contagem de eventos personalizados na página Eventos personalizados no painel, mostrando as tendências de um evento personalizado](/docs/pt-br/assets/img_archive/custom_event_analytics_example.png?345ada8684baf98a23ceb1a80341f24b “custom_event_analytics_example.png”)

Você também pode usar filtros para dividir seus eventos personalizados por hora, usuários médios mensais (MAU), segmentos ou fórmulas de KPI.

!Filtros personalizados de gráficos de eventos

Por que a análise 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 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 acionamento, aumentar a personalização das 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 registram 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 cadeias de caracteres não vazias com menos ou igual a 255 caracteres, sem sinais de dólar à 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 matriz ou objeto podem ter uma carga útil de propriedade de evento de até 100 KB.

Você pode alterar o tipo de dados de sua propriedade de 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 acionadores de campanha, rastrear conversões e personalizar as mensagens.

Mensagens de acionamento

Use propriedades de eventos personalizados para restringir ainda mais seu público-alvo para uma determinada campanha ou Canvas. 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 personalizada de item price para melhorar seu público-alvo e permitir uma maior personalização da campanha.

Filtros de propriedade de evento personalizados para um cartão abandonado. Dois filtros são combinados com um operador AND para enviar essa campanha aos usuários que abandonaram o cartão com um preço de item entre 100 e 200 dólares](/docs/pt-br/assets/img_archive/customEventProperties.png?ea43a1d707eeb105300cf9be90e5934c “customEventProperties.png”)

As propriedades aninhadas de eventos personalizados também são compatíveis com o fornecimento baseado em ações.

Filtros de propriedade de evento personalizados para um cartão abandonado. Um filtro é selecionado se algum item do carrinho tiver um preço superior a 100 dólares.](/docs/pt-br/assets/img_archive/customEventPropertiesNested.png?bc1654df91b2b3ade45a725b2e5a38d2 “customEventPropertiesNested.png”)

Personalizar mensagens

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

Por exemplo, se você tiver um aplicativo de jogos e quiser enviar uma mensagem para os 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. Neste exemplo, a mensagem é personalizada para três segmentos diferentes usando a 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 %}
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 tags Liquid que farão com que as mensagens in-app sejam entregues como mensagens in-app com modelo, 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 personalizada 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 do evento para 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.

Adição de propriedades de eventos para segmentação

Você precisará das permissões de usuário “Manage Custom Event Property Segmentation” (Gerenciar segmentação personalizada de propriedades de eventos) para criar segmentos com base na recência e na frequência das propriedades de eventos.

Por padrão, você pode ter 20 propriedades de eventos segmentáveis por espaço de trabalho. Entre em contato com o gerente da sua conta Braze para aumentar esse limite.

Para adicionar propriedades de eventos para segmentação, faça o seguinte:

  1. Vá para seu evento personalizado e selecione Gerenciar propriedades.
  2. Selecione o botão de alternância Ativar segmentação para adicionar a propriedade de evento para segmentação. Você pode acessar opções adicionais de filtragem ao segmentar.

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 dentro de 1 a 30 dias.

Um grupo de filtros que tem “Carrinho abandonado” com a propriedade “número de vezes” e valor 2 mais de uma vez nos últimos 30 dias do calendário.](/docs/pt-br/assets/img/nested_object3.png?e737f9afc6c05f1115860d67c189e868)

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 assinatura, 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 de tela e propriedades de evento

You can use Canvas entry properties and event properties in your Canvas user journeys.

Canvas entry properties are the properties you map for Canvases that are action-based or API-triggered. Note that the canvas_entry_properties object has a maximum size limit of 50 KB.

You can reference canvas_entry_properties in any Message step with this Liquid format: canvas_entry_properties.${property_name}. Note that the events must be custom events or purchase events to be used this way.

Use case

Let’s say a retail store, RetailApp, has the following request: \"canvas_entry_properties\" : {\"product_name\" : \"shoes\", \"product_price\" : 79.99}.

RetailApp can pull the product name (shoes) into a message with this Liquid: {{canvas_entry_properties.${product_name}}}.

RetailApp can also trigger specific messages to send for different product_name properties in a Canvas that targets users after they’ve triggered a purchase event. For example, they can send different messages to users who purchased shoes and users who purchased something else by adding the following Liquid into a Message step.

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 %}
Expand for original Canvas editor

You can no longer create or duplicate Canvases using the original editor. This section is available for reference only. For the Canvases built with the original editor, Canvas entry properties can be referenced in the first full step of a Canvas only.

Event properties refer to the properties you set for custom events and purchases. These event_properties can be used in campaigns with action-based delivery and Canvases.

In Canvas, custom event and purchase event properties can be used in Liquid in any Message step that follows an Action Paths step. Make sure to use {{event_properties.${property_name}}} if you’re referencing these event properties. These events must be custom events or purchase events to be used this way in the Message component.

In the first Message step following an Action Path, you can use event properties related to the event referenced in that Action Path. However, these event properties can only be used if the user actually performed the action (and didn’t get sorted into the Everyone Else group). You can have other steps (that are not another Action Paths or Message step) in between this Action Paths and the Message step.

Expand for original Canvas editor

You can no longer create or duplicate Canvases using the original editor. This section is available for reference only. For the original Canvas editor, event properties can’t be used in scheduled full steps. However, you can use event properties in the first full step of an action-based Canvas, even if the full step is scheduled.

Refer to Canvas entry properties and event properties for more information and examples.

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 criar modelos de informações personalizadas em mensagens, acionar 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 da segmentação e tornar as mensagens 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 habilitar 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 da Braze. Se quiser aproveitar as propriedades do evento dentro dos segmentos, entre em contato com o executivo da sua conta 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 abranger a segmentação de propriedades de eventos de curto e longo prazo, você pode usar as 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.
Github   Editar esta página no GitHub
New Stuff!