Entrega baseada em ação

Campanhas de entrega baseada em ação ou campanhas disparadas por eventos são muito eficazes para mensagens transacionais ou baseadas em conquistas. Em vez de enviar sua campanha em dias específicos, você pode dispará-las para envio após um usuário concluir um determinado evento.

Configurando uma Campaign disparada

Etapa 1: Selecionar um evento-gatilho

Selecione um evento-gatilho. Os eventos são organizados por categoria e estão disponíveis dependendo do seu espaço de trabalho e dos canais ativados.

• eCommerce
  • Place Order
  • Update Cart
  • Perform Back in Stock Event
  • Perform Price Drop Event
  • Start Checkout
  • View Product
  • Cancel Order
  • Refund Order
  • Make Purchase
• Atividade geral
  • Interact With Campaign
  • Interact With Step
  • Interact with Landing Page
  • Perform Conversion Event
  • Perform Custom Event
  • Perform Exception Event For Campaign
  • Start Session
• Envio de mensagens de entrada
  • Send an SMS inbound message
  • Send a WhatsApp inbound message
  • Send a LINE inbound message
• Localização
  • Enter a Location
  • Trigger a Geofence
• Atualizações de perfil
  • Add an Email Address
  • Change Custom Attribute Value
  • Update Subscription Status
  • Update Subscription Group Status

Start Checkout, View Product, Cancel Order e Refund Order são eventos de eCommerce recomendados que usam Perform Custom Event com o nome do evento preenchido automaticamente.

Place Order e Update Cart aceitam filtros de propriedade, de modo que um gatilho é disparado apenas para os pedidos ou carrinhos desejados. Filtros básicos correspondem a uma propriedade de nível superior, como total_value; filtros aninhados verificam dentro do array products, de forma que products[].metadata.category é correspondido quando qualquer produto se qualifica. Para mais detalhes, consulte Filtros de propriedade.

Campaigns de mensagens no app suportam um conjunto menor de gatilhos: Make Purchase, Place Order, Start Session, Perform Custom Event e Interact With Campaign. Em uma mensagem no app, Place Order se aplica a qualquer pedido e suporta apenas filtros básicos de propriedade. Não é possível direcionar um produto específico ou filtrar por propriedades aninhadas. Para Campaigns de mensagens no app, Interact With Campaign cobre apenas a abertura de uma notificação por push de qualquer Campaign ou de uma Campaign específica. Não inclui a lista de interações de Campaign a seguir.

Para Campaigns que não sejam de mensagens no app, ao selecionar Interact With Campaign, Interact With Step ou Interact with Landing Page, escolha a interação que acionará o disparo. Cada um desses gatilhos oferece suas próprias interações, e as interações disponíveis dependem dos canais ativados.

Você também pode filtrar ainda mais os eventos-gatilho usando propriedades de eventos personalizados da Braze, permitindo propriedades de evento personalizáveis para eventos personalizados e compras no app. Esse recurso permite refinar quais usuários recebem uma mensagem com base nos atributos específicos do evento personalizado, possibilitando maior personalização de Campaigns e coleta de dados mais sofisticada.

Por exemplo, digamos que temos uma Campaign com um evento personalizado de carrinho abandonado que é filtrada pela propriedade “valor do carrinho”. Essa Campaign alcança apenas usuários que deixaram entre US$ 100 e US$ 200 em produtos nos seus carrinhos.

Nota

O evento-gatilho Start Session pode ser a primeira abertura do app pelo usuário se o Segment da sua Campaign se aplicar a novos usuários (por exemplo, se o seu Segment inclui aqueles sem sessões).

Lembre-se de que você ainda pode enviar uma Campaign disparada para um Segment específico de usuários, de modo que os usuários que não fazem parte do Segment não recebem a Campaign mesmo que completem o evento-gatilho.

Em relação ao evento-gatilho para quando um usuário adiciona um endereço de e-mail ao seu perfil, as seguintes regras se aplicam:

