Condições do site
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 seu executivo 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 as condições do site
Às vezes, você tem mais informações armazenadas sobre um visitante que gostaria de utilizar em sua lógica. Nesta seção, você aprenderá sobre as condições do site. Essas condições podem se basear em valores de cookie, expressões JavaScript, HTML no site e muito mais.
Adobe Analytics
O Adobe Analytics pode ser usado para exibir um criativo com base no valor da variável do Adobe Analytics. Para usar essa condição, o site precisa estar previamente integrado ao Adobe Analytics. Para obter mais informações, consulte a Extensão Adobe Analytics.
Definindo uma condição no Adobe Analytics
Camada de dados do Adobe
O Adobe Data Layer pode ser usado para exibir um anúncio com base no valor de uma variável Adobe Data Layer. Para utilizar essa condição, o site precisa ter uma Adobe Data Layer. Para obter mais informações, consulte a documentação Adobe sobre como criar uma camada de dados.
Definindo uma condição da Adobe Data Layer
Cookie
O valor do cookie pode ser usado para exibir um anúncio se um cookie armazenado no navegador do visitante contiver um valor que você especificar. Por exemplo, se você armazenar um cookie chamado “Visitante Recorrente” com o valor “True” caso o visitante seja um visitante recorrente e “False” caso seja um novo visitante, você poderá optar por direcionar a campanha apenas para aqueles que são visitantes recorrentes.
Qdica: as restrições de segurança do navegador limitam o Feedback do site a ver apenas os cookies salvos pelo seu site. Os cookies armazenados por outros sites não poderão ser acessados.
Atenção: o Feedback do site e outros scripts do lado do cliente não conseguem ler cookies com o atributo “HttpOnly” definido. Consulte esta página para obter mais informações.
Aviso: Os recursos de codificação personalizada são fornecidos no estado em que se encontram e podem exigir conhecimento de programação para serem implementados. Nossa equipe de suporte não oferece assistência nem consultoria em codificação personalizada. Em vez disso, você pode perguntar para nossa comunidade de usuários dedicados. Se quiser saber mais sobre nossos serviços de codificação personalizada, entre contato seu executivo Conta Qualtrics.
Para criar uma condição de Cookie
Monitoramento de evento
Com o rastreamento de evento, você pode ouvir eventos específicos em seu site, além das páginas que o visitante viu. Os eventos podem incluir ações do visitante, como baixar um extrato mensal em um site de banco, clicar para conversar com um agente ao vivo em um site de comércio e muito mais.
Para saber como configurar o Rastreamento de Eventos, consulte a página de suporte indicada no link.
Para criar uma condição de rastreamento Evento
HTML no site
As condições de HTML no site podem ser usadas para ler o HTML da página e exibir um criativo se um elemento HTML contiver um valor que você especificar. Por exemplo, se você quisesse destino os visitantes que têm dois ou mais itens no carrinho de compras, poderia usar o ID do elemento do carrinho de compras para basear sua lógica no fato de esse elemento conter um número maior ou igual a 2.
Neste exemplo, determinamos que queremos mostrar um criativo se houver 2 ou mais itens no carrinho de compras. Observando o HTML desse botão, determinamos que o ID do elemento HTML que contém o número de itens no carrinho é qty-in-cart.
Qdica: Se o elemento que você precisa selecionar não tiver um atributo ID e você não conseguir adicionar um, considere selecionar esse elemento usando a condição “Expressão JavaScript”:
document.getElementsByClassName('qty-in-cart')[0];Por exemplo, se o carrinho de compras não tivesse um ID, mas tivesse a classe “qty-in-cart” e fosse o primeiro elemento com essa classe na página, então essa expressão JavaScript poderia ser usada para selecioná-lo.
Para criar HTML na condição do site
Expressão JavaScript
Essa condição pode ser usada para exibir um criativo dependendo do valor de uma expressão JavaScript. Muitas vezes, os sites armazenam informações sobre seus visitantes em variáveis JavaScript. Por exemplo, uma variável pode armazenar se o visitante é um cliente atual ou um cliente potencial.
Neste exemplo, uma variável chamada navigator.language armazena as configurações de idioma dos visitantes. Esse interceptor mostrará um criativo se ele estiver usando o navegador em inglês.
Qdica: Não tem certeza de quais dados estão disponíveis em seu site por meio de uma expressão JavaScript? Verifique com sua equipe da Web.
Para criar uma condição expressão JavaScript
Camada de dados do Google
Essa condição pode ser usada para exibir um anúncio, dependendo do valor armazenado em uma Camada de Dados do Google. Muitas vezes, os sites armazenam informações sobre seus visitantes em variáveis da camada de dados. Por exemplo, uma variável pode armazenar se o visitante é um cliente atual ou um cliente potencial. O Qualtrics pode recarregar à medida que essas variáveis são atualizadas, permitindo a segmentação em tempo real.
Neste exemplo, uma variável chamada navigator.language armazena as configurações de idioma dos visitantes. Esse interceptor mostrará um criativo se ele estiver usando o navegador em inglês.
Qdica: Não tem certeza de quais dados estão disponíveis em seu site por meio de um Google Data Layer? Verifique com suas equipes da Web ou de análise.
PARA CRIAR UMA CONDIÇÃO CAMADA DE DADOS DO GOOGLE
Perguntas frequentes
Quando devo usar a lógica nos meus conjuntos de ações?
Quando devo usar a lógica nos meus conjuntos de ações?
Por exemplo, como os elementos criativos não se adaptam ao tamanho da tela, muitos usuários preferem implementar uma lógica conjunto de ações baseada no fato de o visitante do site estar ou não usando um dispositivo móvel, ou se o site está sendo exibido em um determinado tamanho de tela. Ao aplicar a lógica nesse caso, você consegue direcionar um anúncio com formatação e tamanho adequados à pessoa certa.
A lógica Conjunto de ações baseada na localização pode até mesmo ser usada para garantir que os visitantes do site vejam um anúncio redigido no idioma que provavelmente seja mais adequado para eles.
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?
- 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: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.
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.
Isso é ótimo! Obrigado pelo seu feedback!
Obrigado pelo seu feedback!