Guia Implantação
Suite
Customer Experience
Strategy & Research
Produto
Qualtrics
O que há nesta página
Qdica: se você não tiver acesso a nenhum dos recursos descritos nesta página, entre em contato com o executivo Conta sua conta. Para obter mais informações sobre as diferenças entre o Digital Feedback e CustomerXM for Digital, consulte Digital Feedback vs. CustomerXM for Digital. CustomerXM for Digital.
Sobre a guia Deployment
Quando finalmente estiver pronto para implantar o projeto do Website/App Insights no seu site, vá até a guia Implantação para obter o código que será implementado no site.
Atenção: Não faça nenhuma alteração em seu código de implementação. suporte da Qualtrics não pode solucionar problemas que surgem do código de implementação editado.
Código de implantação do projeto
O código do projeto contém todas as interceptações ativas e seus criativos no projeto.
Implementação do código do projeto
O código do projeto pode ser colocado em qualquer página em que você queira exibir criativos para seus visitantes. Além disso, você também deverá colocar o código em todas as páginas para as quais deseja que o projeto Website/App Insights rastreie ou colete informações.
Atenção: Se você criar vários projetos do Website / App Insights no Qualtrics, cada projeto terá seu próprio trecho código de implementação Javascript. Você pode criar vários projetos e usá-los em diferentes sites, subsites ou até mesmo para implantação em testes e preparação. No entanto, recomendamos enfaticamente que você não implemente vários trechos de código Javascript de projetos separados e que eles sejam executados simultaneamente nas mesmas seções ou páginas do seu site. Isso pode levar a problemas relacionados a temporizador e carregamento, especialmente se você estiver fazendo chamadas para a API Javascript do QSI.
Atenção: Se o seu projeto estiver dentro do nosso ambiente FedRAMP e o domínio do seu site não terminar em .gov, será necessário contato o Suporte FedRAMP para solicitar a inclusão do seu domínio na lista de permissões. Se você tentar executar uma interceptor antes de fazer isso, encontrará um erro no console do tipo “No Access-Control-Allow-Origin”. Essa medida de segurança aprimorada também precisará ser concluída para qualquer subdomínio que não termine em .gov.
Exemplo: A exibição de um pop over para todos os visitantes na página inicial requer apenas que o código seja colocado na página inicial. No entanto, a exibição dessa pop over somente para os visitantes da página inicial que já estiveram na página do carrinho de compras exige que o projeto Website/App Insights saiba que um visitante visitou o carrinho de compras. Portanto, o código também deve ser colocado na página do carrinho de compras.
Como adicionar o snippet de código ao seu site por conta própria
Qdica: para uma implementação mais fácil, recomendamos colocar o código em um cabeçalho ou rodapé global, para que ele seja carregado em todas as páginas do site. Essa é a implementação mais flexível e útil, pois permite que você execute interceptações em qualquer página do seu site. No entanto, esse método também levará a um nível mais alto de uso, pois cada vez que o código for executado em uma página, ele será considerado uma exibição de página. Certifique-se de verificar se sua licença acomodará esse volume de uso.
Envio do snippet de código para o desenvolvedor do site
Em vez de atualizar o código do site por conta própria, você também pode optar por solicitar que o desenvolvedor do site faça isso para você. Nesse caso, basta copiar o snippet de código e enviá-lo por e-mail para a equipe de desenvolvimento do seu site.
Seu desenvolvedor pode colocar o código no cabeçalho ou no rodapé do HTML de cada página, ou no cabeçalho ou rodapé global, para que ele seja carregado em todas as páginas do site.
Uso de uma solução de gerenciamento de tags de terceiros
Outra opção para implementar projetos do Website/App Insights em seu site é adicioná-lo 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 Qualtrics diretamente em um gerente de tags. Consulte nossa página Usando gerenciadores de tags para obter mais informações.
Os sistemas comuns de gerenciamento de tags que nossos clientes usam em conjunto com projetos de insights de sites/aplicativos são Tealium, Adobe, Google Tag Gerente e Ensighten. O Tealium tem um assistente que permite a fácil implementação de projetos de insights de sites/aplicativos.
Qdica: suporte da Qualtrics não é capaz de solucionar problemas com códigos aplicados a gerenciadores de tags porque não podemos visualizar ou ajustar as configurações que foram ativadas em sua extremidade. Consulte nossa página Usando gerenciadores de tags.
Testando o código de seu projeto
Você pode testar seu código antes de adicioná-lo ao site ou publicar suas alterações. Consulte Teste de alterações não publicadas para obter mais informações.
Perguntas frequentes
Ativei meu interceptor, mas ele não está aparecendo no meu site. Por que não?
Ativei meu interceptor, mas ele não está aparecendo no meu site. Por que não?
Há várias causas possíveis para que uma interceptor não esteja aparecendo depois de implementada. Essas causas podem se originar da configuração da própria interceptor ou da implementação do código.
- Lógica: a lógica de segmentação interceptor e a lógica conjunto de ações são as condições que devem ser atendidas para que uma interceptor seja exibida a um visitante. A verificação dessa lógica será útil para descobrir por que o Interceptor não está sendo exibido em uma página.
- Conjuntos lógicos que utilizam “Contém”: Uma causa comum de erro lógico é o uso de “Contém” em vez de "É." Dizer que uma condição "Contém" significa que o parâmetro no qual você está baseando a lógica (ou seja, URL atual) terá o valor especificado presente, além de mais informações. Por exemplo, se eu tivesse uma lógica que lesse como URL atual contém "qualtrics", isso faria com que a interceptor fosse exibida em qualquer URL que tivesse a palavra qualtrics presente. A outra opção que você tem é usar o URL atual é [URL]. Essa condição depende do fato de o URL visitado ser uma correspondência exata. Quaisquer diferenças ou caracteres adicionais impedirão a aprovação da lógica interceptor.
- Revisões Interceptor: Ao editar interceptações, as alterações não entram em vigor até que a interceptor seja publicada. Ao publicar uma Interceptor, uma versão da interceptor, ou uma "revisão", é salva. A revisão das revisões feitas é muito útil para identificar quaisquer alterações que possam ter impedido repentinamente o aparecimento da interceptor.
- Janela de depuração: A janela de depuração é uma ferramenta indispensável para verificar por que uma interceptor não está sendo exibida em uma determinada página.
Para interceptações cujo código de implementação foi implementado antes de março de 2019, para ativar a janela de depuração, anexe uma query string a qualquer URL chamado Q_DEBUG. Isso deve ser precedido por um ? ou um &, como nos exemplos a seguir:qualtrics,qualtrics;Q_DEBUG.
Para interceptações cujo código de implementação tenha sido implementado após março de 2019, execute o seguinte trecho de JavaScript no Console da sua página da web:
QSI.API.unload();
QSI.isDebug = true;
QSI.API.load();
QSI.API.run();Qdica: O depurador do Website Insights não funciona se o código tiver sido implementado por meio de um gerente de tags. Além disso, se a URL já tiver uma query string com um ?, o depurador exigirá um & em seu lugar.
- Solicitação de rede: A maioria dos navegadores possui um menu ferramentas de desenvolvedor que permite ao usuário visualizar o código-fonte, os recursos, os cookies e as chamadas de rede de um site. O Website Insights possui uma presença distinta na seção Rede dessas ferramentas. Para verificar se esses scripts estão sendo executados, abra ferramentas do desenvolvedor e navegue até a seção Rede. Uma vez aqui, recarregue a página da Web e o menu deverá começar a ser preenchido com todas as solicitações de rede que estão sendo feitas pelo site. Para identificar o código do Website Insights, procure por chamadas que comecem com ?Q_ZID ou ?Q_SID. Esse é o próprio código que executa verificações na lógica de exibição. Se você não encontrar nada que corresponda a esse formato, há um problema com a implementação do código do seu projeto. Você pode consultar nossa página de suporte sobre implementação para obter orientação sobre o melhor local para colocar o código.
- Problemas com a Política de Segurança de Conteúdo: Se você receber um log do console indicando uma violação da Política de Segurança de Conteúdo, é muito provável que haja uma restrição em seu site que esteja impedindo a implantação de nossas interceptações. Recomendamos entrar em contato com sua equipe de desenvolvimento da Web para resolver o problema. Para garantir que suas interceptações funcionem, geralmente recomendamos incluir os seguintes itens na lista de permissões dos cabeçalhos da sua Política de Segurança de Conteúdo:
- connect-src https://*.qualtrics.com
- frame-src https://*.qualtrics.com
- img-src qualtrics
- script-src https://*.qualtrics.com
- Tratamento de URLs em SPA: Se o seu site utiliza uma estrutura de aplicativo de página única (SPA), certifique-se de que seu código acione o `history.pushState()` ao navegar entre as visualizações. Algumas estruturas podem renderizar novamente ou atualizar o URL sem enviar uma nova entrada de histórico, o que pode impedir o disparo de interceptações. Se você estiver usando o useEffect ou hooks lifecycle semelhantes, certifique-se de que sua lógica interceptor seja executada após a conclusão da navegação.
Qual é a diferença entre código de zona e código interceptor? Agora que isso é chamado de “código do projeto” na nova interface, o que isso significa?
Qual é a diferença entre código de zona e código interceptor? Agora que isso é chamado de “código do projeto” na nova interface, o que isso significa?
Os códigos Interceptor eram específicos para a interceptor para a qual foram gerados. Isso significa que, se você quiser que algo apareça em uma página específica, pode inserir o código nessa URL. Essa opção era menos utilizada, pois exigia que você adicionasse muito código ao seu site em vários lugares. Os códigos interceptor antigos ainda funcionam e sempre funcionarão, mas não é possível gerar novos códigos na nova interface de usuário.
As zonas (agora chamadas de “Projetos”) funcionam como coleções para vários criativos e interceptações. Os códigos Zona contêm todos os pontos de intersecção da zona. Isso permite que você implemente um único código no seu site, em vez de ter que adicionar códigos continuamente para cada interceptação individual. Isso pode economizar muito tempo, já que, sempre que você ativar um conteúdo na zona, ele é automaticamente adicionado ao código, sem a necessidade de nenhuma alteração.
Projetos são equivalentes às zonas; portanto, código de implementação do projeto é equivalente aos antigos códigos zona.
As zonas (agora chamadas de “Projetos”) funcionam como coleções para vários criativos e interceptações. Os códigos Zona contêm todos os pontos de intersecção da zona. Isso permite que você implemente um único código no seu site, em vez de ter que adicionar códigos continuamente para cada interceptação individual. Isso pode economizar muito tempo, já que, sempre que você ativar um conteúdo na zona, ele é automaticamente adicionado ao código, sem a necessidade de nenhuma alteração.
Projetos são equivalentes às zonas; portanto, código de implementação do projeto é equivalente aos antigos códigos zona.
Já criei minha interceptor, mas gostaria de testá-la antes de ativá-la. Como posso fazer isso?
Já criei minha interceptor, mas gostaria de testá-la antes de ativá-la. Como posso fazer isso?
Existe uma ferramenta chamada bookmarklet que permite testar qualquer interceptor sem precisar ativá-la.
Quando implemento meu interceptor, vejo o erro "Sem origem permitida pelo controle de acesso". Como faço para corrigi-lo?
Quando implemento meu interceptor, vejo o erro "Sem origem permitida pelo controle de acesso". Como faço para corrigi-lo?
Esta mensagem de erro é exibida quando você é um usuário FedRAMP e está tentando implementar um interceptor em um site da Web que não foi incluído na lista branca.
Se o seu projeto estiver dentro do nosso ambiente FedRAMP e o domínio do seu site não terminar em .gov, você precisará entrar em contato com o suporte do FedRAMP para solicitar que seu domínio seja incluído na lista branca. Se você tentar executar um interceptor antes de fazê-lo, encontrará um erro de console de "No Access-Control-Allow-Origin". Essa medida de segurança aprimorada também precisará ser concluída para qualquer subdomínio que não termine em .gov.
Se o seu projeto estiver dentro do nosso ambiente FedRAMP e o domínio do seu site não terminar em .gov, você precisará entrar em contato com o suporte do FedRAMP para solicitar que seu domínio seja incluído na lista branca. Se você tentar executar um interceptor antes de fazê-lo, encontrará um erro de console de "No Access-Control-Allow-Origin". Essa medida de segurança aprimorada também precisará ser concluída para qualquer subdomínio que não termine em .gov.
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.
Isso é ótimo! Obrigado pelo seu feedback!
Obrigado pelo seu feedback!