Ir para o conteúdo principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

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


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


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!

um interceptor de site em um site de varejo que pergunta aos clientes por que decidiram escolher esta empresa

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.

Código de implementação na seção Implementação

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.

Atenção: para manter os níveis de serviço adequados em todos os clientes, a Qualtrics pode restringir o tráfego para nossos servidores em casos raros quando ocorrem picos inesperadamente grandes.

Como implemento um projeto do Website / App Insights?

Atenção: para garantir que seus interceptores funcionam, você deve permitir a lista dos seguintes itens em seus cabeçalhos da Política de segurança de conteúdo:

  • Conectar-https://*.qualtrics.com
  • Frame-src https://*.qualtrics.com
  • img-src https://*.qualtrics.com
  • Script-src https://*.qualtrics.com

Se sua política de segurança de conteúdo bloquear esses itens por padrão, os insights do site/app não funcionarão de forma confiável no seu site. Se você usa uma solução de gerenciamento de segurança do site, como o Ensighten, use o domínio *qualtrics.com na lista, seguindo a documentação fornecida. Essas soluções podem impedir que o tag Qualtrics carregue os recursos necessários e os Insights do site/app podem não funcionar de forma confiável no seu site. Além disso, se você estiver utilizando variáveis JavaScript, precisará permitir a “avaliação não segura” na sua política de segurança de conteúdo, caso contrário, os Web Insights não poderão capturar os valores JavaScript.

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.

Atenção: se você quiser limitar as visualizações da página, considere colocar o código de implantação somente em páginas específicas ou usar amostragem. Consulte Práticas recomendadas para minimizar visualizações de página para obter mais informações.

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.

Qdica: No momento, a Qualtrics tem uma extensão com o Adobe Launch como um sistema de Gerenciamento de tags. Consulte Adobe Launch Extension para obter mais informações.
Qdica: a Qualtrics não pode resolver completamente os problemas com o código aplicado aos gerenciadores de tags, pois não conseguimos visualizar as configurações que foram ativadas por você. Consulte nossa página Uso de gerenciadores de tags para obter dicas de solução de problemas.

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.

Localizando o ID da organização na seção IDs da Qualtrics das Configurações da conta

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

  1. No URL do projeto quando você estiver dentro dele, ou
    O ID de zona que começa com ZN pode ser encontrado no URL
  2. No código de implementação do projeto.
    ID da zona no código de implementação do projeto, começando com ZN

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.
the debugger window showing the display conditions and if they passed or failed

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

Attention: The debug window does not function if the code has been implemented using a tag manager.

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:

Example:
https://www.qualtrics.com?Q_DEBUG
https://www.qualtrics.com/blog?item=value&Q_DEBUG
Qtip: If the URL already contains a query string with a ?, the query string will require an & instead.

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).
Qdica: clique com o botão direito do mouse e selecione Exibir origem da página para verificar se o código de implementação está realmente na página.
Atenção: Se você receber um log de console que viole uma Política de Segurança de Conteúdo, provavelmente existe uma restrição em seu site que está bloqueando a implantação de nossos interceptores. Recomendamos que entre em contato com sua equipe de desenvolvimento web para resolver o problema.

Perguntas frequentes

Muitas das páginas neste site foram traduzidas do inglês original usando tradução automática. Embora na Qualtrics tenhamos feito nossa diligência prévia para obter as melhores traduções automáticas possíveis, a tradução automática nunca é perfeita. O texto original em inglês é considerado a versão oficial, e quaisquer discrepâncias entre o inglês original e as traduções automáticas não são juridicamente vinculativas.