Documentação técnica do site/insights de aplicativos

Question 1

Quando devo usar a lógica nos meus conjuntos de ações?

O conjunto de ações logicis é usado para determinar quando você deseja exibir o Interceptor. Isso pode ser útil para quando você tem vários conjuntos de ações com diferentes condições para exibição.

Por exemplo, uma vez que os criativos não respondem ao tamanho da tela, muitos usuários gostam de implementar uma lógica de conjunto de ações focada em se um visualizador de site está ou não usando um dispositivo móvel ou se o site está sendo exibido em um determinado tamanho de tela. Ao usar a lógica nesta instância, você pode direcionar um criativo formatado e dimensionado adequadamente para a pessoa apropriada.

A lógica de conjunto de ações baseada em localização pode até ser usada para garantir que os visualizadores do site estejam vendo um criativo que está escrito na linguagem que provavelmente se aplica a eles.

Question 2

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.

Question 3

Como posso usar o Website Insights em um aplicativo de página única ou em uma página que executa o Angular JavaScript?

Um aplicativo de página única só executa o código do Website Insights quando a página da Web é carregada pela primeira vez. Quando a página da Web mudar para uma nova exibição, você precisará executar o código do Website Insights novamente. Consulte a página de suporte do aplicativo de página única para obter mais detalhes sobre a configuração e a função.

Question 4

Posso capturar informações dos visitantes do meu site na pesquisa do meu interceptor? Como?

Se você deseja capturar informações dos visitantes do seu site em sua pesquisa, os dados integrados devem ser adicionados a cada conjunto de ações no interceptor.

Além de definir simplesmente um valor estático que você deseja incluir na pesquisa, o menu de dados incorporados também vem pré-criado com outras opções que podem ser levadas para a pesquisa. Por exemplo, você poderá capturar automaticamente o ID do interceptor e do criativo mostrados, o URL da página que exibiu o interceptor, o histórico do site da pessoa ou mesmo quanto tempo foi gasto no site. Você poderá até mesmo capturar informações de um cookie que aparece no navegador da Web dessa pessoa ou pode escrever uma expressão JavaScript que capture uma variável específica na qual você está interessado.

Se você estiver executando uma pesquisa no Qualtrics, também poderá adicionar os dados integrados no Fluxo da pesquisa para salvar essas informações na resposta da pesquisa.

Question 5

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.

Question 6

Qual é a diferença entre cliques e impressões?

As impressões são contadas quando um interceptor é carregado em uma página e aparece para os visitantes do site. Dependendo do criativo, o visitante pode optar por ignorar o interceptor, mas como o visitante o viu, isso conta como uma impressão.

Os cliques são contados quando o participante clica na área de destino de um interceptor ou quando um alvo é carregado. Se, por exemplo, uma pesquisa estiver sendo exibida como um destino incorporado, o destino poderá ser carregado antes que o interceptor seja realmente exibido ao participante. Nesse caso, a contagem de cliques pode aumentar antes que a impressão aumente.

Question 7

Por que meus cliques são iguais/maiores que impressões?

Os cliques podem ser encontrados em impressões iguais em duas situações específicas:

Usando Destinos incorporados: Uma vez que os alvos incorporados fazem com que um alvo seja carregado assim que o criativo aparece (independentemente de quando algo no criativo é clicado), um alvo incorporado geralmente faz com que cliques sejam iguais.
Usando HTTP Redirect Creatives: Como este criativo faz com que o alvo seja carregado cada vez que as cargas criativas, o HTTP Redirect aumentará um clique cada vez que o criativo for carregado.

Os cliques podem até mesmo ser maiores do que impressões quando um alvo incorporado é usado em conjunto com o criativo deslizante. Isso ocorre porque um controle deslizante só incrementa uma Impressão quando ele realmente desliza. O fato de a ficha até aparecer no site, no entanto, significa que o alvo incorporado no criativo está fazendo com que o alvo seja carregado. Por esse motivo, um clique pode aumentar mesmo quando uma impressão não é registrada porque o controle deslizante não foi aberto.

Question 8

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.

Question 9

Qual é a diferença entre exibir Em carregamento, Em foco, Na intenção de saída e Manualmente?

Nas Opções de Interceptor, você encontrará o menu suspenso Exibir Interceptor. Esse menu permite que você decida quando um criativo será exibido depois que a lógica dos conjuntos de ações tiver sido validada com êxito:

