Customer Experience
Employee Experience
Brand Experience
Core XM
Design XM

Transferência de informações por meio de cadeias de consulta

Sobre cadeias de consulta

Uma query string permite que você transfira informações de e para um site da Web simplesmente adicionando, ou “anexando” essas informações ao final de um URL. Essa informação é armazenada na query string e capturada pelo site da Web quando lê o URL.

Os dados podem ser passados para uma pesquisa usando uma string de consulta. Depois de aprovados, os dados podem ser salvos como dados incorporados com a resposta da pesquisa. No final de uma pesquisa, as cadeias de consulta podem ser usadas para transferir dados para outro site ou pesquisa.

Estrutura da cadeia de consulta

Estrutura geral da cadeia de consulta

As cadeias de consulta seguem uma sintaxe muito específica. Eles são adicionados ao final de um URL no formato geral de?FieldName=FieldValue. O FieldName é o nome do seu campo de dados, enquanto FieldValue é o valor de dados específico do seu campo. Vejamos um exemplo de URL com uma string de consulta anexada a ela. A string de consulta está em negrito.

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Fonte=Facebook

Quando um entrevistado responde à pesquisa com o link acima, o campo de dados “Fonte” com um valor de “Facebook” será gravado com a resposta.

Várias cadeias de consulta em um URL

As cadeias de consulta permitem que você transfira várias partes de dados dentro de um único URL. No entanto, quando seu URL contém várias cadeias de consulta, a sintaxe é um pouco diferente. Vejamos uma URL com várias cadeias de consulta anexadas a ela. As cadeias de consulta estão em negrito.

https://survey.qualtrics.com/jfe/form/SV_123456789?Source=Facebook&Campaign=Mobile

A segunda query string começa com um E comercial (&) em vez de um ponto de interrogação (?). Isso porque os URLs só podem suportar um ponto de interrogação. É possível anexar cadeias de consulta adicionais adicionando mais campos no formato de &FieldName=FieldValue.

Atenção: embora não haja limite da Qualtrics para a quantidade de dados que você pode transferir por meio de cadeias de consulta, os navegadores da Web têm limites de comprimento de caracteres de URL. Esses limites variam de acordo com o navegador. Recomendamos que tente manter seus URLs abaixo de 2.000 caracteres. Para obter informações sobre os limites de um navegador específico, consulte a documentação de ajuda do navegador.

Combinação de valores de cadeia de consulta em dados de resposta

Você pode transferir vários valores para o mesmo campo dentro de uma query string. O resultado será um campo combinado em seus dados de resposta, separado por vírgulas.

Por exemplo, se você transferir a seguinte query string:

https://survey.qualtrics.com/jfe/form/SV_9GfoihavJJR5R7U?Client=ATT&Client=Sprint

O resultado será que o campo “Mandante” tem um valor de “ATT, Sprint”.

Como passar informações para uma pesquisa

Você pode usar cadeias de consulta para transferir informações para uma pesquisa Qualtrics. Você pode gravar essas informações como dados integrados e, em seguida, utilizar este campo na lógica de ramificação e de exibição juntamente com a gravação dos dados com a resposta do participante da pesquisa.

Exemplo: você pode usar uma string de consulta para rastrear a partir de qual origem um participante está acessando uma pesquisa. Digamos que você esteja executando uma pesquisa em vários sites de mídias sociais. Se você quiser rastrear quais participantes são provenientes do Facebook e quais são provenientes do LinkedIn, você pode criar 2 links personalizados (cadeias de consulta em negrito).

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Fonte=Facebook

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Fonte=LinkedIn

Essas cadeias de consulta salvarão 2 valores diferentes para o campo “Fonte”. Esses valores são “Facebook” e “LinkedIn”. Em seguida, você pode usar esses dados em seu relatório, transportá-los em perguntas para exibir para seus entrevistados e basear a ramificação e exibir lógica nele para mostrar ou ocultar perguntas relevantes.

O envio de informações para uma pesquisa por meio de cadeias de consulta requer uma configuração de 2 partes. A primeira parte consiste em anexar dados ao URL com cadeias de consulta, e a segunda parte consiste na criação de elementos de dados integrados em seu fluxo de pesquisa para capturar as informações a partir do URL.

