Jornada de Onboarding: Como configurar e personalizar
A Jornada de Onboarding permite que você colete as preferências dos seus usuários logo no primeiro contato ou através do perfil. Com esses dados, o aplicativo entrega uma experiência personalizada, exibindo vitrines e categorias que fazem sentido para cada cliente.
As preferências do usuário ficam salvas localmente no dispositivo. Caso possua uma API própria para acessar essas dados, informe-a ao abrir o chamado de ativação da funcionalidade.
Para iniciar a jornada a partir da tela de Perfil, o usuário precisa estar logado.
🛠️ Configurações via Suporte
Algumas funções avançadas são controladas diretamente pelo nosso time técnico. Caso precise de alguma das alterações abaixo, abra um chamado aqui.
Ativação: Ligar ou desligar a jornada no app.
Exibição Automática: Definir se o fluxo abre sozinho no primeiro acesso ou fica apenas no Perfil.
Vitrines Inteligentes: Ativar carrosséis na Home e atalhos no menu baseados nas preferências do usuário.
Integração de Dados: Configurar URLs de API e chaves (keys) para que os dados não fiquem salvos apenas no celular do usuário, mas também no seu banco de dados.
⚙️ Como configurar a Jornada no CMS VTEX
Siga o passo a passo para criar as telas de perguntas e preferências:
Acesse o CMS VTEX com seu e-mail de acesso.
Vá em Storefront > Headless CMS.
Clique em Criar documento e selecione Jornada de Onboarding.
No campo Settings, adicione as imagens de boas-vindas e login.
Para criar as páginas de perguntas, clique no "+" azul (Seções) e adicione "Etapa/Página".
Tipos de Páginas Disponíveis:
Boas-vindas: Introdução ao fluxo.
Seleção Vertical/Grid: Onde o usuário escolhe categorias ou coleções.
Sucesso (Feedback): Tela final de conclusão.
Configuração da Etapa/Página “Boas vindas”
No componente Jornada de Onboarding selecione a opção de adicionar a seção "Etapa/Página".
Ao selecionar a seção, preencha os campos indicados conforme as instruções abaixo:
Configurações aplicáveis:
Título: Título para identificação do modelo, não aparece no app
Número da Etapa/Página (1): Número da página para ordenação do fluxo
Tipo de página: Boas vindas.
Texto de ajuda: Texto de apoio que será exibido na página no app
Opções de seleção: Opções de preferências para o usuário selecionar nas etapas de seleção.
Configuração das Etapas de Seleção: “Seleção Vertical ou Grid”
Após criar a primeira parte de Boas Vindas, você pode adicionar outra Etapa com as configurações de seleção, onde o usuário irá selecionar as categorias ou coleções de sua preferência.
Configurações aplicáveis:
Título: Título para identificação do modelo, não aparece no app.
Número da Etapa/Página (2 ou 3): Ordenação da página no fluxo.
Tipo de página (seleção vertical ou grid): Define se as opções vão ser apresentadas em formato de lista ou de grid.
Título da página: Título que será exibido na página no app
Texto de apoio: Texto de apoio que será exibido na página no app.
Opções de seleção:
As opções são referentes à uma: As opções da etapa fazem referência à coleções ou categorias.
Máximo de opções selecionáveis: Número de opções que o usuário pode selecionar naquela etapa.
As opções são finais: Define se as opções da página são uma pré-seleção, ou se as opções são parte da etapa da etapa final, onde os dados serão enviados de fato.
Configuração da Etapa/Página de Feedback ("Sucesso")
Essa é a página final exibida ao usuário antes de liberar o acesso dele ao aplicativo, fornecendo um feedback visual de que suas preferências foram salvas e serão utilizadas para personalizar a experiência no aplicativo.
Configurações aplicáveis:
Título: Título para identificação do modelo, não aparece no app.
Número da Etapa/Página (4): Essa sempre será a última etapa do fluxo.
Tipo de página: Sucesso.
Texto de apoio: Texto de apoio que será exibido na página no app.
Redirecionamento do Usuário: Define se ao sair da jornada de onboarding o usuário seguirá para o Login ou para a Home.
Demais configurações não precisam ser preenchidas.
💡 Dica de Ouro: Ao configurar uma etapa, lembre-se de definir o "Máximo de opções selecionáveis" e se aquelas "Opções são finais" (isso indica ao sistema que a escolha deve ser salva e enviada para a API).
🎨 Exemplos Visuais da Funcionalidade
Etapa de Boas Vindas
Etapa(s) de Seleção
Vertical
Grid
Etapa de Feedback/Sucesso
🔍 Resolução de Problemas (FAQ)
Aqui estão os problemas mais comuns e como resolvê-los rapidamente:
| Problema | Causa Provável | Como Resolver | | ----------------------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | A jornada não aparece para o usuário. | O usuário não está logado. | A jornada exige login para identificar o ID do usuário (VTEX). Certifique-se de que o usuário realizou o login. | | O fluxo não inicia automaticamente ao abrir o app. | A ativação automática está desativada remotamente. | Verifique se a jornada está disponível na Página de Perfil. Se desejar que seja automática, solicite a alteração via suporte. | | As preferências não estão sendo salvas na minha API. | Falta de configuração da URL ou Chaves. | Verifique se você enviou a URL da sua API de coleta de dados para o suporte e se as "Chaves de envio" no CMS estão com os nomes corretos. | | Os dados de preferência sumiram quando o usuário trocou de celular. | Armazenamento apenas local. | Se você não utiliza uma API própria, os dados ficam salvos apenas no dispositivo. Recomendamos o uso de API para persistência de dados. | | O carrossel de produtos na Home não está mudando. | A opção "As opções são finais" não foi marcada. | No CMS, na última etapa de seleção, verifique se a chave "As opções são finais?" está marcada como Sim. Sem isso, o sistema não entende que deve processar a personalização. | | Carrossel de produtos não exibe preferências do usuário | A opção "Exibir preferências do usuário?" não foi marcada. | Na CMS, na configuração do seu carrossel de produtos, verifique se a opção "Exibir preferências do usuário?" ao final das configurações está com a checkbox marcada. |
🆘 Ainda precisa de ajuda?
Se você seguiu os passos e algo não saiu como o esperado, não se preocupe!
Dúvidas técnicas:Clique aqui para abrir um chamado.\