On Load: A opção On Load é a opção de exibição mais básica. Com essa opção selecionada, uma interceptor é disparada em uma página válida assim que a própria página é carregada. Isso significa que um visitante do site pode carregar um URL em uma guia separada ou em uma instância do navegador e ter um criativo mostrado a ele sem que ele mesmo o veja.
Em foco: A opção On Focus nos permite garantir de forma mais confiável que um visitante do site esteja ativo em uma página antes de encontrar uma interceptor. Quando uma página é carregada para exibir uma interceptor, a configuração On Focus impede que o script seja executado até que o visitante esteja ativo na página. Isso é determinado pelo movimento e clique do mouse. Isso significa que, se o URL for carregado em uma nova guia, por exemplo, o usuário precisará navegar até essa guia e interagir com a página antes de executar o script. Isso é útil se seus criativos estiverem configurados para serem exibidos em um cronômetro.
On Exit Intent (Intenção de saída): Essa opção tem como objetivo exibir um criativo quando o visitante do site tentar sair do seu site. Quando código de implementação está presente em uma página, podemos detectar o movimento do mouse de um usuário dentro dos limites do navegador. O característica Exit Intent detecta o momento em que um cursor se move para as regiões superiores de um navegador e aciona a interceptor nesse momento. Assim, quando alguém tentar fechar uma guia, você poderá chamar a atenção dessa pessoa.
Manualmente: Essa opção é usada principalmente em configurações de aplicativos de página única. A seleção dessa opção impedirá que qualquer coisa seja exibida automaticamente. Em vez disso, a API do Website Insights deve ser executada pelo próprio site para que o script seja acionado e uma exibição criativo seja exibida. Geralmente, isso é usado quando se deseja que uma interceptor seja acionador quando determinados elementos em uma única página são alterados, como a alteração de valores filtro ou o carregamento de elementos no mesmo URL.

Question 10

Por que nada acontece quando clico no botão no meu criativo? Posso usar meus próprios botões?

Os botões devem ter uma ação associada a eles, seja uma ação de fechamento (fechar o interceptor) ou um destino (aciona a pesquisa a ser exibida).

Se o botão Fechar não estiver funcionando, faça o seguinte:

Na seção Editar criativo, no lado esquerdo, você verá um X para o botão Fechar. Clique aqui para adicioná-lo à sua janela criativa.

Clique duas vezes no botão para editá-lo e pressione backspace para excluir o botão X.

Agora você terá uma caixa vazia. Arraste esta caixa vazia sobre seu "botão Fechar". Agora, quando os visitantes clicarem nessa área, ele fechará o interceptor.

Se sua meta não estiver funcionando:

Clique no destino à esquerda.

Clique duas vezes na nova caixa que aparece e remova o texto.

Agora, arraste a caixa sobre o botão que deve abrir a pesquisa. Clicar nesta área abrirá o alvo (pesquisa, site, etc.).

Question 11

Como tenho um criativo menor em dispositivos móveis?

Se você usar um criativo de diálogo responsivo imediatamente, não precisará se preocupar em fazer esses ajustes, pois eles fazem parte da configuração.

Se você optou por fazer um popover ou um criativo mais antigo, então é aqui que você usaria vários conjuntos de ações. Você terá diferentes conjuntos de ações para dispositivos móveis e desktops. Você também terá dois criativos diferentes para desktop e dispositivos móveis.

No primeiro conjunto de ações, coloque a condição “se o tipo de dispositivo não for móvel”.

Em seguida, adicione um novo conjunto de ações.

Na lógica do conjunto de ações, adicione a condição "se o tipo de dispositivo for móvel".

Agora você terá dois conjuntos de ações diferentes: um para celular e outro para não móvel.

Agora, faça um novo criativo para o conjunto de ações móveis.

Faça o criativo pequeno e amigável ao celular.

Volte para o interceptor e para o conjunto de ações Não móvel.

Sob o criativo deste interceptor, escolha aquele que você acabou de fazer.

Question 12

Como posso me manter atualizado sobre os novos recursos da Qualtrics?

Publicamos notas de versão semanais na Comunidade XM para notificar os clientes sobre os novos recursos da Qualtrics.

Para acessar essas notas de versão, você precisa de uma conta da Comunidade XM. Essas contas são gratuitas para todos os usuários com uma conta Qualtrics. Esta página de suporte contém informações sobre como registrar uma conta da Comunidade XM.

Depois de fazer login na Comunidade XM, vá para a publicação semanal de atualizações do produto. Esta publicação contém todas as informações necessárias para começar a assinar as atualizações do produto.

Question 13

O Web and App Insights pode afetar o SEO do meu site?

Sim, o Web & App Insights pode afetar as classificações de otimização de mecanismos de busca (SEO) do seu site. Consulte esta postagem do blog para obter mais informações.

Documentação técnica do site/insights de aplicativos

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

É seguro?

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

Como o código funciona?

Como faço para implantar um projeto do Website/App Insights?

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

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

3. Use gerenciadores de tags

4. Usar um CSP Nonce

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

O Website / App Insights deixará nosso site mais lento?

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

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

Abrindo a janela de depuração

Interceptações implementadas antes de março de 2019

Interceptações implementadas após março de 2019

Dicas de Solução de Problemas

Lógica Interceptor e lógica de conjunto de ações

Histórico de revisão

Fique atento à solicitação de rede de insights de sites/aplicativos

Procure por outras solicitações de script pendentes que possam estar interferindo em nosso script

Perguntas frequentes

Get the latest news on XM events, research, and product launches