Actions

Panel integration/it: Difference between revisions

From LimeSurvey Manual

(Created page with "<center>File:Esempio - aggiungi parametro URL.png</center>")
(Created page with "Il nome che sceglierai per il parametro dovrà essere incluso nel link di accesso che fornirai in seguito al fornitore del tuo pannello. Sarà chiamato "LSid" nel nostro esemp...")
Line 54: Line 54:




The name you pick for the parameter will have to be included in the entry link that you will later supply to your panel provider. It will be named "LSid" in our example. Don't forget to click the '''Save''' button located in the upper right part of the table!
Il nome che sceglierai per il parametro dovrà essere incluso nel link di accesso che fornirai in seguito al fornitore del tuo pannello. Sarà chiamato "LSid" nel nostro esempio. Non dimenticare di fare clic sul pulsante '''Salva''' situato nella parte in alto a destra della tabella!





Revision as of 07:52, 1 August 2023


I seguenti esempi e spiegazioni si basano interamente sui contributi dei nostri utenti. Sentiti libero di contribuire se vuoi aiutare ad espandere la nostra conoscenza aperta sull'integrazione del pannello.


Introduzione

Da questa scheda puoi definire i parametri URL che saranno accettati dalla tua indagine. (Questi parametri saranno allegati all'URL di inizio del sondaggio generale). Questa opzione è importante se desideri integrare il tuo sondaggio con un fornitore di panel di sondaggi professionale che fornisca i partecipanti per te. Quest'ultimo di solito fornisce l'ID univoco di ogni partecipante al sondaggio e dovrai salvare questi ID univoci per ulteriori riferimenti.


  Attenzione : Con alcuni fornitori, l'ID univoco del partecipante che verrà omesso a causa di un limite di quota o al termine del sondaggio, deve essere rispedito al fornitore del panel nell'URL di fine sondaggio oppure quota URL.



Integrazione pannello sondaggio: Menu sondaggio > Menu sondaggio > Integrazione pannello

File:Integrazione del pannello - tab.png

Integrazione pannello sondaggi

Verrà visualizzata una tabella vuota con l'opzione che consente di aggiungere un parametro URL.


File:Aggiungi parametro URL button.png


Devono essere compilati due campi:

File:Aggiungi parametro URL.png
  • Parametro: Digita in questo campo il nome del nuovo parametro.
  • Domanda target:. Il valore del parametro viene sempre salvato nella sessione del sondaggio, anche se qui non si imposta una domanda target. Qui puoi selezionare una domanda del tipo "Ordina testo" o "Testi multipli".
Se non salvi il valore del parametro URL, sarai comunque in grado di utilizzare questo parametro nell'URL finale. Per ulteriore documentazione, continua a leggere la sezione wiki End-URL.

Come utilizzare la funzione di integrazione del pannello

Di seguito viene presentato un semplice esempio per spiegare come utilizzare la funzione di integrazione del pannello.


1) Per prima cosa, crea una domanda a testo libero breve/lunga e chiamala come preferisci (useremo "LS" per il campo Codice domanda). Quindi, abilita l'opzione nascondi sempre questa domanda, che si trova sotto la scheda Visualizza all'interno del menu della domanda.

2) Vai alla scheda di integrazione del pannello e fai clic su "Aggiungi parametro URL".

Seleziona la domanda di testo breve/lunga che hai creato nel primo passaggio. I partecipanti che provengono dal rispettivo fornitore di panel professionali atterreranno sulla domanda target. Può essere nascosto in modo che i partecipanti possano iniziare a completare il sondaggio.


File:Esempio - aggiungi parametro URL.png


Il nome che sceglierai per il parametro dovrà essere incluso nel link di accesso che fornirai in seguito al fornitore del tuo pannello. Sarà chiamato "LSid" nel nostro esempio. Non dimenticare di fare clic sul pulsante Salva situato nella parte in alto a destra della tabella!


3) Now, you have to set up the entry link that you will send to the your panel provider. To get your survey URL link, click the Preview survey buttons.



Copy the URL you accessed from the address bar:



Hint: The "newtest" parameter is used to reset the session. This is useful when you wish to test locally the panel integration or when you know that your participants are using the same device/browser to fill out the survey. Therefore, adding "newtest=Y" in the survey URL creates new answers in the responses table by forcing the creation of a new session regardless of the used device/browser..


Add at the end the newly added parameter: &LSid="xxxxxx". The link should look like this:

http://localhost/index.php/369498?newtest=Y&lang=en&LSid="xxxxxx"

Hint: The GET parameters use "?" for the first parameter and "&" for the rest of them. If you already have "?" in your URL, you must use "&" to add other GET parameters. Read about the GET parameters and their usage here.


What ever you replace the "xxxxxx" with will be stored in the short/long free text question when your respondent lands on that page. For example, I sent to a user the following link:

http://localhost/index.php/369498?newtest=Y&lang=en&LSid=ABCD5

The string after LSid was stored as an answer to the short/long text question.



Read the URL fields wiki section for more information on URL customization.

Examples

The following examples were created to help you add:

Note: parametername={PASSTHRU:parametername}" provides the panel provider the id of the participant.


  Attention : The solutions provided below make use of the passthrough fields. Please note that besides "parametername={PASSTHRU:parametername}", everything else has to be provided by your panel provider!



The complete link

The complete link must be inserted into the end URL field that also has to be loaded automatically for everyone who successfully completes the whole survey.

The URL you have to send back to the panel provider should look like this:

https://panelproviderwebsite.com/?return=complete&parametername={PASSTHRU:parametername}

The screenout link

A screenout prevents the participants from continuing the survey because he or she is not a member of your survey target group. For screenouts, you have to set the quota limit field to "0" (zero) and allow the quota URL to be automatically loaded once it was triggered.

Then, add the following link into the quota URL field:

https://panelproviderwebsite.com/?return=screenout&parametername={PASSTHRU:parametername}

Note: Read the following wiki section to find out more about the LimeSurvey quota system and its usage.

The quotafull link

A quotafull excludes participants from continuing the survey, because a certain quota has been exceeded. https://panelproviderwebsite.com/?return=quotafull&parametername={PASSTHRU:parametername}

Note: Read the following wiki section to find out more about the LimeSurvey quota system and its usage.


This is not the only solution you can use to implement quotafull, complete and screenout redirects to your panel provider! For example, the ExpressionScript - Presentation, the SQGA indentifiers, and the URL fields offer you different workarounds to complete the same tasks (and even the more complex ones). For additional help, check also the LimeSurvey forum.


Survey panel integration via expressions

Under construction