• O evento-gatilho é acionado após a atualização do atributo do perfil do usuário. Isso significa que a avaliação dos Segments e filtros da Campaign ocorre após quaisquer atualizações de atributos. Isso é benéfico porque permite configurar filtros como “endereço de e-mail corresponde a gmail.com” para criar uma Campaign disparada que envia apenas para usuários do Gmail e é acionada assim que eles adicionam seu endereço de e-mail.
• O evento-gatilho é acionado quando um endereço de e-mail é adicionado a um perfil de usuário. Se você tiver vários perfis de usuário criados com o mesmo endereço de e-mail, a Campaign pode ser disparada várias vezes, uma vez para cada perfil de usuário.

Além disso, mensagens no app disparadas ainda seguem as regras de entrega de mensagens no app e aparecem no início de uma sessão do app.

Etapa 2: Selecionar a duração da postergação

Selecione quanto tempo esperar antes de enviar a Campaign após os critérios de disparo serem atendidos. Se a duração da postergação escolhida for maior que a duração do envio da mensagem, nenhum usuário receberá a Campaign.

Campaigns de mensagens no app podem postergar a entrega após o evento-gatilho por até duas horas (7.200 segundos). As opções de postergação são Imediatamente e Após uma postergação. Para uma espera mais longa, adicione uma etapa de postergação antes de uma etapa de mensagem no app em um Canvas.

Importante

A Braze usa o timestamp enviado com o evento personalizado para avaliar a postergação de uma Campaign baseada em ação. Se esse timestamp estiver retroativo, a Braze pode tratar a postergação como já decorrida e enviar a mensagem imediatamente ou antes do esperado. Para evitar problemas no horário de entrega, envie o timestamp do evento personalizado com o horário atual.

Além disso, os usuários que completam o evento-gatilho após o lançamento da sua Campaign são os primeiros a receber a mensagem após a postergação ter passado. Usuários que completaram o evento-gatilho antes do lançamento da Campaign não se qualificam para receber a Campaign.

Você também pode enviar a Campaign em um dia específico da semana selecionando No próximo dia da semana, ou um número definido de dias no futuro selecionando Após um número de dias corridos. Como alternativa, você pode enviar sua mensagem usando Intelligent Timing em vez de selecionar manualmente um horário de entrega.

Etapa 3: Selecionar eventos de exceção

Selecione um evento de exceção que desqualifica os usuários de receber esta Campaign. Isso só pode ser feito se sua mensagem disparada for enviada após uma postergação. Eventos de exceção podem ser realizar uma compra, iniciar uma sessão, realizar um dos eventos de conversão designados da Campaign ou realizar um evento personalizado.

Se um usuário completar o evento-gatilho, mas em seguida completar o evento de exceção antes da mensagem ser enviada (devido à postergação), ele não receberá a Campaign. Os usuários que não receberem a Campaign devido ao evento de exceção ficam automaticamente elegíveis para recebê-la no futuro, na próxima vez que completarem o evento-gatilho, mesmo que você não opte por tornar os usuários reelegíveis.

Para saber mais sobre o uso de eventos de exceção, consulte Exemplos.

Se você enviar uma Campaign com um evento-gatilho que corresponda ao evento de exceção, a Braze cancela a Campaign e automaticamente reagenda uma nova Campaign com base no horário de entrega da mensagem do evento de exceção. Por exemplo, se o primeiro evento-gatilho começa em cinco minutos e o evento de exceção começa em 10 minutos, o horário oficial de entrega da mensagem da Campaign será o de 10 minutos do evento de exceção.

Nota

Não é possível usar “início de sessão” como evento-gatilho e evento de exceção ao mesmo tempo para uma Campaign. No entanto, você sempre pode selecionar qualquer outro evento personalizado fora dessa opção.

Etapa 4: Atribuir duração

Atribua a duração da Campaign especificando um horário de início e um horário de término opcional.

Se um usuário completar um evento-gatilho durante o período especificado, mas se qualificar para a mensagem fora desse período devido a uma postergação programada, ele não receberá a Campaign. Portanto, se você definir uma postergação maior que o período da mensagem, nenhum usuário receberá sua Campaign. Além disso, você pode optar por enviar a mensagem no fuso local dos usuários.

Etapa 5: Selecionar o período