Parte 1: Anexar dados a um URL de pesquisa

Copie o link anônimo da sua pesquisa e cole-o em um editor de texto, como Word ou Notepad.
```
https://survey.qualtrics.com/jfe/form/SV_123456789
```
Adicionar um ponto de interrogação (?)até o final do URL.
```
https://survey.qualtrics.com/jfe/form/SV_123456789?
```
Digite o nome do campo Dados integrados (por exemplo, “estado” ou “cidade”) após o ponto de interrogação.
```
https://survey.qualtrics.com/jfe/form/SV_123456789?cidade
```

Adicionar um sinal de igual (=)

https://survey.qualtrics.com/jfe/form/SV_123456789?cidade=

Digite o valor do campo (por exemplo, “Utah” ou “Provo”)
```
https://survey.qualtrics.com/jfe/form/SV_123456789?cidade=Provo
```
Para qualquer campo adicional que você queira adicionar, repita as etapas de 2 a cinco usando um E comercial (&) em vez de um ponto de interrogação (?).
```
https://survey.qualtrics.com/jfe/form/SV_123456789?city=Provo&state=Utah
```

Parte 2: Capturando informações de um URL como dados integrados

Ao editar sua pesquisa, navegue até Fluxo de pesquisa clicando no ícone de fluxo da pesquisa na barra de navegação à esquerda.
Clique em Adicionar um novo elemento aqui.
Selecione o Dados integrados elemento.
Insira o nome dos campos que você gostaria de capturar do URL. Não atribua um valor para esses campos. Para esses campos, o valor deve ser lido e definido a partir do painel ou do URL.

Qdica:A capitalização de seus campos é importante! Verifique se os campos em seu fluxo de pesquisa correspondem à capitalização dos campos em seu URL.
Mova o elemento de dados integrados para a parte superior do fluxo da pesquisa. Isso é especialmente importante se você quiser usar os campos de dados integrados na lógica ou exibir os valores com texto transportado. O elemento de dados incorporado deve aparecer antes dos elementos no fluxo da pesquisa que o referenciam.

Exemplo: no bloco de perguntas Introdução, queremos inserir o valor de “cidade” em algum texto da pergunta. Portanto, precisamos mover o elemento de dados incorporado para antes do bloco de perguntas Introdução no fluxo da pesquisa.

Como transmitir informações de uma pesquisa

Você pode passar informações de uma pesquisa para outro site ou de uma pesquisa para outra pesquisa anexando informações ao URL de redirecionamento. Isso geralmente é feito ao trabalhar com um fornecedor de painel de terceiros.

Atenção: o destino de redirecionamento precisa ser configurado para aceitar as informações transferidas no URL. Caso contrário, as informações aprovadas não serão capturadas. Consulte passando informações para uma pesquisa acima para saber como configurar uma pesquisa para aceitar informações transmitidas no URL.

Para transmitir informações de uma pesquisa

