Configurações do Journey

As configurações do Journey controlam quem entra, quando saem, se podem reentrar e quando o Journey inicia ou para.

​

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 YYYY-MM-DD) 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.

​

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. Consulte o aviso das regras de saída para saber o que acontece quando um usuário corresponde às regras de entrada e saída. 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

Quando esta opção é marcada, o Journey ignora todos os usuários que já estão nos segmentos incluídos ou excluídos no momento em que ele vai ao ar. Somente usuários que ingressarem no segmento após o lançamento podem entrar. Isso se aplica permanentemente — mesmo que um usuário existente saia do segmento e entre novamente mais tarde, ele ainda é excluído. Use para campanhas únicas (por exemplo, onboarding) onde os usuários atuais não devem receber o Journey.

​

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 entrar no Journey mais de uma vez ao mesmo tempo. Quando um nome de Evento Personalizado (e propriedades opcionais) corresponde às regras de entrada, o usuário entra no Journey e esse evento é armazenado. O evento armazenado pode ser referenciado na Sintaxe Liquid para personalização de mensagens e usado para Correspondência de Eventos em etapas de ação. Cada entrada carrega suas próprias propriedades de evento, portanto múltiplas entradas para o mesmo usuário podem conter dados diferentes.

• Nome do Evento Personalizado: O nome do evento que você planeja enviar via API.
• Filtrar por propriedade: Condições de propriedade adicionais para filtrar ainda mais quais usuários entram 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 e saindo 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. O temporizador de reentrada começa quando o usuário sai do Journey — não quando ele entrou. As regras de reentrada se aplicam apenas a Journeys com regras de entrada de Segmento de Público. Journeys baseados em Eventos Personalizados sempre permitem reentrada. Use para campanhas recorrentes, por exemplo abandono de carrinho, reengajamento por inatividade.

---

​

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.

---

​

FAQ

​

Posso alterar as regras de entrada após um Journey ir ao ar?

Você não pode alternar entre regras de entrada baseadas em Segmentos e Eventos Personalizados em um Journey ativo. Para alterar o tipo de entrada, pare e arquive o Journey, duplique-o e configure novas regras de entrada na cópia.

​

O que acontece se um usuário corresponder às regras de entrada e saída?

O usuário entra no Journey e completa o primeiro passo antes de sair. Para evitar isso, adicione um passo Aguardar como o primeiro passo ou refine seus Segmentos Excluídos para filtrar esses usuários antes da entrada.

​

Posso editar os segmentos usados nas regras de entrada de um Journey ativo?

Não. Segmentos referenciados nas regras de entrada de um Journey ativo estão bloqueados. Para modificá-los, arquive o Journey ou remova o segmento das regras de entrada primeiro.

​

Como funciona “Apenas adições futuras”?

Quando ativado, todos os usuários atualmente nos segmentos incluídos ou excluídos no lançamento são permanentemente excluídos do Journey — mesmo que saiam e entrem novamente no segmento mais tarde. Somente usuários que ingressarem no segmento após o lançamento podem entrar.

​

Um usuário pode reentrar em um Journey acionado por Eventos Personalizados?

Sim. Journeys baseados em Eventos Personalizados sempre permitem reentrada. Cada vez que um evento correspondente é acionado, o usuário entra em uma nova instância do Journey com as propriedades daquele evento.

​

Páginas relacionadas