Ações de Journey

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)

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.

Se um usuário já atender a uma condição quando chegar a esta etapa, ele seguirá para essa ramificação imediatamente, sem esperar. As condições são avaliadas em ordem (de cima para baixo / A–Z).

Usando a regra de entrada de Eventos Personalizados, 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)

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:

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"
      }
    }
  ]
}

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.

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.

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

A janela de tempo pode usar o fuso horário do usuário quando os dados de fuso horário estiverem disponíveis. Se um usuário não tiver dados de fuso horário, o fuso horário padrão do aplicativo será usado. 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.

Usando janelas de tempo para envios recorrentes

Combine um nó de janela de tempo com regras de reentrada para enviar mensagens recorrentes em um cronograma (diário, semanal, etc.). Coloque a janela de tempo como o primeiro passo na Journey para que os usuários aguardem o dia e horário corretos antes de receber a mensagem. Ao escolher uma duração de reentrada, defina-a como mais longa do que a duração da janela de tempo, mas menor que o intervalo de envio. Isso evita envios duplicados dentro da mesma janela e garante que os usuários reentrem cedo o suficiente para aproveitar a próxima janela. Exemplo — envio diário:

Janela de tempo: todos os dias, das 10h às 18h (janela de 8 horas)
Reentrada: 12 horas (mais longa que a janela de 8 horas, menor que 24 horas)
Resultado: os usuários reentram ~12 horas após sair, sempre chegam antes que a janela do dia seguinte feche e recebem uma mensagem por dia

Consulte Journeys recorrentes para dias específicos e Posso agendar um envio de mensagem para todos os dias? para exemplos completos.

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:

Primeira ramificação: 33% vs 67%
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

Primeira etapa: Adicione uma tag (por exemplo, onboardingJourney: active)
Use esta tag para criar um segmento para exclusão de outras Journeys
Ú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.

Perguntas frequentes

Posso criar uma ramificação em uma Journey baseada no botão de ação de push clicado?

Não apenas com a ramificação Sim/Não integrada — as condições de comportamento de mensagem detectam apenas “Clicado” ou “Entregue”, não qual botão específico foi clicado. Para ramificar por botão, ouça o evento de clique no seu SDK, leia o Action ID e envie um Evento Personalizado. Em seguida, use uma etapa Wait Until para ramificar com base em qual evento personalizado é acionado primeiro. Consulte Ramificar uma Journey pelo botão de ação clicado para um guia completo com exemplos de código.

Preciso escrever código para usar Eventos Personalizados em uma Journey?

Sim. Os Eventos Personalizados são enviados ao OneSignal pelo seu app ou website usando o SDK, ou do seu backend usando a REST API. Não há uma forma exclusivamente pelo painel de controle de disparar Eventos Personalizados. Uma vez que os eventos estejam fluindo para o OneSignal, você pode usá-los em Journeys e Segmentos pelo painel sem código adicional.

Primeiros passos & configurações

Canais de mensagem

Jornadas

Público & eventos personalizados

Análises & Integrações