Gere o código de texto transportado para cada parte de dados que você deseja transmitir (por exemplo, respostas a perguntas da pesquisa, dados integrados ou qualquer outra informação coletada com a resposta). Copie esses códigos e grave-os para mais tarde.
Exemplo: queremos transmitir a resposta do entrevistado para duas de nossas perguntas da pesquisa. O texto transportado para nossas perguntas de pesquisa selecionadas são ${q://QID7/ChoiceGroup/SelectedChoices} e ${q://QID3/ChoiceGroup/SelectedChoices}.
Copie o URL de redirecionamento. Este é o URL para o qual você deseja enviar os entrevistados da pesquisa e será o site que captura as informações.
Exemplo: estamos redirecionando de uma pesquisa da Qualtrics para um fornecedor de painéis de terceiros, então nosso URL é https://www.survey.panelcompany.com
Adicionar um ponto de interrogação (?) até o final do URL.
```
https://www.survey.panelcompany.com?
```
Digite o nome da variável que você deseja transferir.
```
https://www.survey.panelcompany.com?Q7Answer
```
Adicione um sinal de igual (=) ao final do URL
```
https://www.survey.panelcompany.com?Q7Answer=
```

Cole o código de texto transportado para o valor da variável.

https://www.survey.panelcompany.com?Q7Answer=${q://QID7/ChoiceGroup/SelectedChoices}

Repita as etapas 3 a 6 para quaisquer variáveis adicionais que você queira passar. Utilizar um E comercial (&) em vez de um ponto de interrogação (?) para variáveis adicionais.
```
https://www.survey.panelcompany.com?Q7Answer=${q://QID7/ChoiceGroup/SelectedChoices}&Q3Answer=${q://QID3/ChoiceGroup/SelectedChoices}.
```
Cole o URL preenchido da etapa 7 na área de encerramento da pesquisa apropriada (por exemplo, elemento de fluxo de pesquisa ou padrão).
Qdica: Você tem uma query string que parece não estar funcionando? Isso pode ter a ver com o modo como seu texto transportado é formatado. O melhor a fazer é adicionar ‘?format=urlencode’ ao final dos valores de texto transportado, antes do último colchete. Isso garante que valores com espaços e caracteres especiais sejam transferidos corretamente para a query string. Por exemplo, puxe dados integrados chamados Departamento em sua query string usando ${e://Field/Department?format=urlencode} em vez de ${e://Field/Department}. No entanto, não adicione format=urlencode aos campos Email. Isso converterá o símbolo @ para %40.

Depois de fazer seu link de redirecionamento, você precisará garantir que seu site de redirecionamento possa capturar as informações das cadeias de consulta. Se você estiver redirecionando para uma pesquisa da Qualtrics, os detalhes sobre como preparar sua pesquisa para capturar as informações podem ser encontrados na Parte 2 da seção acima.

Adição de cadeias de consulta a links enviados por e-mail

Alguns dos editores de e-mail da Qualtrics contêm texto transportado para o link da sua pesquisa em vez do próprio link da pesquisa. Isso inclui convites de pesquisa enviados por e-mail juntamente com a tarefa do XM Directory. Você pode adicionar strings de consulta ao texto transportado para esses links, de modo que as strings de consulta sejam adicionadas ao link quando o e-mail for enviado. Um desses cenários em que isso é útil é se você estiver enviando muitas distribuições semelhantes e quiser rastrear quais respostas vêm de qual distribuição. Etapas extras precisam ser executadas para garantir que seu link esteja criado e com hiperlink adequado nos seus e-mails da Qualtrics.

Abra o editor de e-mail e comece a compor uma mensagem. Pode ser o editor de e-mail para convites para pesquisas por e-mail ou a tarefa do XM Directory.
Se sua mensagem já tiver código de texto transportado para uma pesquisa, exclua o código. O código de texto transportado do link da pesquisa geralmente está no formato ${l://SurveyURL}. Fazemos isso para garantir que o link que criamos não tenha erros.
Clique no ícone de texto transportado {A} e selecione Links de pesquisa → URL da pesquisa.
Crie seu link usando as instruções da Parte 1 de transferência de informações para uma pesquisa. O código de texto transportado que você inseriu atuará como URL.
Qdica: ao criar suas cadeias de consulta, certifique-se de usar um & para cada string, pois o link de pesquisa individual já conterá cadeias de consulta.

Exemplo: digamos que estamos enviando uma pesquisa em ondas e queremos acompanhar de qual onda um entrevistado fazia parte. Nosso URL no editor de e-mail será ${l://SurveyURL}&Wave=wave1

Qdica: Você também pode usar texto transportado para variáveis e valores de string de consulta. No entanto, para garantir que seus valores transportados estejam codificados corretamente, você precisa adicionar &format=urlencode ao final dos valores de texto transportado, antes do último colchete. Isso garante que valores com espaços e caracteres especiais sejam transferidos corretamente para a query string. Por exemplo, extraia dados integrados chamados Departamento em sua query string usando ${e://Field/Department&format=urlencode} em vez de ${e://Field/Department}. No entanto, não adicione format=urlencode aos campos Email. Isso converterá o símbolo @ para %40. Além disso, não adicione format=urlencode ao texto transportado para o URL da pesquisa.
Copie o link recém-criado e destaque o link no editor de mensagens.
Clique no botão hyperlink.
Na caixa URL, cole o link copiado.
Modifique o protocolo para <other>.
Se desejar, altere o Texto de exibição do link, por exemplo, “Clique aqui para responder à pesquisa”.
Clique em OK.

Como usar Q_EED

O Q_EED pode ser utilizado como um parâmetro de URL para transferir parâmetros de dados integrados ocultados (ou codificados em Base64). Um dos casos de utilização mais comuns é transferir dados JSON em um formato binário por meio de um URL.

No exemplo abaixo, comunicaremos o sexo (masculino) e a idade (32) de um entrevistado em uma pesquisa da Qualtrics usando Q_EED anexado ao final de um link da pesquisa como uma string de consulta.

Adicione os dados integrados Sexo e Idade ao Fluxo da pesquisa.
Escreva as informações que você deseja transferir no formato JSON. Por exemplo:
```
{"Sexo":"Masculino","Idade":32}
```
Agora, Base64 codifica todo o formato JSON, do parêntese ao parêntese. Depois de codificado, o JSON da etapa 2 tem o seguinte aspecto:
```
eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==
```
Adicione a cadeia da etapa 3 como o valor do campo Q_EED:
```
Q_EED=eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==
```
Obtenha o URL da sua pesquisa.
Se o URL tiver um ponto de interrogação (?) Em qualquer lugar nele, adicione um E comercial (&) ao final. Se não houver ponto de interrogação, adicione um ponto de interrogação (?) até o fim.

Adicione o resultado da etapa 4 ao final do URL. Agora, deve ter o seguinte aspecto:

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Q_EED=eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==

Qdica: Não varie a ortografia, a pontuação ou a sensibilidade de maiúsculas/minúsculas das suas variáveis. Se o fluxo de sua pesquisa diz “Sexo”, o G deve ser sempre capitalizado para codificar com sucesso e, em seguida, transferir essa informação.

Aviso: para fins de segurança, as strings codificadas não podem conter sinais de mais ( + ), ou os dados integrados não serão registrados. Em vez disso, use hifens ( – ).

Como usar Q_PopulateResponse

Q_PopulateResponse é usado como um parâmetro de URL para preencher previamente as respostas da pesquisa.

Os valores são transferidos pelo URL como campos formatados em JSON:

YourSurveyURL?Q_PopulateResponse={"QID1":"6","QID2":"4","QID3":"este é o meu texto","QID4":"1"}

Se você quiser canalizar as respostas do ano passado às pesquisas deste ano, pode carregar as respostas como dados integrados em uma lista de contatos e, em seguida, configurar um link individual personalizado que faça referência a essas respostas. Primeiro, escreva algum texto clicável em seu e-mail de distribuição, depois obtenha o texto transportado para o URL da pesquisa e use o botão de link no editor de conteúdo avançado para vincular a algo como este:

${l://SurveyURL}?Q_PopulateResponse={"QID1":"${e://Field/QID1}","QID2":"${e://Field/QID2}","QID3":"${e://Field/QID3}"}

Este exemplo está referenciando os campos de contato QID1, QID2 e QID3. Certifique-se de codificar as aspas (“) com %22, mas não codifique a string inteira do URL, pois ela desativará o texto transportado.

Este link preencherá as respostas do ano passado. Se a pessoa alterar algumas dessas respostas padrão e depois sair da pesquisa, quando ela entrar novamente na pesquisa, a gravação mais recente substituirá o que o URL afirma que deve ser preenchido. Além disso, se houver lógica de exibição em uma pergunta, ela preencherá essa pergunta, mas não será registrada a menos que a pessoa escolha a lógica correta que exibirá essa pergunta.

Qdica: consulte as perguntas frequentes na parte inferior da página para obter ajuda com a formatação JSON.

Casos de Utilização Mais Comuns

Abaixo estão alguns casos de uso comuns da Qualtrics que usam cadeias de consulta. Visite as páginas vinculadas para obter mais informações.

Perguntas frequentes

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.