Selecione se o usuário recebe a Campaign durante uma parte específica do dia. Se você atribuir um período à mensagem e o usuário completar o evento-gatilho fora desse período, ou se a postergação da mensagem fizer com que ele perca o período, por padrão o usuário não receberá sua mensagem.

No caso em que um usuário completar o evento-gatilho dentro do período, mas a postergação da mensagem fizer com que ele fique fora do período, você pode marcar a caixa de seleção Enviar no próximo horário disponível se o horário de entrega cair fora da parte especificada do dia para que esses usuários ainda recebam a Campaign.

Se um usuário não receber a mensagem porque perdeu o período, ele ainda estará qualificado para recebê-la na próxima vez que completar o evento-gatilho, mesmo que você não tenha optado por tornar os usuários reelegíveis. Se você optar por tornar os usuários reelegíveis, eles poderão receber a Campaign toda vez que completarem o evento-gatilho, desde que se qualifiquem dentro do período especificado.

Se você também atribuiu uma duração específica à Campaign, o usuário precisa se qualificar tanto dentro da duração quanto na parte específica do dia para receber a mensagem.

Etapa 6: Determinar a reelegibilidade

Determine se os usuários podem se tornar reelegíveis para a Campaign. Se você permitir que os usuários se tornem reelegíveis, poderá especificar uma postergação antes que o usuário possa receber a Campaign novamente. Isso evita que suas Campaigns disparadas se tornem “spammy”.

Exemplos

Campaigns disparadas são muito eficazes para mensagens transacionais ou baseadas em conquistas.

Campaigns transacionais incluem mensagens enviadas após o usuário concluir uma compra ou adicionar um item ao carrinho. Este último caso é um ótimo exemplo de Campaign que se beneficia de um evento de exceção. Digamos que sua Campaign lembre os usuários sobre itens no carrinho que eles ainda não compraram. O evento de exceção, nesse caso, é o usuário comprar os produtos do carrinho. Para Campaigns baseadas em conquistas, você pode enviar uma mensagem cinco minutos após o usuário concluir uma conversão ou passar de fase em um jogo.

Além disso, ao criar Campaigns de boas-vindas, você pode disparar mensagens para envio após o usuário se registrar ou configurar uma conta. Escalonar mensagens para serem enviadas em dias diferentes após o registro permite criar um processo de integração completo.

Perguntas frequentes

Qual é a postergação máxima após um disparo para campanhas de mensagem no app?

Duas horas (7.200 segundos). Para ver as opções de postergação disponíveis e como definir uma espera mais longa, consulte Etapa 2: Selecione a duração da postergação.

Por que um usuário não recebeu minha Campaign disparada?

Qualquer uma das situações a seguir impede que um usuário que concluiu o evento-gatilho receba a Campaign:

• O usuário concluiu o evento de exceção antes que a postergação tivesse se esgotado completamente.
• A lógica abort_message do Liquid foi usada e a mensagem foi interrompida com base na lógica ou nas regras de abort_message.
• A postergação fez com que o usuário se tornasse elegível para receber a Campaign após o término da duração.
• A postergação fez com que o usuário se tornasse elegível para receber a Campaign fora da parte especificada do dia.
• O usuário já recebeu a Campaign (incluindo atribuição por meio de identificadores de canal compartilhados — por exemplo, se ele compartilha um e-mail com alguém que recebeu, abriu ou clicou nele), e os usuários não se tornam reelegíveis.
• Embora os usuários sejam reelegíveis para receber a Campaign, eles só podem redispará-la após um determinado período, e esse período ainda não se esgotou.

Segmentar uma Campaign disparada com base em dados de usuário registrados no momento do evento pode causar uma condição de corrida. Isso acontece quando o atributo do usuário no qual a Campaign é segmentada é alterado, mas a alteração ainda não foi processada para o usuário quando a Campaign é enviada. Como as campanhas verificam a associação ao Segment na entrada, isso pode fazer com que o usuário não receba a Campaign.

Por exemplo, imagine que você deseja enviar uma Campaign disparada por evento para usuários do sexo masculino que acabaram de se registrar. Quando o usuário se registra, você grava um evento personalizado registration e define simultaneamente o atributo gender do usuário. O evento pode disparar a Campaign antes que a Braze tenha processado o gênero do usuário, impedindo que ele receba a Campaign.

