Actions

Panel integration/it: Difference between revisions

From LimeSurvey Manual

(Created page with "=Esempi=")
(Created page with "{{Nota|In costruzione}}")
 
(16 intermediate revisions by the same user not shown)
Line 98: Line 98:




The following examples were created to help you add:
I seguenti esempi sono stati creati per aiutarti ad aggiungere:


*[[Panel integration#The complete link|Redirects if the respondents have finished filling out the survey]];
*[[Integrazione con il panel#Il link completo|Reindirizza se gli intervistati hanno finito di compilare il sondaggio]];
*[[Panel integration#The screenout link|Redirects if the respondents were screened out due to a quota]];
*[[Integrazione con il panel#Il link di esclusione|Reindirizza se gli intervistati sono stati esclusi a causa di una quota]];  
*[[Panel integration#The quota-full|Redirects link if the quota limit was reached]].
*[[Integrazione pannello#The quota-full|Reindirizza il collegamento se è stato raggiunto il limite di quota]].


<div class="simplebox">[[File:help.png]] '''Note:''' parametername={PASSTHRU:parametername}" provides the panel provider the id of the participant.</div>
<div class="simplebox">[[File:help.png]] '''Nota:''' parametername={PASSTHRU:parametername}" fornisce al fornitore del pannello l'id del partecipante.</div>




{{Alert|title=Attention|text=The solutions provided below make use of the [[URL_fields#Passthrough_fields|'''passthrough fields''']]. Please note that besides "'''parametername={PASSTHRU:parametername}'''", everything else has to be provided by your panel provider!}}
{{Alert|title=Attenzione|text=Le soluzioni fornite di seguito utilizzano i [[URL_fields#Passthrough_fields|'''campi passanti''']]. Tieni presente che oltre a "'''parametername={PASSTHRU:parametername}'''", tutto il resto deve essere fornito dal provider del panel!}}




==The complete link==
==Il link completo==




The complete link must be inserted into [[Text elements|the end URL field]] that also has [[Presentation#Presentation_panel|to be loaded automatically]] for everyone who successfully completes the whole survey.
Il link completo deve essere inserito in [[Text elements|the end URL field]] che ha anche [[Presentation#Presentation_panel|da caricare automaticamente]] per tutti coloro che completano con successo l'intero sondaggio.


The URL you have to send back to the panel provider should look like this:
L'URL che devi rispedire al fornitore del pannello dovrebbe essere simile al seguente:


<code>
<code>
Line 121: Line 121:
</code>
</code>


==The screenout link==
==Il collegamento dello screenout==




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.  
Uno screenout impedisce ai partecipanti di continuare il sondaggio perché non è un membro del gruppo target del sondaggio. Per gli screenout, devi impostare il campo del limite di quota su "0" (zero) e consentire il caricamento automatico dell'URL di quota una volta attivato.  


Then, add the following link into the quota URL field:
Quindi, aggiungi il seguente collegamento nel campo dell'URL della quota:


<code>
<code>
Line 132: Line 132:
</code>
</code>


<div class="simplebox">[[File:help.png]] '''Note:''' Read the following wiki section to find out more about the [[Survey quotas|LimeSurvey quota system and its usage.]]</div>
<div class="simplebox">[[File:help.png]] '''Nota:''' Leggi la seguente sezione wiki per saperne di più sul [[Survey quotes|LimeSurvey sistema di quote e il suo utilizzo.]]</div>


==The quotafull link==  
==Il link quotafull==  




A quotafull excludes participants from continuing the survey, because a certain quota has been exceeded.
Una quota piena esclude i partecipanti dal continuare il sondaggio, perché è stata superata una certa quota.
<code>
<code>
<nowiki>https://panelproviderwebsite.com/?return=quotafull&parametername={PASSTHRU:parametername}</nowiki>
https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername}
</code><nowiki> <code>
https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername}  
</code></nowiki> <code>
https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername}
</code>
</code>


<div class="simplebox">[[File:help.png]] '''Note:''' Read the following wiki section to find out more about the [[Survey quotas|LimeSurvey quota system and its usage.]]</div>
<div class="simplebox">[[File:help.png]] '''Nota:''' Leggi la seguente sezione wiki per saperne di più sul [[Survey quotes|LimeSurvey sistema di quote e il suo utilizzo.]]</div>




{{Box|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 [[SGQA_identifier|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 [https://www.limesurvey.org/forum LimeSurvey forum].}}
{{Box|Questa non è l'unica soluzione che puoi utilizzare per implementare reindirizzamenti quotafull, complete e screenout al tuo provider di panel! Ad esempio, [[ExpressionScript - Presentation]], [[SGQA_identifier|SQGA indentifiers]] e [[URL fields]] offrono diverse soluzioni alternative per completare le stesse attività (e anche quelle più complesse). Per ulteriore assistenza, controlla anche il [https://www.limesurvey.org/forum LimeSurvey forum].}}


=Survey panel integration via expressions=
=Integrazione pannello sondaggi tramite espressioni=


{{Note|Under construction}}
{{Nota|In costruzione}}

Latest revision as of 07:54, 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) Ora devi impostare il link di accesso che invierai al fornitore del tuo panel. Per ottenere il collegamento all'URL del sondaggio, fai clic sui pulsanti Anteprima sondaggio.



Copia l'URL a cui hai effettuato l'accesso dalla barra degli indirizzi:


File:URL anteprima domanda - panel integration.png


Suggerimento: Il parametro "newtest" viene utilizzato per reimpostare la sessione. Ciò è utile quando desideri testare localmente l'integrazione del pannello o quando sai che i tuoi partecipanti utilizzano lo stesso dispositivo/browser per compilare il sondaggio. Pertanto, l'aggiunta di "newtest=Y" nell'URL del sondaggio crea nuove risposte nella tabella delle risposte forzando la creazione di una nuova sessione indipendentemente dal dispositivo/browser utilizzato.


Aggiungere alla fine il parametro appena aggiunto: &LSid="xxxxxx". Il collegamento dovrebbe assomigliare a questo:

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

Suggerimento: I parametri GET usano "?" per il primo parametro e "&" per il resto. Se hai già "?" nel tuo URL, devi utilizzare "&" per aggiungere altri parametri GET. Leggi i parametri GET e il loro utilizzo qui.


Qualunque cosa tu sostituisca "xxxxxx" verrà memorizzata nella domanda a testo libero breve/lunga quando il tuo intervistato arriva su quella pagina. Ad esempio, ho inviato a un utente il seguente link:

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

La stringa dopo LSid è stata memorizzata come risposta alla domanda di testo breve/lunga.


File:ABCD5 - integrazione pannello.png


Template:Nota

Esempi

I seguenti esempi sono stati creati per aiutarti ad aggiungere:

Nota: parametername={PASSTHRU:parametername}" fornisce al fornitore del pannello l'id del partecipante.


  Attenzione : Le soluzioni fornite di seguito utilizzano i campi passanti. Tieni presente che oltre a "parametername={PASSTHRU:parametername}", tutto il resto deve essere fornito dal provider del panel!



Il link completo

Il link completo deve essere inserito in the end URL field che ha anche da caricare automaticamente per tutti coloro che completano con successo l'intero sondaggio.

L'URL che devi rispedire al fornitore del pannello dovrebbe essere simile al seguente:

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

Il collegamento dello screenout

Uno screenout impedisce ai partecipanti di continuare il sondaggio perché non è un membro del gruppo target del sondaggio. Per gli screenout, devi impostare il campo del limite di quota su "0" (zero) e consentire il caricamento automatico dell'URL di quota una volta attivato.

Quindi, aggiungi il seguente collegamento nel campo dell'URL della quota:

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

Nota: Leggi la seguente sezione wiki per saperne di più sul LimeSurvey sistema di quote e il suo utilizzo.

Il link quotafull

Una quota piena esclude i partecipanti dal continuare il sondaggio, perché è stata superata una certa quota.


https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername} 

<code> https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername} </code>

https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername} 

Nota: Leggi la seguente sezione wiki per saperne di più sul LimeSurvey sistema di quote e il suo utilizzo.


Questa non è l'unica soluzione che puoi utilizzare per implementare reindirizzamenti quotafull, complete e screenout al tuo provider di panel! Ad esempio, ExpressionScript - Presentation, SQGA indentifiers e URL fields offrono diverse soluzioni alternative per completare le stesse attività (e anche quelle più complesse). Per ulteriore assistenza, controlla anche il LimeSurvey forum.


Integrazione pannello sondaggi tramite espressioni

Template:Nota