Propriedades de eventos personalizados

Este artigo descreve as propriedades de eventos personalizados, o formato esperado, como usá-las para envio de mensagens e segmentação, e o armazenamento de 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 gatilho, aumentar a personalização no envio de mensagens, rastrear conversões e gerar análises de dados mais sofisticadas por meio da exportação de dados brutos.

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

Formato esperado

Os valores das propriedades devem ser um objeto: as chaves são os nomes das propriedades (strings não vazias, com 255 caracteres ou menos, sem $ no início), e os valores são os valores das propriedades. Para tipos de dados compatíveis, requisitos de formato e limites de carga útil, consulte Tipos de dados.

Você pode alterar o tipo de dados da propriedade do seu evento personalizado, mas esteja ciente dos impactos de alterar tipos de dados após os dados terem sido coletados.

Chaves reservadas

Você não pode usar chaves reservadas como nomes de propriedades de eventos. Usar uma chave reservada no objeto properties retorna o erro “Invalid ‘properties’ field”.

Usando propriedades de eventos personalizados

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

Disparar mensagens

Use propriedades de eventos personalizados para refinar ainda mais o público de uma campanha ou Canvas específico. Por exemplo, se você tem um aplicativo de e-commerce e deseja enviar uma mensagem a um usuário quando ele abandona o carrinho, pode adicionar uma propriedade de evento personalizado de price para melhorar o público-alvo e permitir maior personalização da campanha.

Propriedades de eventos personalizados aninhadas também são compatíveis com a entrega baseada em ação.

Personalizar mensagens

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

Por exemplo, se você tem um app de jogos e deseja enviar uma mensagem a usuários que completaram uma fase, pode personalizar ainda mais sua mensagem com uma propriedade para o tempo que os usuários levaram para completar essa 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 %}
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 uma lista completa de Liquid tags que fazem com que mensagens no app sejam entregues como mensagens no app modeladas, consulte as Perguntas frequentes.

Considerações com filtros

• Chamadas de API: Ao fazer chamadas de API e usar o filtro “está em branco”, uma propriedade de evento personalizado é considerada “em branco” se for excluída da chamada. Por exemplo, se você incluir "event_property": "", seus usuários serão considerados “não em branco”.
• Números inteiros: Ao filtrar por uma propriedade de evento personalizado numérica e o número for muito grande, não use o filtro “exatamente”. Se um número for muito grande, ele pode ser arredondado em um determinado comprimento, e seu filtro não funcionará como esperado.

Segmentação

Use a segmentação por propriedades de eventos para direcionar 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 compras e eventos personalizados.

As propriedades de eventos para eventos personalizados são atualizadas em tempo real para qualquer segmento que as utilize. Você pode gerenciar 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 máximo de retrospectiva de 30 dias.

Adicionando propriedades de eventos para segmentação

Você precisa da permissão de usuário “Edit Custom Event Property Segmentation” para criar segmentos com base na recência e frequência de 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 na Braze para aumentar esse limite.

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

1. Acesse seu evento personalizado e selecione Gerenciar propriedades.
2. Ative o botão Ativar segmentação para adicionar a propriedade de evento para segmentação. Você terá acesso a opções adicionais de filtragem ao segmentar.

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

• Realizou um evento personalizado com propriedade A com valor B, X vezes nos últimos Y dias.
• Fez qualquer compra com propriedade A com valor B, X vezes nos últimos Y dias.
• Adiciona a capacidade de segmentar dentro de 1 a 30 dias.

Os dados são registrados apenas para uma determinada propriedade de evento após você ativá-la, e as propriedades de eventos ficam disponíveis apenas a partir dessa data em diante.

Pontos de dados

Em relação ao uso de 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 do Canvas e propriedades de eventos

Você pode usar as propriedades de entrada do Canvas e as propriedades de evento nas jornadas de usuário do Canvas.

• canvas entry properties
• event properties

1
2
3
4
5
6
{% if  {{context.${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 %}

Consulte as propriedades de entrada do Canva e as propriedades de evento para obter mais informações e exemplos.

Objetos aninhados

Você pode usar objetos aninhados (objetos dentro de outro objeto) para enviar dados JSON aninhados como propriedades de eventos personalizados e compras. 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 sobre Objetos aninhados.

Armazenamento de propriedades de eventos personalizados

As propriedades de eventos personalizados são projetadas para ajudar você a aumentar a precisão do direcionamento e tornar as mensagens ainda mais personalizadas. As propriedades de eventos personalizados podem ser armazenadas na Braze tanto a curto quanto a longo prazo.

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

1. Dentro de 30 dias: Você pode usar a segmentação por propriedades de eventos com base na frequência e recência de valores específicos de propriedades de eventos dentro dos segmentos da Braze. Essa opção impacta o uso de dados.
   
   
2. Dentro e além de 30 dias: Para cobrir tanto a segmentação de propriedades de eventos de curto quanto de longo prazo, você pode usar Extensões de segmento. Esse recurso segmenta usuários com base em eventos personalizados e propriedades de eventos rastreados nos últimos dois anos. Essa opção não impacta o uso de dados.

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