Como prática recomendada, certifique-se de que o atributo no qual a Campaign é segmentada seja enviado aos servidores da Braze antes do evento. Se isso não for possível, a melhor maneira de garantir a entrega é usar propriedades de eventos personalizados para anexar as propriedades relevantes do usuário ao evento e aplicar um filtro de propriedade para a propriedade específica do evento em vez de um filtro de segmentação. No nosso exemplo, adicione uma propriedade gender ao evento personalizado registration para que a Braze tenha garantidamente os dados necessários quando sua Campaign for disparada.

Além disso, se uma Campaign for baseada em ação e tiver uma postergação, você pode marcar a opção Reavaliar associação ao Segment no momento do envio para garantir que os usuários ainda façam parte do público-alvo quando a mensagem for enviada.

Avaliação dos critérios de público

Para campanhas que envolvem uma postergação antes do envio (incluindo limite de frequência, fuso local, Intelligent Timing ou cronograma de disparo), quando o Segment é reavaliado depende do tipo e das configurações da Campaign.

Em campanhas baseadas em ação com postergação, se você selecionar Reavaliar associação ao Segment no momento do envio, os usuários serão reavaliados antes que a mensagem seja enviada. Assim, somente os usuários que ainda atendem aos critérios do Segment no momento do envio recebem a mensagem.

Se sua Campaign é disparada por um evento personalizado específico e você seleciona um Segment como público, os usuários precisam realizar o mesmo evento personalizado para serem incluídos no Segment. Isso significa que os usuários precisam fazer parte do público antes que uma Campaign baseada em ação possa ser disparada. O fluxo geral de uma Campaign disparada é o seguinte:

1. Entrar no público: Quando um usuário realiza o evento personalizado, ele é adicionado ao público-alvo da Campaign.
2. Disparar o e-mail: O usuário precisa realizar o evento personalizado novamente para disparar o e-mail, pois precisa fazer parte do público antes que o e-mail possa ser enviado.

Recomendamos alterar o público-alvo para incluir todos os usuários ou verificar se os usuários que devem realizar o evento já fazem parte do público da Campaign para que a mensagem seja disparada.

Solução de problemas com eventos personalizados

Primeiro, confirme que o evento personalizado está sendo enviado para a Braze. Acesse Analytics > Custom Events Report e selecione o respectivo evento personalizado e o intervalo de datas. Se o evento não for exibido, confirme se ele está configurado corretamente e se o usuário realizou a ação correta.

Se o evento personalizado for exibido, faça a seguinte investigação adicional:

• Verifique o download do perfil do usuário para confirmar que ele disparou o evento e quando o fez. Se o evento foi disparado, compare o registro de data e hora de quando o evento foi disparado com o momento em que a Campaign entrou no ar. O evento pode ter sido disparado antes da Campaign entrar no ar.
• Revise os changelogs da Campaign e de quaisquer Segments usados no direcionamento para determinar se o usuário estava no Segment quando seu evento personalizado foi disparado. Se ele não estava no Segment, não teria recebido a Campaign.
• Verifique se o usuário foi inserido em um grupo de controle por meio da segmentação e, consequentemente, impedido de receber a Campaign.
• Se houver uma postergação agendada, verifique se o evento personalizado do usuário foi disparado antes da postergação. Se o evento foi disparado antes da postergação, ele não teria recebido a Campaign.

Nota

Mensagens no app só podem ser disparadas por eventos enviados pelo SDK, não pela REST API.

Quando campanhas baseadas em ação avaliam a associação ao público?

A Braze avalia a associação ao público quando processa o evento-gatilho, antes que a mensagem seja enviada. Por padrão, a Braze verifica se o usuário corresponde ao público-alvo no momento do enfileiramento. Se a Campaign tiver uma postergação, você pode selecionar Reavaliar associação ao Segment no momento do envio para verificar os critérios de público novamente imediatamente antes do envio — por exemplo, quando um usuário pode realizar a ação-gatilho e depois sair do público antes que o envio seja concluído.

Para saber mais, consulte Avaliação dos critérios de público.