Dados integrados em insights de site/app

Sobre dados integrados em insights de site/app

Qualquer informação que possa ser rastreada pelo Website / App Insights também pode ser enviada para o seu site ou pesquisa de destino. Por exemplo, se sua meta for uma pesquisa de satisfação do site, você pode optar por salvar informações sobre quanto tempo o participante esteve no site ou quantas páginas visitou. Essas informações não são salvas dentro do interceptor ou criativo em si, mas são transferidas para o seu site ou pesquisa.

Você pode passar informações para pesquisas ou para seu site definindo dados integrados. Os dados integrados são variáveis personalizadas que podem ser nomeadas e definidas como iguais aos valores que você desejar. Por exemplo, você pode ter um dado incorporado chamado Localização que pode ter um valor de Estados Unidos, Canadá, Irlanda, etc.

When is Embedded Data Captured?

By default, embedded data is captured immediately before the survey is displayed to the respondent.

However, certain creative types and configurations change this behavior:

• Botão de feedback: Embedded data is collected when the feedback button is clicked by the site visitor.
• Caixa de diálogo de respostas: The “display survey directly in dialog” option changes how embedded data is collected:
  • When enabled, the survey is embedded directly in the creative, and embedded data is captured as soon as the creative loads.
  • When disabled, the creative displays a button to open a new window for the survey, and data is captured when this new window loads.
• Creative Targets: For custom embedded feedback, pop over creatives, pop under creatives, slider creatives, and info bar creatives, the creative target controls how embedded data is collected:
  • Embedded survey: When the survey is embedded in the creative, embedded data will be captured as soon as the creative is displayed.
  • Linked survey: When the survey is opened by a link or button, embedded data will be captured when the link or button is clicked.
    Qtip: For pop under creatives, if the survey session starts on page change or site exit, then embedded data will be captured before the pop under window is opened.
• Templated embedded feedback: As soon as the first question in the templated embedded feedback creative is submitted, embedded data will be captured. For example, an embedded feedback creative that asks a “Was this helpful” question followed by a free-form input question will capture embedded data once the user clicks “Yes” or “No” to the first question.

Updating Embedded Data After Opening the Survey

Some creatives will continuously update embedded data if it is updated on your website while the intercept survey is open. For example, if the intercept triggers a survey to open in a new window, and the site visitor navigates to a new page on your site, then the embedded data that is associated with that open survey session will be updated to reflect that new page.

Additionally, intercepts are not the only way to collect embedded data. Embedded data values are collected in the following order:

1. Intercept embedded data is collected first. See the When is Embedded Data Captured? section for specific information depending on the intercept’s creative.
2. Survey flow embedded data is collected after the survey response is submitted. Consulte Dados integrados para obter mais informações.
3. XM Directory embedded data is applied last, if the intercept is linked with XM Directory and the contact already exists in the directory.

If there are any identical embedded data keys in these 3 steps, then the values that are collected last will be recorded in the survey response. For example, if a field called “customerId” is set by the intercept, survey flow, and XM Directory, then the XM Directory contact value will be saved for the “customerId” in the survey response.

Configuração de dados integrados

Geralmente, você especifica dados integrados para ações individuais em seu interceptor. Por exemplo, digamos que você esteja randomizando dois conjuntos de ações diferentes. Em uma ação, você pode adicionar um campo de dados incorporado chamado “Condição” com um valor de “Versão 1” e, em outra ação, você pode adicionar um campo de dados incorporado chamado “Condição” com um valor de “Versão 2”.

Para definir dados integrados em qualquer ação

1. Em qualquer ação, clique em Opções.
   
2. Selecione Dados integrados.
3. Insira um nome para seu primeiro campo de dados integrados.
   
