Aplicativo de página única

Sobre aplicativos de página única

As aplicações de página única (SPA) são um tipo especial de app da Web. Uma SPA carregará uma única página quando você inserir um site da Web e, a partir desse ponto, carregar todo o conteúdo subsequente nessa mesma página à medida que você navegar. Isso vai parecer funcionar como um site normal, mas ao alternar entre “páginas”, a página não recarrega de fato.

Por padrão, o código de implementação é executado assim que uma página da Web é carregada. No entanto, como as SPAs não são atualizadas ao navegar entre as páginas, o código de implantação não será reavaliado à medida que você navega entre as páginas. Usando as técnicas descritas abaixo, você pode ativar o código de implementação para funcionar perfeitamente em seu site SPA.

Reavaliação automática da lógica do interceptor ao alterar URL

Se seu aplicativo de página única depender do roteamento do lado do cliente para navegação do usuário, você poderá forçar a reavaliação dos interceptores após as alterações de URL subsequentes ativando a lógica Reavaliar interceptor quando a configuração de URL for alterada no nível do projeto de Website Feedback. A verificação desta configuração permitirá a avaliação da lógica de interceptação além da avaliação que ocorre no carregamento inicial da página.

Para ativar a reavaliação automática da lógica de interceptação, siga as etapas abaixo:

1. No seu projeto de Website Feedback, navegue para as Configurações.
2. Clique em Gerenciar projeto.
3. Selecione Opções do projeto no menu drop-down.
4. Certifique-se de que Reavaliar lógica de interceptor quando o URL for modificado esteja marcado na seção Suporte do aplicativo de página única (SPA).

QSI.API.run();

Implementação manual com JavaScript API

Este método descreve como alternar seu código de implementação para execução manual.  Isso significa que o código de implementação não executará ou avaliará a lógica associada até que a solicitação de API JavaScript apropriada seja iniciada.

Para implementar manualmente

1. Navegue para a guia Configurações.
   
2. Clique na lista de opções Administrar projeto.
3. Selecione Opções do projeto.
4. Ative a opção Carregar projeto manualmente.
   
5. Volte para a guia Interceptações e, se desejar, defina a lógica para o Interceptor ou o Conjunto de ações.
   
6. Coloque o código de implementação em seu site, de preferência em um cabeçalho ou rodapé global para que ele seja carregado em todas as páginas.
7. Adicione as solicitações adequadas da API JavaScript com base em quantas vezes você quer que seu site referencie o Interceptor. Consulte a seção abaixo para essas solicitações.

Solicitações de API JavaScript

Se você quiser que a Qualtrics avalie seu projeto em uma única instância, use estas duas solicitações:

1. Esta solicitação carrega o código de implementação para quaisquer Interceptores e Criativos na página. A API “load” é a mesma que recarregar uma página que tem o código nela.

   QSI.API.load();

   Qdica: Se Carregar projeto manualmente estiver ativado nas configurações do seu projeto, você não precisará chamar esta API para carregar o código de implementação no carregamento inicial da página. Só será necessário forçar o carregamento para considerar alterações de estado na página que ocorrem sem recarregamento.
2. Isso inicia a avaliação do código de implementação e faz com que qualquer Criativo apareça se ele passar nas condições de exibição.

   QSI.API.run();

Se você quiser que a Qualtrics avalie seu código de projeto mais de uma vez na mesma página, repita as três etapas a seguir de cada vez:

1. Esta solicitação remove o código de implementação de quaisquer Interceptores ou Criativos presentes na página.

   QSI.API.unload();

2. Isso carrega o código de implementação para quaisquer Interceptores ou Criativos na página. Isso é o mesmo que recarregar a página.

   QSI.API.load();

3. Isso inicia a avaliação do código de implementação e faz com que qualquer Criativo apareça se ele passar nas condições de exibição.

   QSI.API.run();

Perguntas frequentes