Documentação técnica de insights de site/app

O que é um projeto de Website / App Insights e por que estamos usando-o em nosso site?

O Qualtrics Website / App Insights ajuda as organizações a medir e aprimorar a experiência que um visitante do site tem em sua mídia digital. Com um projeto de Website / App Insights, você pode apresentar gráficos interessantes em seu site com links e pesquisas incorporadas para obter feedback sobre a experiência dos visitantes, informá-los sobre suas últimas ofertas e promoções e muito mais!

Você e seus colegas têm poder sobre a aparência do gráfico (também conhecido como criativo), as condições em que ele aparece (o interceptor) e o código usado para implementá-lo.

Assim que o código do projeto for adicionado ao site, você poderá fazer todos os tipos de alteração sem precisar mudar o código nem alertar a equipe de TI. Basta fazer o trabalho na Qualtrics, e os criativos e interceptores dos seus sites mudarão de acordo.

É seguro?

Não transmitimos nenhum dado para os servidores da Qualtrics, a não ser que seja necessário para lógica de segmentação. Dito isso, não armazenamos nenhum dado em nosso sistema.

Para proteger esses dados na rede e protegê-los contra ataques humanos, a Qualtrics sempre usa o protocolo “HTTPS”. Protocolo refere-se a como o conteúdo é entregue ao navegador do visitante.

Onde posso localizar o código do projeto para implementação?

O código de
implementação (ou código de implementação do projeto) pode ser encontrado na guia Implementação do projeto. Você pode simplesmente copiar o código e enviá-lo para a sua equipe de desenvolvimento da web para implementarem. Nenhuma modificação precisa ser feita ao código.

O código de implementação exibe qualquer interceptor que tenha sido criado dentro de todo o projeto.

Como o código funciona?

O código de implementação é assíncrono, ou seja, é executado somente depois que a página inteira é carregada. Isso significa que o código de implementação não impedirá o carregamento de nenhum outro aspecto da página porque ele só será executado assim que o evento onLoad for acionado.

Vamos percorrer o processo do que acontece quando um visitante visualiza uma página em seu navegador que contém código de implementação:

• O código de implementação (geralmente colocado no cabeçalho HTML) é executado imediatamente após o carregamento da página e inserirá outra tag <script> no final do corpo HTML quando o evento onLoad da página for acionado.
• Esta tag <script> solicita o código JavaScript (Orchestrator) dos servidores da Qualtrics que está armazenado em cache em uma rede de entrega de conteúdo (CDN).
• O Orchestrator faz uma chamada de segmentação aos servidores da Qualtrics para determinar quais criativos mostrar. Essa chamada não é armazenada em cache na CDN.
  • Se necessário, uma segunda solicitação de segmentação é enviada aos servidores para obter os dados necessários (por exemplo: expressão JavaScript ou direcionamento de cookies).
  • A Qualtrics obtém a definição de Insights do site/app do banco de dados e cria o código adequadamente.
• Com base na resposta de segmentação, o Orchestrator faz outras chamadas para obter o conteúdo diferente que deve ser processado na página. O número de solicitações feitas varia dependendo do número de criativos para mostrar que passam a lógica de direcionamento. Todo esse conteúdo é armazenado em cache na CDN, de modo que o carregamento será rápido.
• O(s) criativo(s) aparece(m) na página.

O código de implementação é dinâmico, o que significa que as modificações efetuadas em interceptores e criativos a partir da interface do projeto Website / App Insights não causarão a modificação do código em si. Assim, é possível efetuar modificações nos projetos do Website / App Insights a partir de uma conta, e o código não precisará ser trocado no site para que as modificações sejam vistas.

Como implemento um projeto do Website / App Insights?

1. Adicionar código diretamente às suas páginas da Web

O código de implementação pode ser adicionado em qualquer lugar em uma página da web. Como o código é executado de maneira assíncrona, ele só começará a ser carregado assim que uma página da web tiver carregado todo o conteúdo por completo (incluindo imagens, arquivos de script, arquivos CSS etc.).

Nossas solicitações começam a acontecer assim que o evento onLoad é acionado: https://www.w3schools.com/jsref/event_onload.asp

Além disso, o local em que os criativos realmente aparecem na página da Web é determinado pelas configurações determinadas na interface do Qualtrics. (Consulte informações sobre Posição personalizada.) Assim, a localização do código dentro da página não afeta onde será exibido o conteúdo da página.

2. Cabeçalho/rodapé global (recomendado)