4. Selecione o tipo de valor.
   Qdica: um valor estático significa que o valor do campo de dados incorporado será o mesmo para cada visitante que recebe esta ação (por exemplo, atribuindo 1 ação “Condição” com um valor de 1 e a outra “Condição” com um valor de 2). As outras opções de valor de dados incorporados são dinâmicas, o que significa que elas se ajustarão dependendo do visitante em particular (por exemplo, qual página o visitante estava visualizando quando viu o criativo).
5. Se um campo for fornecido, insira um valor para seus dados integrados.
   
6. Se você quiser adicionar outros campos de dados integrados, clique no sinal de mais (+) à direita do seu primeiro campo e repita as etapas 4 a 6.
7. Clique em Salvar.

Vários campos de dados integrados

Há um limite de 20 KB para salvar dados integrados. Determinados campos (como Histórico do site registrado) terão mais desse espaço do que outros. Se não houver espaço suficiente para enviar todos os campos de dados integrados para o site de destino, os campos na parte superior da lista serão priorizados.

Você pode definir a prioridade dos campos de dados integrados simplesmente clicando nos pontos à esquerda de qualquer campo e movendo o item para cima ou para baixo na lista.

Configuração de dados integrados para um criativo

As etapas acima descreveram como salvar dados incorporados para uma ação específica. No entanto, se você quiser que todas as ações que usam um determinado criativo tenham os mesmos dados incorporados, você também pode definir dados incorporados no próprio criativo. As etapas serão exatamente as mesmas, mas você encontrará o menu de dados integrados clicando com o botão direito no destino do seu criativo, clicando na seta suspensa na barra de ferramentas acima e selecionando Dados integrados.

Isso também pode ser encontrado na seção Editar do seu criativo.

Definindo dados integrados para vários destinos com JavaScript

Às vezes, você pode querer definir valores de dados integrados em várias imagens ou destinos em seu criativo; no entanto, o campo de dados incorporado não pode ter vários destinos no criativo. O que você pode fazer para capturar e transmitir informações é usar JavaScript para criar vários campos de dados integrados que cada um tem seu próprio valor.

<div onclick="window._qLastClicked = 'Happy';">

In order to allow the greatest flexibility when passing embedded data and choosing targeting conditions for displaying intercepts, Qualtrics leverages the browser’s built-in eval functionality for JavaScript expressions. If your site’s security policy does not permit the use of eval, you may see an error like “Refused to evaluate a string as JavaScript because ‘unsafe-eval’ is not an allowed source of script in the following Content Security Policy directive” in your browser console.

If you see that error and you are unable to update your site’s Content Security Policy settings, you’ll need to work with your engineering team to run the following code block before Qualtrics loads:

window.QSI = window.QSI || {};
window.QSI.config = window.QSI.config || {};
window.QSI.global = window.QSI.global || {};
window.QSI.config.enableSecureVariables = true;
window.QSI.global.enableJSSanitization = true;

After you run this code block, you’ll be able to use a limited subset of JavaScript in your targeting conditions and embedded data fields. This subset of JavaScript only permits variable access using dot (“.”) and bracket (“[]”) operators, which will allow you to gather variable context without worrying about security concerns around function execution. You cannot use function calls, such as document.querySelector().

Tipos de valor de dados integrados

Ao definir o valor de seus dados integrados, você escolhe o tipo de variável que esses dados integrados representam. Abaixo, você encontrará uma explicação sobre o que cada tipo de dados incorporados captura e as condições de interceptação relacionadas.

• Estático: criar dados integrados personalizados e definir seus valores.
• ID de interceptor: isso captura o ID interno do interceptor. Esse ID pode ser usado para ver qual interceptor um visitante viu se você tiver vários interceptores vinculados de volta ao mesmo site/pesquisa.
• ID do criativo: isso captura a ID interna do criativo. Esse ID pode ser usado para ver qual criativo um visitante viu se você tiver vários criativos vinculando novamente ao mesmo site/pesquisa.
• Histórico do site registrado: isso captura todos os sites que seu visitante visitou que têm o código do projeto na página. Essas informações são armazenadas em um cookie, que o Website / App Insights coloca no navegador.
  Qdica: A quantidade de histórico registrada depende dos limites colocados neste cookie. O limite é definido na página Admin.
