Actions

Paneelintegratie

From LimeSurvey Manual

Revision as of 17:18, 19 May 2020 by Han (talk | contribs)


De onderstaande voorbeelden en toelichting zijn bewerkingen van reacties op ons forum van gebruikers.


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.


  Attentie : Bij enkele providers moet het ID van de deelnemer die vanwege een quota de enquête niet kan doen of de enquête heeft afgerond mee worden teruggestuurd naar het paneel. Dit gebeurt dan in de afsluiting-URL of de quota-URL.



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: In het algemeen wordt de parameter opgeslagen als een vraag. Het geeft aan welke vraag de deelnemer in de enquête te zien krijgt als die op de link klikt waaraan deze parameter is toegevoegd.
Je kunt de waarde van het antwoord ook als het antwoord op een "Korte vrije tekstinvoer" of een "Meerdere korte tekstinvoer" vraagtype laten opslaan. (Je kunt de vraag zelf later selecteren.) Ook als je de waarde van de URL parameter NIET opslaat, kun je deze waarde in de afsluiting-URL gebruiken. Lees afsluiting-URL.


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.

  Attentie : Schakel de welkomstpagina uit! Je wilt dat ze op de door jou geselecteerde vraag terugkomen.



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 wijzing 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:



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 respondenten 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.


Voeg achteraan toe: &LSid="xxxxxx". De link ziet er dan uit als:

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

Tip: De GET parameters gebruiken "?" voor de eerste parameter en "&" voor volgende parameters. Omdat er al een parameter in de URL staat moet je dus "?" gebruiken. Meer informatie over GET parameters.


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.



Lees URL velden voor meer informatie over het instellen van de URL.

Voorbeelden

Deze voorbeelden zijn gemaakt zodat je eenvoudig kunt toevoegen:

NB: parametername={PASSTHRU:parametername}" geeft aan de paneel-provider het ID door van de deelnemer.


  Attentie : De onderstaande voorbeelden gebruiken Parameters. De gegevens met uitzondering van de "parametername={PASSTHRU:parametername}" moeten door de paneel-provider worden ingevuld!



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&parametername={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&parametername={PASSTHRU:parametername}

NB: Meer informatie over Enquête quota's.


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&parametername={PASSTHRU:parametername}

NB: Meer informatie over Enquête quota's.


Er zijn meer mogelijkheden om dit soort links te maken voor de paneel-provider! Je kunt hiervoor ook ExpressionScript, de SQGA identifier en de URL-velden gebruiken (die kunnen zelfs meer complex zijn). Kijk ook eens op ons LimeSurvey forum.


Paneelintegratie via expressies

Nog niet uitgewerkt.