Actions

Panel integration/ro: Difference between revisions

From LimeSurvey Manual

(Created page with "==Cum se utilizează funcția de integrare a panoului==")
(Created page with "Un [https://www.limesurvey.org/forum/design-issues/95878-how-to-use-the-panel-integration-fuction exemplu simplu] este prezentat mai jos pentru a explica cum se utilizează fu...")
Line 41: Line 41:




A [https://www.limesurvey.org/forum/design-issues/95878-how-to-use-the-panel-integration-fuction simple example] is presented below to explain how to use the panel integration function.  
Un [https://www.limesurvey.org/forum/design-issues/95878-how-to-use-the-panel-integration-fuction exemplu simplu] este prezentat mai jos pentru a explica cum se utilizează funcția de integrare a panoului.  





Revision as of 08:52, 7 November 2023


Următoarele exemple și explicații se bazează în întregime pe contribuțiile utilizatorilor noștri. Simțiți-vă liber să contribui dacă doriți să ajutați la extinderea cunoștințelor noastre deschise despre integrarea panourilor.


Introducere

Din această filă puteți defini parametrii URL care vor fi acceptați de sondajul dvs. (Acești parametri vor fi atașați la adresa URL de început a sondajului general). Această opțiune este importantă dacă doriți să integrați sondajul cu un furnizor profesionist de panouri de sondaj care vă oferă participanții. Acesta din urmă oferă de obicei ID-ul unic al fiecărui participant la sondaj și va trebui să salvați aceste ID-uri unice pentru referințe ulterioare.


  Atenție : La unii furnizori, ID-ul unic al participantului care va fi omis din cauza unei limitări a cotei sau la finalizarea sondajului, trebuie trimis înapoi furnizorului panoului în adresa URL de final a sondajului sau cotă URL.



Integrarea panoului sondajului: Meniul sondajului > Meniul sondajului > Integrarea panoului

Integrarea panoului de sondaj

Va fi afișat un tabel gol cu opțiunea care vă permite „să adăugați un parametru URL”.


Fișier:Add URL parameter button.png


Trebuie completate două câmpuri:

  • Parametru: Introduceți în acest câmp numele noului parametru.
  • Întrebare țintă:. Valoarea parametrului este întotdeauna salvată în sesiunea de sondaj, chiar dacă nu setați o întrebare țintă aici. Aici puteți selecta o întrebare de tip „Sortați text” sau „Texte multiple”.
Dacă nu salvați valoarea parametrului URL, veți putea în continuare să utilizați acest parametru în URL-ul final. Pentru documentație suplimentară, continuați să citiți secțiunea wiki End-URL.

Cum se utilizează funcția de integrare a panoului

Un exemplu simplu este prezentat mai jos pentru a explica cum se utilizează funcția de integrare a panoului.


1) First, create a short/long free text question and name it what ever you want (we will use "LS" for the Question code field). Then, enable the always hide this question option, located under the Display tab within the menu of the question.

2) Go to the panel integration tab, and click the "Add URL parameter".

Select the short/long text question you created in the first step. The participants that come from the respective professional panel provider will land on the target question. It can be hidden so that the participants can start completing the survey.



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!


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