Panel integration/nl: Difference between revisions
From LimeSurvey Manual
No edit summary |
No edit summary |
||
(18 intermediate revisions by 2 users not shown) | |||
Line 34: | Line 34: | ||
*'''Parameter:''' De naam van de parameter die je in de URL wilt toevoegen. | *'''Parameter:''' De naam van de parameter die je in de URL wilt toevoegen. | ||
*'''Doelvraag:''' | *'''Doelvraag:''' De parameter opgeslagen in de sessie van de enquête, ook als hier niets wordt ingevuld. | ||
<div class="simplebox">[[File:help.png]] | <div class="simplebox">[[File:help.png]] Als je de waarde van de URL parameter NIET opslaat, kun je deze waarde in de afsluiting-URL gebruiken. Lees [[URL_fields/nl#Parameters|afsluiting-URL]]. | ||
</div> | </div> | ||
==Hoe deze functie te gebruiken== | ==Hoe deze functie te gebruiken== | ||
Line 48: | Line 47: | ||
1) Maak eerst een vraag van het type '''korte/lange vrije tekst''' aan. Wij gebruiken in het voorbeeld als naam LS gevolgd door de vraagcode. Schakel de optie '''Deze vraag altijd verbergen''' in. De optie staat op de tab '''Tonen'''. | 1) Maak eerst een vraag van het type '''korte/lange vrije tekst''' aan. Wij gebruiken in het voorbeeld als naam LS gevolgd door de vraagcode. Schakel de optie '''Deze vraag altijd verbergen''' in. De optie staat op de tab '''Tonen'''. | ||
2) Klik op de tab ''Paneelintegratie'' op de optie "Voeg URL-parameter toe". | 2) Klik op de tab ''Paneelintegratie'' op de optie "Voeg URL-parameter toe". | ||
Selecteer de vraag die je net aangemaakt hebt. Een deelnemer die binnenkomt via het betreffende paneel van de provider komt binnen op deze doelvraag. Je kunt deze doelvraag verbergen zodat de deelnemer direct kan beginnen met het invullen van de enquête. | Selecteer de vraag die je net aangemaakt hebt. Een deelnemer die binnenkomt via het betreffende paneel van de provider komt binnen op deze doelvraag. Je kunt deze doelvraag verbergen zodat de deelnemer direct kan beginnen met het invullen van de enquête. | ||
Line 63: | Line 55: | ||
De gekozen naam moet worden toegevoegd aan de link die later aan de paneel-provider moet worden gebruikt. In dit voorbeeld heet deze parameter ''LSid''. Sla de wijziging op met de knop rechtsboven de tabel. | |||
De gekozen naam moet worden toegevoegd aan de link die later aan de paneel-provider moet worden gebruikt. In dit voorbeeld heet deze parameter ''LSid''. Sla de | |||
3) Nu gaan we de link voor de paneel-provider samenstellen. Om de URL voor de enquête te krijgen, klik op de knop '''Voorvertoon enquête'''. | 3) Nu gaan we de link voor de paneel-provider samenstellen. Om de URL voor de enquête te krijgen, klik op de knop '''Voorvertoon enquête'''. | ||
Line 82: | Line 70: | ||
<div class="simplebox">[[File:help.png]] '''Hint''': de parameter "newtest" wordt gebruikt om de sessie te resetten. Dit is handig als je lokaal de paneelintegratie wilt testen of als je weet dat de deelnemers hetzelfde apparaat / dezelfde browser gebruiken om de enquête in te vullen. Dan creëert het toevoegen van "newtest=Y" in de enquête-URL een nieuwe response in de responsetabel door het creëren van een nieuwe sessie te dwingen, ongeacht het gebruikte apparaat / webbrowser.</div> | |||
<div class="simplebox">[[File:help.png]] '''Hint''': de parameter "newtest" wordt gebruikt om de sessie te resetten. Dit is handig als je lokaal de paneelintegratie wilt testen of als je weet dat de | |||
</div> | |||
Line 96: | Line 82: | ||
Wat je bij "xxxxxx" invult wordt ingevuld bij de doelvraag waarop de deelnemer binnenkomt. Een voorbeeld met de link: | |||
Wat je bij "xxxxxx" invult wordt ingevuld bij de doelvraag waarop de deelnemer binnenkomt. Een voorbeeld met de link: | |||
<code> | <code> | ||
Line 115: | Line 99: | ||
Deze voorbeelden zijn gemaakt zodat je kunt toevoegen: | |||
Deze voorbeelden zijn gemaakt zodat je | |||
*[[Panel integration/nl#de link na afronding enquête|De link na afronding enquête]]. | *[[Panel integration/nl#de link na afronding enquête|De link na afronding enquête]]. | ||
Line 123: | Line 105: | ||
*[[Panel integration/nl#de link voor als een quota bereikt is|De link voor als een quota bereikt is]]. | *[[Panel integration/nl#de link voor als een quota bereikt is|De link voor als een quota bereikt is]]. | ||
<div class="simplebox">[[File:help.png]] '''NB:''' parametername={PASSTHRU:parametername}" geeft aan de paneel-provider het ID door van de deelnemer.</div> | <div class="simplebox">[[File:help.png]] '''NB:''' parametername={PASSTHRU:parametername}" geeft aan de paneel-provider het ID door van de deelnemer.</div> | ||
{{Alert|title=Attentie|text=De onderstaande voorbeelden gebruiken [[URL_fields/nl#Parameters|'''Parameters''']]. De gegevens met uitzondering van de "'''parametername={PASSTHRU:parametername}'''" moeten door de paneel-provider worden ingevuld!}} | {{Alert|title=Attentie|text=De onderstaande voorbeelden gebruiken [[URL_fields/nl#Parameters|'''Parameters''']]. De gegevens met uitzondering van de "'''parametername={PASSTHRU:parametername}'''" moeten door de paneel-provider worden ingevuld!}} | ||
==De link na afronding enquête== | ==De link na afronding enquête== | ||
De volledige link moet worden ingevuld bij het veld [[Text elements/nl|afsluiting-URL]] die ook [[Presentation/nl#Paneel presentatie|automatisch moet worden geladen]] voor de deelnemers die de enquête voltooien. | De volledige link moet worden ingevuld bij het veld [[Text elements/nl|afsluiting-URL]] die ook [[Presentation/nl#Paneel presentatie|automatisch moet worden geladen]] voor de deelnemers die de enquête voltooien. | ||
De URL voor de paneel-provider ziet er als volgt uit: | De URL voor de paneel-provider ziet er als volgt uit: | ||
Line 148: | Line 122: | ||
</code> | </code> | ||
==De link voor niet aangemelde bezoekers== | ==De link voor niet aangemelde bezoekers== | ||
Een '''screenout''' zorgt ervoor dat een respondent de enquête niet kan invullen omdat hij/zij geen deelnemer is in je enquête. Je kunt hier de quota-limiet op ''0'' (nul) zetten en toestaan dat de quota-URL automatisch wordt geladen. | |||
Een '''screenout''' zorgt ervoor dat een respondent de enquête niet kan invullen omdat hij/zij geen deelnemer is in je enquête. Je kunt hier de quota-limiet op ''0'' (nul) zetten en toestaan dat de quota-URL automatisch wordt geladen. | |||
Plaats dan de volgende link in het quota URL-veld: | Plaats dan de volgende link in het quota URL-veld: | ||
Line 166: | Line 135: | ||
<div class="simplebox">[[File:help.png]] '''NB:''' Meer informatie over [[Survey quotas|Enquête quota's.]]</div> | <div class="simplebox">[[File:help.png]] '''NB:''' Meer informatie over [[Survey quotas|Enquête quota's.]]</div> | ||
==De link voor als een quota bereikt is== | |||
==De link voor als een quota bereikt is== | |||
Latest revision as of 09:08, 6 July 2023
Introductie
Op dit tabblad kunt u aangeven welke extra URL-parameters geaccepteerd worden door de enquête (deze parameters worden gekoppeld aan de URL om de enquête te starten). Dit is belangrijk als u wilt samenwerken met een professioneel onderzoeksbureau dat zorgt voor de deelnemers. Ze werken meestal met een unieke ID per deelnemer en moet u deze ID opslaan/verwerken. Ook is bij sommige bureaus de unieke ID van de deelnemer (i.v.m. een quotum of het afronden van het onderzoek) nodig voor de URL voor het afronden van de enquête.
Om naar het paneel integratie te gaan klik je op de tab Paneelintegratie in het zij-menu Enquête.
Enquête paneelintegratie
Bij de eerste keer benaderen zal een lege tabel worden getoond met een optie Voeg URL-parameter toe.
De in te vullen velden:
- Parameter: De naam van de parameter die je in de URL wilt toevoegen.
- Doelvraag: De parameter opgeslagen in de sessie van de enquête, ook als hier niets wordt ingevuld.
Hoe deze functie te gebruiken
Een eenvoudig voorbeeld om de werking van deze functie uit te leggen.
1) Maak eerst een vraag van het type korte/lange vrije tekst aan. Wij gebruiken in het voorbeeld als naam LS gevolgd door de vraagcode. Schakel de optie Deze vraag altijd verbergen in. De optie staat op de tab Tonen.
2) Klik op de tab Paneelintegratie op de optie "Voeg URL-parameter toe".
Selecteer de vraag die je net aangemaakt hebt. Een deelnemer die binnenkomt via het betreffende paneel van de provider komt binnen op deze doelvraag. Je kunt deze doelvraag verbergen zodat de deelnemer direct kan beginnen met het invullen van de enquête.
De gekozen naam moet worden toegevoegd aan de link die later aan de paneel-provider moet worden gebruikt. In dit voorbeeld heet deze parameter LSid. Sla de wijziging op met de knop rechtsboven de tabel.
3) Nu gaan we de link voor de paneel-provider samenstellen. Om de URL voor de enquête te krijgen, klik op de knop Voorvertoon enquête.
Kopieer de URL die dan in de adresregel van je browser komt te staan:
Voeg achteraan toe: &LSid="xxxxxx". De link ziet er dan uit als:
http://localhost/index.php/369498?newtest=Y&lang=en&LSid="xxxxxx"
Wat je bij "xxxxxx" invult wordt ingevuld bij de doelvraag waarop de deelnemer binnenkomt. Een voorbeeld met de link:
http://localhost/index.php/369498?newtest=Y&lang=en&LSid=ABCD5
De tekst na LSid wordt als antwoord gebruikt in de doelvraag.
Voorbeelden
Deze voorbeelden zijn gemaakt zodat je kunt toevoegen:
- De link na afronding enquête.
- De link voor niet aangemelde bezoekers.
- De link voor als een quota bereikt is.
De link na afronding enquête
De volledige link moet worden ingevuld bij het veld afsluiting-URL die ook automatisch moet worden geladen voor de deelnemers die de enquête voltooien.
De URL voor de paneel-provider ziet er als volgt uit:
https://panelproviderwebsite.com/?return=complete¶metername={PASSTHRU:parametername}
De link voor niet aangemelde bezoekers
Een screenout zorgt ervoor dat een respondent de enquête niet kan invullen omdat hij/zij geen deelnemer is in je enquête. Je kunt hier de quota-limiet op 0 (nul) zetten en toestaan dat de quota-URL automatisch wordt geladen.
Plaats dan de volgende link in het quota URL-veld:
https://panelproviderwebsite.com/?return=screenout¶metername={PASSTHRU:parametername}
De link voor als een quota bereikt is
Een quotafull voorkomt dat deelnemers de enquête verder invullen wanneer er een quota bereikt is.
https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername}