Pular para o conteúdo principal
Use Ações de Journey para controlar como e quando os usuários avançam pela sua Journey, personalizar experiências e testar resultados.

​
Esperar (Wait)

Atrasa o progresso da Journey do usuário por um período específico de tempo—minutos, horas, dias ou semanas. Use para:
  • Espaçar mensagens e etapas
  • Permitir tempo para os usuários interagirem com uma mensagem antes de ramificar

​
Esperar até (Wait until)

Retém um usuário nesta etapa até que ele atenda condições específicas:
  • Entrar em um segmento
  • Acionar um evento de mensagem (por exemplo, mensagem específica entregue, aberta ou clicada)
    • Apenas um evento de mensagem por etapa de esperar até é suportado neste momento.
  • Acionar um evento personalizado (por exemplo, integração concluída, compra realizada) - BETA
Você pode adicionar múltiplas condições e ramificar usuários com base na primeira condição que eles atenderem. Se essas condições não forem atendidas em um determinado período de tempo, você pode definir uma ramificação de expiração para continuar usuários pela Journey ou sair completamente. Usando a regra de entrada de Eventos Personalizados (BETA), você também pode adicionar Correspondência de Eventos para controlar qual instância do usuário progredirá pela Journey se você os inserir várias vezes.
Quando um evento personalizado corresponde a uma condição, esse evento é armazenado em nome do usuário e pode ser referenciado na sintaxe Liquid ao enviar mensagens de Journey.

​
Correspondência de Eventos (Event Matching)

A Ação Wait Until com Eventos Personalizados está atualmente em beta. Para solicitar acesso, entre em contato com [email protected] com:
  • Nome da sua empresa
  • Seu OneSignal Organization ID
  • Os OneSignal App ID(s) onde você gostaria de acesso
Usando a regra de entrada de Eventos Personalizados, você pode fazer com que usuários entrem em uma Journey várias vezes. Com a configuração de Correspondência de Eventos da etapa Wait Until, você pode controlar qual instância do usuário progredirá pela Journey. Requisitos:
  • Defina as Regras de Entrada da Journey para usar um evento personalizado.
  • Inclua uma propriedade de evento ao inserir usuários na Journey.
Por exemplo, você tem uma Journey “Lembrete de Pesquisa”. Você tem várias pesquisas, o que significa que os usuários podem entrar na Journey várias vezes (uma vez para cada pesquisa). Você deseja enviar uma mensagem de lembrete se eles não concluírem a pesquisa ou removê-los se concluírem. Você pode usar a configuração de Correspondência de Eventos para controlar qual instância do usuário progredirá pela Journey. Exemplo:
1

Defina as Regras de Entrada da Journey e propriedades de evento personalizado

Defina as Regras de Entrada da Journey para usar um evento personalizado. Exemplo: survey_start
Os usuários entrarão na Journey através da API de Evento Personalizado.O evento personalizado terá o name definido como survey_start e uma propriedade payload survey_id com o valor da pesquisa que estão realizando (por exemplo, survey_1).
Exemplo de Evento de Gatilho de Entrada
{
  "events": [
    {
      "external_id": "UserA",
      "name": "survey_start",
      "properties": {
          "survey_id": "survey_1"
      }
    }
  ]
}
2

Crie uma etapa Wait Until e propriedades de evento personalizado

Defina a condição Wait Until para usar um evento personalizado. Exemplo: survey_completeDefina a opção Correspondência de Eventos para especificar qual instância do usuário progredirá pela etapa Wait Until, correspondendo:
  • Trigger Event Property: definida no evento de gatilho de entrada da Journey (por exemplo, survey_id)
  • Wait Event Property: definida no evento Wait Until (por exemplo, survey_type)
Exemplo de Evento Wait Until
{
  "events": [
    {
      "external_id": "UserA",
      "name": "survey_complete",
      "properties": {
          "survey_type": "survey_1"
      }
    }
  ]
}
Quando o valor de survey_id corresponde ao valor de survey_type, essa instância do usuário progredirá pela Journey.
Você pode usar as mesmas propriedades (por exemplo, survey_id) tanto na Trigger Event Property quanto na Wait Event Property. O exemplo usa propriedades diferentes (por exemplo, survey_id e survey_type) para demonstrar o conceito.As propriedades são sensíveis a maiúsculas e minúsculas! survey_1 não é igual a Survey_1.
Ramificação de expiração:Se o evento Wait Until não ocorrer dentro do tempo de expiração, o usuário progredirá pela Journey. Este exemplo dá ao usuário 1 semana para concluir a pesquisa.
3

Adicione uma etapa de mensagem

Para completar o exemplo, adicione uma etapa de mensagem dentro da ramificação de Expiração para enviar o lembrete.
4

Teste!

Após seguir as etapas acima, você pode testar:
  • Substitua o external_id na API de Evento Personalizado com seu external ID
  • Acione o evento survey_start com um survey_id de survey_1
    • Você verá seu usuário entrar na Journey e fluir para a etapa Wait Until
