Painel de integração
From LimeSurvey Manual
Os exemplos e as explicações a seguir são baseados inteiramente em contribuições de nossos usuários. Sinta-se à vontade para contribuir se quiser ajudar a ampliar nosso conhecimento aberto sobre a integração de painéis.
Introdução
Nesta aba, você pode definir os parâmetros de URL que serão aceitos pelo seu inquérito. (Esses parâmetros serão anexados à URL geral de início do inquérito.) Esta opção é importante se você quiser integrar seu inquérito a um provedor profissional de painéis de pesquisa que fornece os participantes para você. Normalmente, o provedor informa o ID único de cada participante do inquérito, e você precisará salvar esses IDs únicos para referência futura.
Atenção : Com alguns provedores, o ID único do participante que for excluído devido a um limite de cota, ou ao concluir o inquérito, precisa ser enviado de volta ao provedor do painel na URL final do inquérito ou na URL da cota.
Painel de integração do inquérito: Menu da pesquisa > Menu da pesquisa > Painel de integração
Painel de integração do inquérito
Será exibida uma tabela vazia com a opção que permite incluir um parâmetro URL.
Dois campos precisam ser preenchidos:
- Parâmetros: Digite neste campo o nome do novo parâmetro.
- Questão alvo: O valor do parâmetro é sempre salvo na sessão do inquérito, mesmo que você não defina uma questão alvo aqui. Aqui, você pode selecionar uma pergunta do tipo 'Texto curto' ou 'Textos múltiplos'.
Se você não salvar o valor do parâmetro de URL, ainda poderá usar esse parâmetro na URL final. Para mais informações, continue lendo a seção da wiki sobre a URL final.
Como usar a função de painel de integração
Um exemplo simples é apresentado abaixo para explicar como usar a função de painel de integração.
1) Primeiro, crie uma pergunta de texto livre curto/longo e dê a ela o nome que quiser (usaremos "LS" para o campo Código da pergunta). Em seguida, ative a opção Sempre ocultar esta questão, localizada na aba Mostrar dentro do menu da pergunta.
2) Vá para a aba do painel de integração e clique em "Incluir parâmetro URL".
Selecione a pergunta de texto curto/longo que você criou no primeiro passo. Os participantes que vierem do respectivo provedor profissional de painéis chegarão à questão alvo. Ela pode ficar oculta para que os participantes possam começar a responder ao inquérito.
O nome que você escolher para o parâmetro terá de ser incluído na hiperligação de entrada que você fornecerá depois ao seu provedor de painel. Em nosso exemplo, ele se chamará "LSid". Não se esqueça de clicar no botão Salvar, localizado na parte superior direita da tabela!
3) Agora, você precisa configurar a hiperligação de entrada que enviará ao seu provedor de painel. Para obter a hiperligação da URL do seu inquérito, clique no botão Visualizar questionário.
Copie a URL acessada na barra de endereços:
Dica: O parâmetro "newtest" é usado para reinicializar a sessão. Isso é útil quando você deseja testar localmente a integração de painel ou quando sabe que seus participantes usam o mesmo dispositivo/navegador para responder ao inquérito. Assim, adicionar "newtest=Y" à URL do inquérito cria novas respostas na tabela de respostas, forçando a criação de uma nova sessão, independentemente do dispositivo/navegador utilizado.
Adicione ao final o parâmetro recém-criado: &LSid="xxxxxx". A hiperligação deve ficar assim:
http://localhost/index.php/369498?newtest=Y&lang=en&LSid="xxxxxx"
Dica: Os parâmetros GET usam "?" para o primeiro parâmetro e "&" para os demais. Se você já tiver "?" na sua URL, deve usar "&" para adicionar outros parâmetros GET. Leia sobre os parâmetros GET e seu uso aqui.
O que quer que você coloque no lugar de "xxxxxx" será armazenado na pergunta de texto livre curto/longo quando o respondente chegar a essa página. Por exemplo, enviei a um usuário o seguinte link:
http://localhost/index.php/369498?newtest=Y&lang=en&LSid=ABCD5
A string após LSid foi armazenada como resposta à pergunta de texto curto/longo.
Leia a seção da wiki Campos de URL para obter mais informações sobre a personalização de URLs.
Exemplos
Os exemplos a seguir foram criados para ajudar você a adicionar:
- Redirecionamentos caso os respondentes tenham terminado de preencher o inquérito;
- Redirecionamentos caso os respondentes tenham sido excluídos devido a uma quota;
- Redirecionamentos caso o limite da quota tenha sido atingido.
Nota: parametername={PASSTHRU:parametername}" fornece ao provedor do painel o ID do participante.
Atenção : As soluções apresentadas abaixo utilizam os campos passthrough. Observe que, além de "parametername={PASSTHRU:parametername}", todo o restante deve ser fornecido pelo seu provedor de painel!
O link de conclusão
O link de conclusão deve ser inserido no campo URL final, que também precisa ser carregado automaticamente para todos que concluírem com êxito todo o inquérito.
A URL que você deve enviar de volta ao provedor do painel deve ter a seguinte aparência:
https://panelproviderwebsite.com/?return=complete¶metername={PASSTHRU:parametername}
O link de screenout
Um screenout impede que os participantes continuem o inquérito porque eles não fazem parte do seu grupo-alvo. Para screenouts, você deve definir o campo de limite da quota como "0" (zero) e permitir que a URL da quota seja carregada automaticamente quando for acionada.
Em seguida, adicione o seguinte link no campo URL da quota:
https://panelproviderwebsite.com/?return=screenout¶metername={PASSTHRU:parametername}
Nota: Leia a seção da wiki a seguir para saber mais sobre o sistema de quotas do LimeSurvey e seu uso.
O link de quotafull
Um quotafull exclui participantes de continuarem o inquérito, porque uma determinada quota foi excedida.
https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername}
Nota: Leia a seção da wiki a seguir para saber mais sobre o sistema de quotas do LimeSurvey e seu uso.
Integração de painel do inquérito por meio de expressões
Em construção