Configurações do Journey

As Configurações do seu Journey definem como os usuários interagem com seu Journey.

​

Nomear e descrever seu Journey

Ao clicar em Criar Journey, um modal aparece (apenas uma vez por novo Journey) solicitando que você:

• Insira um Nome do Journey (obrigatório)
• Insira uma Descrição (opcional)

Regras de validação: nome obrigatório, comprimento máximo do nome: 300 caracteres, comprimento máximo da descrição: 255 caracteres. Clique em Continuar para salvar o Journey e abrir o painel de Configurações. Se clicar em Cancelar, o Journey será criado usando o nome padrão gerado automaticamente (por exemplo, New Journey 2026-02-18) com uma descrição vazia.

​

Editar nome e descrição

Após a criação, o Nome do Journey e a Descrição aparecem no topo da página e podem ser editados inline. O campo de descrição suporta texto multilinha. Comece dando ao seu Journey um nome e descrição que comunique claramente seu propósito à sua equipe. Exemplos comuns incluem:

• Carrinho Abandonado
• Campanha de Boas-vindas
• Contato com Usuário Inativo

Goals (Alpha)

Defina métricas de sucesso para Journeys e etapas de mensagem suportadas para medir o desempenho ao longo do tempo.

Recurso Alpha: Journey e Message Goals estão atualmente em alpha. Para fazer parte do programa alpha, entre em contato com support@onesignal.com.

Os Goals ajudam você a medir se o seu Journey ou uma mensagem específica dentro dele está funcionando da maneira que você espera.Um goal é um limite de métrica como “mais de 1 usuário entrou no Journey” ou “CTR é maior que 20%” — que o OneSignal avalia continuamente enquanto seu Journey está em execução.Você pode configurar goals em dois lugares:

• Journey Goal (desempenho geral do Journey)
• Message Goal (para etapas de ação de mensagem individuais que suportam goals)

Os Goals não são suportados atualmente para etapas de ação do Journey.

​

Journey Goal

Um Journey Goal rastreia uma única métrica de sucesso para o Journey inteiro, por exemplo, se os usuários estão entrando, saindo ou completando-o.

Para definir um Journey Goal:

1. Abra seu Journey e clique em Settings.
2. Selecione Goals.
3. Ative Set a Journey Goal.
4. Insira um Name (obrigatório) e uma Description opcional.
5. Escolha uma Metric e condição, depois defina o limite de Value.
6. Clique em Save.

Uma vez configurado, seu Journey Goal aparece no topo do relatório do Journey com seu valor atual.

​

Métricas do Journey Goal

Os Journey Goals suportam métricas de engajamento no nível do Journey, como:

• Entered Journey (usuários que iniciaram o Journey)
• Completed (usuários que chegaram ao final)
• Exited Early (usuários que saíram devido às regras de saída)

Use Journey Goals quando você quiser uma verificação rápida de saúde como:

• “Pelo menos 100 usuários entraram neste Journey?”
• “A maioria dos usuários está completando?”
• “Muitos usuários estão saindo cedo?”

---

​

Message Goals (Push + outras etapas de mensagem suportadas)

As etapas de mensagem suportam seu próprio Message Goal, que mede o desempenho para aquela mensagem específica. Por exemplo, uma etapa de Push Notification pode rastrear CTR, confirmações ou cliques.

Para definir um Message Goal:

1. Clique na etapa de ação de mensagem no seu Journey (por exemplo, Push Notification).
2. No editor, ative Set a Push Goal (ou alternância de goal equivalente).
3. Insira um Name e uma Description opcional.
4. Selecione uma Metric, condição e Value.
5. Clique em Save.

Quando a mensagem é enviada, o goal aparece no relatório no nível da mensagem para que você possa monitorar se aquela mensagem está atingindo seu benchmark.

​

Métricas do Message Goal (Push)

Os Push goals suportam métricas de entrega e engajamento, como:

• Sent
• Delivered
• Confirmed
• Clicked
• CTR
• Failed
• Unsubscribed
• Capped

Algumas métricas podem permitir que você rastreie:

• Rate (baseado em porcentagem), como CTR
• Count (número total), como cliques

​

Regras de entrada

As regras de entrada definem como os usuários podem entrar no seu Journey com base em sua associação de segmento ou eventos personalizados.

• Você não pode usar Segmentos e Eventos Personalizados ao mesmo tempo para regras de entrada do Journey. No entanto, você pode usar Eventos Personalizados para continuar os usuários através de um Journey através do passo Aguardar até.
• Uma vez que um Journey está ativo, você não pode alterar as regras de entrada de Segmentos para Eventos Personalizados e vice-versa. Você precisará parar e arquivar o Journey, duplicá-lo e iniciar um novo Journey.

​

Segmento de público

Use Incluir Segmento e Excluir Segmento para controlar quem se qualifica para seu Journey. As verificações de segmento são feitas no nível de Assinatura e consideram todas as Assinaturas de um usuário. Se um usuário está qualificado para entrar no Journey mas também se encaixa nas Regras de Saída, ele entrará no primeiro passo do Journey antes de sair. Se um Journey estiver ativo, os segmentos usados em suas regras de entrada não podem ser editados. Para modificá-los, arquive o Journey ou remova o segmento das regras de entrada primeiro.