Eventos não são imediatos, mas muito rápidos! Pode ser necessário aguardar alguns minutos antes que o evento seja processado.Verifique a lista de Eventos Personalizados para ver se o evento foi processado.
  • Acione outro evento survey_start com um survey_id de survey_2
    • Você verá 2 usuários entrarem na Journey e na etapa Wait Until
  • Acione o evento survey_complete com um survey_type de survey_1
    • Você verá seu usuário progredir pela Journey
  • Acione outro evento survey_complete com um survey_type de survey_2
    • Você verá ambas as instâncias do seu usuário progredirem pela Journey e saírem
Você concluiu o exemplo de evento personalizado da Journey com Correspondência de Eventos!

​
Janela de Tempo (Time Window)

Restringe quando os usuários podem avançar para a próxima etapa na Journey com base em dias e horários específicos. Exemplo: Permitir apenas que os usuários recebam uma mensagem nos fins de semana à noite.

​
Como funciona o comportamento da janela de tempo

Se um usuário entrar neste nó fora do horário permitido:
  • O OneSignal define um temporizador para atrasar o usuário até a próxima janela disponível
  • O horário de entrada na janela é randomizado
Exemplo: Se sua janela de tempo for às terças-feiras das 13:00 às 18:00 PST, e um usuário atingir o nó na segunda-feira, ele poderá continuar na terça-feira em um horário aleatório como 17:45.

​
Ramificação Sim/Não (Yes/No branch)

Ramifica usuários com base em associação de segmento ou comportamento de mensagem.

​
Associação de segmento

Cria ramificações com base em qual segmento um usuário está. Exemplo: Se os usuários forem marcados por tipo de plano:
  • Ramificação “Gratuito” = promover upgrade
  • Ramificação “Pago” = destacar recursos premium

​
Comportamento de mensagem

Ramifica com base na interação com mensagens anteriores na Journey:
  • Push: Clicado, Entregue
  • Email: Clicado, Aberto, Entregue
Nota: Safari não suporta Entrega Confirmada.

​
Ramificação Dividida (Split Branch)

Distribui aleatoriamente os usuários por diferentes caminhos para testar mensagens, canais ou fluxos de Journey.
Uma vez que uma Journey esteja ativa, você não pode editar uma Ramificação Dividida. Para alterar o número de ramificações, crie uma nova Journey.

​
Como funciona

  • Até 20 ramificações
  • Defina divisões iguais ou percentuais personalizadas
  • As porcentagens são arredondadas para números inteiros (por exemplo, divisão em 3 vias se torna 34/33/33)
  • A distribuição pode variar ligeiramente com tamanhos de amostra pequenos
Por padrão, os usuários são re-randomizados cada vez que re-entram em uma Journey. Para mantê-los na mesma ramificação, desative Randomizar ao re-entrar. Use a ação Tag User para rastrear qual ramificação um usuário seguiu.

​
Testes A/B/N

Use Ramificações Divididas aninhadas para testar mais de duas variantes simultaneamente. Exemplo: Para dividir usuários igualmente em 3 variantes:
  1. Primeira ramificação: 33% vs 67%
  2. Sob a ramificação de 67%, adicione outra Ramificação Dividida 50/50
Isso dá ~33% em cada caminho.

​
Grupos de Controle

Teste o impacto das mensagens deixando uma ramificação vazia (sem nós de mensagem). Isso permite comparar com usuários que não recebem nenhuma mensagem.

​
Escolhendo um vencedor

Uma vez identificada uma variante vencedora, atualize a ramificação para enviar 100% do tráfego por esse caminho. Para continuar medindo o impacto ao longo do tempo, considere manter um pequeno grupo de retenção—uma porcentagem de usuários que não recebem a mensagem vencedora.

​
Marcar Usuário (Tag User)

Use esta ação para aplicar ou remover tags durante uma Journey. Casos de uso comuns:
  • Rastrear o progresso da Journey (por exemplo, journeyStep: welcome)
  • Potencializar mensagens no aplicativo marcando usuários em momentos-chave
  • Excluir usuários de outras Journeys usando tags ativas

​
Exemplo: controle de fluxo de onboarding

  1. Primeira etapa: Adicione uma tag (por exemplo, onboardingJourney: active)
  2. Use esta tag para criar um segmento para exclusão de outras Journeys
  3. Última etapa: Remova a tag definindo o valor como vazio

​
Melhor prática: Usando tags com webhooks ou personalização

Quando você adiciona ou remove tags em uma Journey, pode levar um curto período de tempo antes que essas alterações estejam prontas para uso na próxima etapa. Para garantir que tudo funcione sem problemas:
  • Para Webhooks: Adicione uma breve espera após definir uma tag antes de enviar dados com um webhook.
  • Para Personalização: Adicione uma breve espera após definir ou remover uma tag antes de usá-la em um email para personalizar o conteúdo.
Recomendamos adicionar um nó Wait de 15 minutos entre a ação Tag e a próxima etapa. Isso garante que a tag esteja totalmente pronta, para que seu webhook ou email sempre inclua os dados corretos.