![Curso do Braze Learning] ( /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 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 critérios de saída para definir quando os usuários devem sair do seu 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é 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 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é 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 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.
Expandir para documentação por plataforma
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.
| Opções de segmentação | Filtro suspenso | Opções de entrada |
|---|---|---|
| Verificar se o evento personalizado ocorreu mais de um número X de vezes | MAIS DO QUE | NÚMERO |
| Verificar se o evento personalizado ocorreu menos de um número X de vezes | MENOS QUE | NÚMERO |
| Verificar se o evento personalizado ocorreu exatamente X vezes | EXATAMENTE | NÚMERO |
| Verificar se o evento personalizado ocorreu pela última vez após a data X | DEPOIS | TIME |
| Verificar se o evento personalizado ocorreu pela última vez antes da data X | ANTES | TIME |
| Verificar se o evento personalizado ocorreu pela última vez há mais de X dias | MAIS DO QUE | NÚMERO DE DIAS ANTES (número positivo) |
| Verificar se o evento personalizado ocorreu pela última vez há menos de X dias | MENOS QUE | NÚMERO DE DIAS ANTES (número positivo) |
| Verificar se o evento personalizado ocorreu mais de X (máx. = 50) vezes | MAIS DO QUE | nos últimos Y dias (Y = 1,3,7,14,21,30) |
| Verificar se o evento personalizado ocorreu menos de X (máx. = 50) vezes | MENOS QUE | nos últimos Y dias (Y = 1,3,7,14,21,30) |
| Verificar se o evento personalizado ocorreu exatamente X (máx. = 50) vezes | EXATAMENTE | nos últimos Y dias (Y = 1,3,7,14,21,30) |
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.
Incremente os atributos personalizados para manter um contador em uma ação do usuário semelhante a um evento personalizado. No entanto, não é possível visualizar dados de atributos personalizados em uma série temporal. As ações do usuário que não precisam ser analisadas em uma série temporal devem ser registradas usando esse método.
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).
Cada evento personalizado ou compra pode ter até 256 propriedades distintas de evento personalizado. Se um evento personalizado ou uma compra for registrado com mais de 256 propriedades, apenas as primeiras 256 serão capturadas e estarão disponíveis para uso.
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:
| Tipo de dados | Descrição |
|---|---|
| Números | Como números inteiros ou flutuantes |
| Booleanos | Valor de true ou false. |
| Datetimes | Formatado como strings no formato ISO-8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ. Não é compatível com matrizes. |
| Strings | 255 caracteres ou menos. |
| Matrizes | As matrizes não podem incluir datas e horários. |
| Objetos aninhados | Objetos que estão dentro de outros objetos. Para saber mais, consulte a seção deste artigo sobre objetos aninhados. |
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 item price para melhorar o público-alvo e permitir maior personalização da campanha.
As propriedades de eventos personalizados aninhados também são compatíveis com a 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 a 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. Neste exemplo, a mensagem é personalizada para três segmentos diferentes usando 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 %}
Se o usuário não tiver uma conexão com a Internet, as mensagens no app disparadas com propriedades de eventos personalizados modelados (por exemplo, {{event_properties.${time_spent}}}) falharão e não serão exibidas.
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.
Adição de propriedades de eventos para segmentação
Você precisará da permissão de usuário “Gerenciar segmentação de propriedades personalizadas de eventos” para criar segmentos com base na recência e na frequência da propriedade do evento.
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:
- Acesse seu evento personalizado e selecione Gerenciar propriedades.
- 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.
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 DaysX Purchase Property in Y Days
Propriedades de entrada da 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.
For in-app message channels specifically, canvas_entry_properties can only be referenced in Canvas.
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.
You can’t use event_properties in the first Message step of your Canvas. Instead, you must use canvas_entry_properties or add an Action Paths step with the corresponding event before the Message step that includes event_properties.
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 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:
- 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.
- 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.
Editar esta página no GitHub