​

Como funciona a lógica de inclusão e exclusão

• ✅ Se qualquer Assinatura estiver em um Segmento(s) Incluído(s) → o usuário entra no Journey.
• ❌ Se qualquer Assinatura estiver em um Segmento(s) Excluído(s) → o usuário é bloqueado completamente.

​

Apenas adições futuras

Os segmentos são dinâmicos e têm usuários entrando e saindo constantemente. Marcar esta opção significa que qualquer usuário atualmente no segmento incluído ou excluído no momento em que o Journey for ativado nunca entrará no Journey. Mesmo que o usuário saia do segmento e entre novamente, ele nunca entrará no Journey. Isso é ideal para campanhas de integração únicas onde os usuários não devem reentrar após completar o Journey uma vez.

​

Eventos personalizados

Defina quais usuários específicos devem entrar no Journey com base em Eventos Personalizados. Os usuários que satisfazem os requisitos da regra de entrada podem ser adicionados ao Journey mais de uma vez ao mesmo tempo. Quando um nome de Evento Personalizado e propriedades opcionais correspondem às regras de entrada, o usuário entra no Journey e esse evento é armazenado. O evento armazenado pode ser referenciado na Sintaxe Liquid e usado para Correspondência de Eventos. Se você adicionar o usuário ao Journey várias vezes, cada entrada pode ter propriedades únicas com base nos dados que você passa na carga do Evento Personalizado.

• Nome do Evento Personalizado: Insira o Nome do Evento que você planeja enviar via API.
• Filtrar por propriedade: Adicione quaisquer propriedades adicionais que você gostaria de referenciar para filtrar quem entra no Journey.

Os eventos personalizados também podem ser usados para:

• Regras de saída
• Passos Aguardar Até
• Personalização

---

​

Regras de saída

As regras de saída definem quando os usuários saem automaticamente do Journey. Eles podem reentrar mais tarde com base nas suas configurações de reentrada.

​

Sair quando o usuário se torna ativo no seu aplicativo/site

Assim que o usuário retorna ao seu aplicativo ou site com o SDK OneSignal, sua “última sessão” é atualizada tornando-o ativo novamente. Portanto, eles saem do Journey. Útil para Journeys de reengajamento ou reativação.

​

Sair quando ocorre uma condição de evento personalizado

Envie um Evento Personalizado para fazer o usuário sair do Journey imediatamente.

​

Sair quando o usuário não corresponder mais às condições do público

Remova automaticamente os usuários se eles pararem de corresponder aos segmentos de público da regra de entrada original.

​

Sair quando um usuário entra em um segmento

Se um usuário entrar em um segmento selecionado a qualquer momento, ele é removido do Journey e para de receber mensagens.

​

Marcar usuários quando eles saem cedo

Aplique ou remova uma tag quando os usuários saírem cedo.

• Deixe o valor em branco para remover uma tag existente.
• Se o aplicativo está no limite de tags, nenhuma tag será aplicada.

Casos de uso comuns:

• Acionar outro Journey: Marque os usuários (por exemplo, exited-journey-1:true), depois use essa tag para definir um segmento para seu próximo Journey.
• Limitar Journeys simultâneos: Marque os usuários quando eles entrarem (in-journey:true) e remova a tag quando eles terminarem ou saírem. Isso permite que você os exclua de outros Journeys usando essa tag.

---

​

Regras de reentrada

As regras de reentrada determinam se —e quando— os usuários podem entrar no Journey novamente após sair. As regras de reentrada só podem ser configuradas para Journeys com regras de entrada de Segmento de Público porque a reentrada é sempre suportada para regras de entrada de Evento Personalizado. Use isso para campanhas recorrentes, por exemplo, abandono de carrinho, campanhas baseadas em inatividade, etc.

---

​

Agendamento

Defina quando o Journey deve começar e terminar.

• Inicie o Journey imediatamente ou em algum momento no futuro.
  • O Journey aparecerá como Agendado no painel até o horário de início.
  • Ele se torna automaticamente Ativo no horário de início configurado.
• Permita que o Journey seja executado indefinidamente até você pará-lo ou definir um horário de término futuro.
  • Se a data de término for definida, o Journey será Parado e Arquivado automaticamente assim que o horário de término for alcançado.
  • Todas as mensagens param imediatamente para os usuários atualmente no Journey.
  • Esses usuários não acionarão eventos de saída ou saída antecipada.

​

Permitir que os usuários atuais terminem o Journey

Para impedir que novos usuários entrem mas permitir que os atuais terminem:

1. Atualize o Segmento de Público das Regras de Entrada para apenas incluir um segmento vazio (por exemplo, um segmento de Usuários de Teste).
2. Atualize as Regras de Saída para Desmarcar “Sair quando um usuário não corresponder mais às condições do público”.

Isso garante que os usuários existentes continuem até o final.

---