Aplicativo de página única

Sobre aplicativos de página única

Os aplicativos de página única (SPA) são um tipo especial de aplicativo da Web. Um SPA carregará uma única página quando você entrar em um site e, a partir desse ponto, carregará todo o conteúdo subsequente nessa mesma página à medida que você navegar. Isso parecerá funcionar como um site normal, mas ao alternar entre “páginas”, a página não recarrega de fato.

Por padrão, código de implementação é executado assim que uma página da Web é carregada. No entanto, como os SPAs não são atualizados ao navegar entre as páginas, código de implementação não será reavaliado quando você navegar entre as páginas. Usando as técnicas descritas abaixo, você pode permitir que o código de implementação funcione em seu site SPA sem problemas.

Reavaliação automática da lógica de Interceptor em caso de mudança de URL

Se o seu aplicativo de página única depender do roteamento do lado do cliente para a navegação do usuário, você poderá forçar a reavaliação das interceptações nas alterações subsequentes de URL ativando a configuração Reavaliar lógica de interceptor quando o URL for alterado. Marcar essa configuração permitirá a avaliação da lógica interceptor, além da avaliação que ocorre no carregamento inicial da página.

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

1. Ir para Interceptações.
   
2. Vá para Configurações de Interceptor.
3. Certifique-se de que a opção Reavaliar a lógica interceptor quando o URL for alterado esteja marcada na seção Suporte a aplicativos de página única (SPA).
   
4. Clique em Aplicar alterações.

Reavaliação da lógica de Interceptor e atividade de rastreamento após a mudança de URL

Na seção anterior, mostramos como oferecer suporte a aplicativos de página única para todas as interceptações em um projeto. No entanto, se quiser dar suporte a esse comportamento para todas as interceptações em um projeto e na Análise de experiência Digital, será necessário ajustar uma configuração no nível do projeto.

1. Vá para Gerenciar projeto.
2. Certifique-se de que a opção Reavaliar a lógica interceptor e/ou rastrear a atividade sempre que o URL for alterado esteja marcada na seção Suporte a aplicativos de página única (SPA).
3. Clique em Aplicar alterações.

QSI.API.run();

Implementação manual com a API JavaScript

Este método descreve como mudar seu código de implementação para ser executado manualmente. Isso significa que o código de implementação não será executado nem avaliará a lógica associada até que a solicitação apropriada API JavaScript seja iniciada.

Para implementar manualmente

1. Ir para Interceptações.
   
2. Vá para Configurações de Interceptor.
3. No cabeçalho Opções de carregamento de Interceptor, selecione Carregar projeto manualmente.
   
4. Clique em Aplicar alterações.
5. Se desejar, retorne a uma de suas interceptações e defina a lógica para toda a interceptor ou para conjuntos de ações individuais.
   
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 API JavaScript apropriadas com base no número de vezes que você deseja que seu site faça referência ao Interceptor. Consulte a seção abaixo sobre essas solicitações.

Solicitações API JavaScript

Se quiser que o Qualtrics avalie seu projeto em uma única instância, use essas duas solicitações:

1. Essa solicitação carrega o código de implementação de implementação de todos os Intercepts e Creatives na página. A API “load” é o mesmo que recarregar uma página que contém código.

   QSI API.load();

   Qdica: se você tiver a opção Manually Load Project ativada nas configurações do projeto, não precisará chamar essa API para carregar o código de implementação no carregamento inicial da página. Só será necessário forçar o carregamento para levar conta as alterações de estado na página que ocorrem sem recarga.
2. Isso inicia a avaliação código de implementação e fará com que qualquer Criativo apareça se passar nas condições de exibição.

   QSI API.run();

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

1. Essa solicitação remove o código de implementação de implantação de qualquer Intercepts ou Creatives presente na página.

   QSI API.unload();

2. Isso carrega o código de implementação de implementação de qualquer Intercepts ou Creatives na página. Isso é o mesmo que recarregar a página.

   QSI API.load();

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

   QSI API.run();

Perguntas frequentes