Recomendamos que você adicione o código de implementação ao cabeçalho ou rodapé global. Isso aplica o código globalmente no site inteiro de uma vez. Esse método é a maneira mais fácil de implementar porque você não precisa adicionar código repetidamente a mais páginas à medida que avança, o que pode ser um processo demorado. Se o código tiver sido adicionado globalmente ao seu site dessa forma, você poderá usar a lógica URL atual dentro de um interceptor para controlar em quais páginas um interceptor realmente é exibido.

3. Utilizar gerenciadores de tags

Outra opção é adicionar o código de implementação a um sistema de gerenciamento de tags, em vez de aplicá-lo diretamente ao código do site. O código pode ser copiado e colado da interface da Qualtrics direto em um gerenciador de tags.

Os sistemas comuns de gerenciamento de tags que nossos clientes usam em conjunto com o Website / App Insights são Adobe Launch, Tealium, Ensighten e Google Tag Manager. O Tealium, em particular, tem um assistente criado que permite uma implementação fácil de Web Insights / App. Você precisa apenas do ID da zona do projeto que está implementando e do ID da organização.

O ID da organização pode ser obtido acessando Configurações da conta e selecionando a guia IDs da Qualtrics.

O ID da zona começa com ZN_ e pode ser encontrado:

1. No URL do projeto quando você estiver dentro dele, ou
   
2. No código de implementação do projeto.
   

Quem normalmente está envolvido na implementação do Website / App Insights?

Alguém na sua organização que tem acesso para adicionar conteúdo ao site da sua empresa. Normalmente, essas pessoas fazem parte da equipe de TI, da equipe de conteúdo da web etc.

O Website / App Insights deixará nosso site lento?

O código de implementação é assíncrono, ou seja, é executado somente depois que a página inteira é carregada. Isso significa que o código de implementação não impedirá o carregamento de nenhum outro aspecto da página porque ele só será executado assim que o evento onLoad for acionado.

E se a Qualtrics ficar indisponível? Isso causará problemas com nosso site?

Se a Qualtrics estiver enfrentando interrupções ou problemas, os interceptores simplesmente não serão exibidos na página. Além disso, não haverá impacto na experiência do visitante em seus sites.

Com que velocidade o código será executado em meu site?

Esperamos que o código de implementação seja carregado em 300 milissegundos para mais de 50% das solicitações e em 750 milissegundos para mais de 90% das solicitações. A velocidade varia de acordo com a localização geográfica do usuário e o número de interceptores e criativos que um projeto tem.

Opening the Debug Window

You can use the debug window to diagnose why an intercept has not displayed on a specific web page. This window shows all conditions required for the intercept to appear and if the conditions passed or failed.

How you open the debug window will depend on when your intercept was implemented.

Intercepts Implemented Before March 2019

For intercepts whose deployment code was implemented prior to March 2019, you can enable the Debug Window by appending the Q_DEBUG query string to the URL. This query string should be appended with either a ? or &, as illustrated in the examples below:

Intercepts Implemented After March 2019

For intercepts whose deployment code was implemented after March 2019, follow these steps to open the debug window:

1. Open your browser’s developer tools.
2. Run the following JavaScript command:
   QSI.API.unload();
QSI.isDebug = true;
QSI.API.load();
QSI.API.run();

Dicas de Solução de Problemas

Lógica do interceptor e lógica do conjunto de ações

• Verifique se os valores estão corretos.
• Examine o uso de “Is” vs. “Contém”.
• Examine o uso da lógica E/Ou.
• Observe se há espaços nos valores.

Histórico de revisão

Certifique-se de que a versão publicada é a mais recente (ou a versão que você esperaria).

Observar o site / App Insights Network Request

1. Abra Ferramentas de desenvolvedor no seu navegador.
2. Examinar a solicitação de rede para ?Q_ZID etc.
   • Nenhuma solicitação de rede: a implementação não está funcionando.
   • Solicitação de rede: verificar inconsistências nos parâmetros da solicitação. Às vezes, o código é implementado usando um sistema de gerenciamento de tags. Em alguns casos, essa implementação é confundida com os parâmetros de nossa solicitação para URL atual etc.
   • Solicitação de rede com um erro: verifique se seu projeto está ativado.

Procurar outras solicitações de script em conflito que possam ser confundidas com nosso script

1. Clique com o botão direito em qualquer lugar no navegador.
2. Selecione Inspecionar elemento.
3. Selecione Console (aqui é onde os erros aparecem).

Perguntas frequentes