• Rastreamento de eventos: permite que você configure o rastreamento de eventos.
• Adobe Analytics: consulte o Adobe Analytics.
• ID da Adobe Experience: consulte o Adobe Analytics.
• Contagem exclusiva da página visitada: isso captura o número de páginas diferentes que o usuário visitou em seu site. Por exemplo, visitar a mesma página duas vezes conta como 1 página. Consulte Condições de contagem de página.
• Contagem total de páginas visitadas: isso captura o número total de páginas que o usuário visitou em seu site. Consulte Condições de contagem de páginas.
• O tempo gasto no local: o tempo gasto no local registra 2 métricas: o tempo gasto no local e o tempo focado no site. O tempo gasto no site indica por quanto tempo o visitante abriu seu site em uma janela do navegador. Time Focused On Site refere-se a quanto tempo o visitante tem seu site aberto como a janela frontal, “em foco” em seu computador.  Consulte Tempo gasto no site ou tempo focado no site.
  Qdica: em seus dados, o Tempo gasto no local e o Tempo focado no local serão salvos juntos como 2 números separados por uma linha vertical. O número no lado esquerdo da linha é o tempo gasto no local, enquanto o número à direita da linha é o tempo concentrado no local.
  
• URL da página atual: a página em que o visitante está quando o interceptor aparece. Consulte URL da página atual.
• HTML no site: especifique o HTML na página para a qual você deseja capturar o valor. Por exemplo, você pode ter um elemento para seu carrinho de compras e desejar saber quantos itens estão no carrinho de visitas. Consulte HTML no site.
• Valor do cookie: Capture o valor de um cookie específico em seu site. Por exemplo, você pode ter um cookie chamado return_visitor que captura se alguém visitou seu site antes ou não. Consulte Condição do cookie.
• Parâmetro de URL: se o seu site da Web tiver parâmetros adicionados aos URLs, esta opção permite que você capture o valor de qualquer parâmetro que desejar.
• URL Regex: isso captura a codificação Regex.
  Qdica: Regex é um recurso de codificação personalizada. Infelizmente, o Suporte da Qualtrics não pode aconselhar você sobre codificação personalizada. Ao invés disso, você pode perguntar para nossa comunidade de usuários dedicados.
• Valor de JavaScript: esta opção captura o JavaScript personalizado de seu site. O valor especificado precisa ser uma expressão/chamada JavaScript.
  Qdica: JavaScript é um recurso de codificação personalizada. Infelizmente, o Suporte da Qualtrics não pode aconselhar você sobre codificação personalizada. Ao invés disso, você pode perguntar para nossa comunidade de usuários dedicados.
• Referenciador da página: a página em que o visitante estava antes de chegar à página com seu interceptor. Consulte Indicador da página.
• Referenciador do site: O site em que o visitante esteve antes de chegar em seu site. Consulte Referenciador do site.
• Critério de pesquisa: Captura o termo que o visitante procurou para chegar ao seu site. Consulte Critério de pesquisa.
• Valor da camada de dados do Google: essa opção captura variáveis personalizadas da camada de dados do Google do seu site. Consulte Utilizando o Google Analytics em Insights de site/app.

Salvando dados integrados em uma pesquisa do Qualtrics

Se o seu destino for uma pesquisa do Qualtrics, os dados integrados enviados para ela estarão disponíveis para uso na lógica de pesquisa sem necessidade de mais ações. No entanto, se você quiser salvar esses dados integrados nos resultados da pesquisa, precisará adicioná-los ao seu fluxo de pesquisa.

Siga as etapas na página de suporte a dados integrados para adicioná-la ao seu fluxo de pesquisa. Para o valor do campo, deixe-o como O valor será definido a partir do painel ou do URL.

