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
Eu ativei meu interceptor, mas ele não aparece no meu site. Por que não?
Eu ativei meu interceptor, mas ele não aparece 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 direcionamento de interceptor e a lógica de 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 usam "Contém": Uma causa comum de erro lógico é o uso do conjunto lógico "Contains" vs. "Contains". "É." 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 fazer edições em interceptações, as alterações não são ativadas 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 inestimável para testar 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 prefixado com um ? ou um &, como nos exemplos a seguir: https:qualtrics qualtrics
Para interceptações cujo código de implementação foi 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();A janela de depuração divide todas as condições necessárias para que as interceptações em execução na URL sejam exibidas. Se você achar que uma interceptor não está aparecendo, localize-a na janela de depuração e identifique os avisos vermelhos de falha.Qdica: O depurador do Website Insights não funcionará se o código tiver sido implementado usando um gerente de tags. Além disso, se o URL já tiver uma query string com um ?, o depurador exigirá um & em vez disso. - Solicitação de rede: A maioria dos navegadores possui um menu ferramentas desenvolvedor que permite que o usuário veja 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 de política de segurança de conteúdo: Se você receber um log de console que viole uma política de segurança de conteúdo, provavelmente há uma restrição no seu site que está impedindo a implementação das 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 permitir a inclusão dos seguintes itens nos cabeçalhos da Content Security Policy:
- connect-src https://*qualtrics.com
- frame-src https://*qualtrics.com
- img-src qualtrics
- script-src https://*qualtrics.com
- Tratamento de URL de SPA: Se o seu site usa uma estrutura de aplicativo de página única (SPA), verifique se o código aciona history.pushState() ao navegar entre as exibiçõ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 estiver usando useEffect ou ganchos lifecycle semelhantes, certifique-se de que a lógica interceptor seja executada após a conclusão da navegação.
Qual é a diferença entre o código de zona e o código de interceptação? Agora que é chamado de “código de projeto” na nova interface, o que isso significa?
Qual é a diferença entre o código de zona e o código de interceptação? Agora que é chamado de “código de projeto” na nova interface, o que isso significa?
Os códigos de interceptação eram específicos para o interceptor para o qual ele foi gerado. Isso significa que, se você quiser que algo apareça em uma página específica, pode colocar o código nesse URL. Isso foi usado com menos frequência, uma vez que exigia que você adicionasse muitos códigos ao seu site em diferentes locais. Os códigos de interceptor antigos ainda funcionam e sempre funcionarão, mas você não pode gerar novos códigos na nova IU.
Zonas (agora “Projetos”) atuam como coleções para vários criativos e interceptores. Os códigos de zona contêm todos os interceptores na zona. Isso permite que você implemente um único código em seu site em vez de adicionar continuamente códigos para interceptores individuais. Isso pode poupar muito tempo, uma vez que cada vez que você ativa o conteúdo na zona, ele é adicionado automaticamente ao código, não sendo necessária nenhuma modificação.
Os projetos são equivalentes a zonas, de modo que o código de implementação do projeto é o equivalente aos códigos de zona antigos.
Zonas (agora “Projetos”) atuam como coleções para vários criativos e interceptores. Os códigos de zona contêm todos os interceptores na zona. Isso permite que você implemente um único código em seu site em vez de adicionar continuamente códigos para interceptores individuais. Isso pode poupar muito tempo, uma vez que cada vez que você ativa o conteúdo na zona, ele é adicionado automaticamente ao código, não sendo necessária nenhuma modificação.
Os projetos são equivalentes a zonas, de modo que o código de implementação do projeto é o equivalente aos códigos de zona antigos.
Criei meu interceptor, mas gostaria de testá-lo antes da ativação. Como eu posso fazer isso?
Criei meu interceptor, mas gostaria de testá-lo antes da ativação. Como eu posso fazer isso?
Há uma ferramenta chamada bookmarklet que permite testar qualquer interceptor sem precisar ativá-lo.
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!