Uso de dados integrados com outros destinos

Mesmo que sua meta não seja uma pesquisa da Qualtrics, você ainda pode aproveitar os dados integrados e passar as informações, como faria com uma pesquisa da Qualtrics. Os dados integrados serão passados no corpo da solicitação (método POST), para que você possa capturar e enviar vários elementos de dados integrados para a plataforma Qualtrics XM sem ter que vê-los no URL visível da pesquisa.

Testing Embedded Data Collection

You can test what embedded data has been collected by running this snippet in the developer console when you would expect embedded data values to be collected by the intercept:

window.QSI.EmbeddedData.getEmbeddedData('YOUR_INTERCEPT_ID')

If the values that are collected are not what you expect or are empty, troubleshooting depends on what type of embedded data you expect to collect:

1. Static: If there are missing or incorrect Static embedded data fields, then you may need to publish the latest version of the intercept.
2. Google Data Layer: If there are missing or incorrect Google Data Layer embedded data fields, then you may have the wrong data layer expression. Alternatively, the value may have been overwritten by a subsequent data layer update. Qualtrics only tracks the latest value in the data layer. See Using Google Analytics with Website/App Insight for more information on integrating the Google Data Layer with an intercept.
3. JavaScript: If there are missing incorrect JavaScript embedded data fields, then you may have the wrong expression. Please work with your development team to confirm that the variable you are looking for is present on the page you are testing.

Troubleshooting Empty or Incorrect Embedded Data in Survey Responses

If the variables do appear when testing, but not in the actual survey response, then there could be a timing issue between when Qualtrics grabs the data and when the data is actually available on the page.

Follow the below steps to troubleshoot:

1. Reload the page and then test your embedded data using the code snippet in the section above.
2. Run the following code in your browser console:
   QSI.API.unload();
QSI.API.load().then(QSI.API.run);
3. Take the survey.
4. A HTTPS request will appear in the website’s network log when a survey session starts via an intercept. This request includes the survey ID and any mapped embedded data from the intercept configuration. Checking the payload of this request can help verify if the session began with embedded data.

If the correct values are now being passed, then this is likely a timing issue and you will need to trigger your intercept after the data values are populated on your page. This can be done via the QSI.API calls, or through using a tag manager. See Project Deployment Code for more information.

Exibindo dados integrados do interceptor em um painel

Você pode querer exibir seus Web / App Insights em um dashboard CX. Esta seção aborda as etapas gerais sobre como exibir seus dados integrados em um formato legível.

1. Na sua lógica de interceptação, adicione os campos de dados integrados que deseja exibir em seu painel.

   Qdica: Os campos comuns incluem:

   • ID do interceptor: para exibir o ID ou nome do interceptor.
   • ID do criativo: para exibir o ID ou nome do criativo.
   • Valor de JavaScript: para exibir dados de uma expressão JavaScript.
   • Variáveis do Adobe Analytics: para exibir dados de eVars personalizados do Adobe Analytics.
   • Valor estático: para transferir um valor personalizado, como o nome do interceptor, o nome criativo ou informações sobre seu site.
2. Na pesquisa exibida em seu interceptor, adicione campos de dados integrados que correspondam aos campos do interceptor.
   
3. Mapeie sua pesquisa para um dashboard CX, certificando-se de incluir seus campos de dados integrados.
4. Se estiver exibindo um campo como ID do interceptor ou ID do criativo, você poderá recodificar sua ID para que ela exiba o nome do interceptor ou do criativo.
   Exemplo: no exemplo acima, exibimos dados de 2 criativos diferentes no mesmo dashboard. Para tornar a visualização de dados de criativos individuais fácil de usar, adicionamos ID do criativo como um campo de dados incorporado e recodificamos os valores de ID individual como nomes criativos. Em seguida, podemos adicionar esse campo como um filtro de dashboard e usar esse campo em widgets.

Perguntas frequentes