Actions

Panel integration/de: Difference between revisions

From LimeSurvey Manual

(Created page with "*Weiterleitungen, wenn die Befragten die Umfrage vollständig ausgefüllt haben; *Panel-Integration#Der Screenout-Link|Weiterlei...")
No edit summary
 
(33 intermediate revisions by the same user not shown)
Line 4: Line 4:




<div class="mw-translate-fuzzy">
<div class="simplebox">[[File:help.png]] Die folgenden Beispiele und Erklärungen basieren vollständig auf den Beiträgen unserer Benutzer. Fühlen Sie sich frei, einen Beitrag zu leisten, wenn Sie dazu beitragen möchten, unser offenes Wissen über Panel-Integration zu erweitern.</div>
<div class="simplebox">[[File:help.png]] Die folgenden Beispiele und Erklärungen basieren ausschließlich auf den Beiträgen unserer Benutzer. Helfen Sie mit, wenn Sie unser frei-verfügbares Wissen über Panel-Integration erweitern möchten.</div>
</div>




<span id="Introduction"></span>
=Einführung=
=Einführung=




<div class="mw-translate-fuzzy">
Auf dieser Registerkarte können Sie die URL-Parameter definieren, die von Ihrer Umfrage akzeptiert werden. (Diese Parameter werden an die Start-URL der allgemeinen Umfrage angehängt). Diese Option ist wichtig, wenn Sie Ihre Umfrage mit einem professionellen Umfragepanel-Anbieter integrieren möchten, der die Teilnehmer für Sie bereitstellt. Letzteres stellt normalerweise die eindeutige ID jedes Umfrageteilnehmers bereit und Sie müssen diese eindeutigen IDs zur späteren Bezugnahme speichern.
Auf dieser Registerkarte können Sie einstellen, welche URL-Parameter von Ihrer Umfrage akzeptiert werden (diese Parameter werden an die allgemeine Start-URL der Umfrage angehängt). Diese Option ist wichtig, wenn Sie Ihre Umfrage mit einem professionellen Umfrage-Panel-Anbieter integrieren möchten, der Ihnen die Teilnehmer zur Verfügung stellt. Dieser übergibt in der Regel eine eindeutige ID jedes Umfrageteilnehmers und Sie müssen diese eindeutigen IDs zur weiteren Verwendung speichern/weitergeben.
</div>




<div class="mw-translate-fuzzy">
{{Alert|title=Achtung|text=Bei einigen Anbietern muss die eindeutige ID des Teilnehmers, die aufgrund einer Quotenbeschränkung oder beim Beenden der Umfrage weggelassen wird, in der End-URL der Umfrage an den Panel-Anbieter zurückgesendet werden Kontingent-URL.}}
{{Alert|title=Attention|text=Bei einigen Anbietern muss die eindeutige ID des Teilnehmers, die aufgrund einer Quotenbeschränkung oder beim Beenden der Umfrage herausfallen, an den Panelanbieter in der End-URL oder Quoten-URL zurückgesendet werden.}}
</div>




<div class="mw-translate-fuzzy">
Panel-Integration der Umfrage: „Umfragemenü“ > „Umfragemenü“ > „Panel-Integration“
Um auf die Panel-Integration Ihrer Umfrage zuzugreifen, gehen Sie in das '''Umfrage-Menü''' und klicken Sie auf die Registerkarte '''Panel-Integration'''.
</div>


<center>[[File:Panel integration - tab.png]]</center>
<center>[[File:Panel integration - tab.png]]</center>


<div class="mw-translate-fuzzy">
<span id="Survey_panel_integration"></span>
=Umfrage-Panelintegration=
=Integration des Umfragepanels=
</div>




<div class="mw-translate-fuzzy">
Es wird eine leere Tabelle mit der Option angezeigt, „einen URL-Parameter hinzuzufügen“.
Nach dem Zugriff wird eine leere Tabelle mit der Option "Hinzufügen eines URL-Parameters" angezeigt.
</div>




Line 41: Line 31:




<div class="mw-translate-fuzzy">
Zwei Felder müssen ausgefüllt werden:
Zwei Felder müssen ausgefüllt werden:
</div>


<center>[[File:Add URL parameter.png]]</center>
<center>[[File:Add URL parameter.png]]</center>


<div class="mw-translate-fuzzy">
*'''Parameter:''' Geben Sie in dieses Feld den Namen des neuen Parameters ein.
*'''Parameter:''' Geben Sie in diesem Feld den Namen des neuen Parameters ein. Sie wird in die URL aufgenommen;
*'''Zielfrage:''' Der Wert des Parameters wird in der Umfragesitzung immer gespeichert, auch wenn Sie hier keine Zielfrage festlegen. Hier können Sie eine Frage vom Typ „Text sortieren“ oder „Mehrere Texte“ auswählen.
*'''Zielfrage:''' Generell wird der URL-Parameter als Frage gespeichert. Es stellt den Ort dar, an dem die Befragten landen, sobald sie auf den Link klicken, der auch den oben definierten Parameter in seiner URL enthält.
</div>


<div class="mw-translate-fuzzy">
<div class="simplebox">[[File:help.png]] Wenn Sie den Wert des URL-Parameters nicht speichern, können Sie diesen Parameter weiterhin in der End-URL verwenden. Weitere Dokumentation finden Sie im Wiki-Abschnitt [[URL_fields#Passthrough_fields|End-URL]].</div>  
<div class="simplebox">[[File:help.png]] Sie können den URL-Parameter auch als Antwort auf einen ''Kurzer Text''- oder ''Mehrfacher kurzer Text''- Fragetyp speichern (Sie können eine beliebige Kurztextfrage zum Speichern auswählen). Auch wenn Sie den Wert des URL-Parameters nicht speichern, können Sie diesen Parameter in der [[Text elements/de|End-URL]] verwenden. Für weitere Dokumentation lesen Sie bitte weiter in der [[URL_fields/de#Passthrough_fields|End-URL]] Wiki Sektion.</div>
</div>  


<div class="mw-translate-fuzzy">
<span id="How_to_use_the_panel_integration_function"></span>
==Wie benutzt man die Panel-Integrationsfunktion?==
==So verwenden Sie die Panel-Integrationsfunktion==
</div>




Line 71: Line 54:




<center>[[Datei:Beispiel – URL-Parameter hinzufügen.png]]</center>
<center>[[File:Example - add URL parameter.png]]</center>




Line 80: Line 63:




<center>[[Datei:Finden Sie die URL – Panel-Integration.png]]</center>
<center>[[File:Find the URL - panel integration.png]]</center>




Line 86: Line 69:




<center>[[Datei:URL-Vorschaufrage – Panel-Integration.png]]</center>
<center>[[File:URL preview question - panel integration.png]]</center>




Line 110: Line 93:




<center>[[Datei:ABCD5 – Panel-Integration.png]]</center>
<center>[[File:ABCD5 - panel integration.png]]</center>




{{Hinweis|Weitere Informationen zur URL-Anpassung finden Sie im Wiki-Abschnitt [[URL-Felder]].}}
{{Hinweis|Weitere Informationen zur URL-Anpassung finden Sie im Wiki-Abschnitt [[URL-Felder]].}}


<span id="Examples"></span>
=Beispiele=  
=Beispiele=  


Line 124: Line 108:
*[[Panel-Integration#The quote-full|Redirects-Link, wenn das Kontingentlimit erreicht wurde]].
*[[Panel-Integration#The quote-full|Redirects-Link, wenn das Kontingentlimit erreicht wurde]].


<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]] '''Hinweis:''' parametername={PASSTHRU:parametername}" stellt dem Panel-Anbieter die ID des Teilnehmers bereit.</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=Achtung|text=Die unten bereitgestellten Lösungen nutzen die [[URL_fields#Passthrough_fields|''Passthrough-Felder''']]. Bitte beachten Sie, dass außer „''parametername={PASSTHRU:parametername}'''“ alles andere von Ihrem Panel-Anbieter bereitgestellt werden muss!}}




==The complete link==
<span id="The_complete_link"></span>
==Der vollständige Link==




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.
Der vollständige Link muss in [[Textelemente|das End-URL-Feld]] eingefügt werden, das auch über [[Präsentation#Präsentationspanel|automatisch zu laden]] für alle verfügt, die die gesamte Umfrage erfolgreich abgeschlossen haben.


The URL you have to send back to the panel provider should look like this:
Die URL, die Sie an den Panel-Anbieter zurücksenden müssen, sollte wie folgt aussehen:


<code>
<code>
Line 141: Line 126:
</code>
</code>


==The screenout link==
<span id="The_screenout_link"></span>
==Der 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.  
Ein Screenout verhindert, dass der Teilnehmer die Umfrage fortsetzt, da er nicht zu Ihrer Umfragezielgruppe gehört. Für Screenouts müssen Sie das Kontingentlimit-Feld auf „0“ (Null) setzen und zulassen, dass die Kontingent-URL automatisch geladen wird, sobald sie ausgelöst wurde.  


Then, add the following link into the quota URL field:
Fügen Sie dann den folgenden Link in das Kontingent-URL-Feld ein:


<code>
<code>
<nowiki>https://panelproviderwebsite.com/?return=screenout&parametername={PASSTHRU:parametername}</nowiki>
<nowiki>https://panelproviderwebsite.com/?return=complete&parametername={PASSTHRU:parametername}</nowiki>
</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">[[Datei:help.png]] '''Hinweis:''' Lesen Sie den folgenden Wiki-Abschnitt, um mehr über das [[Umfragequoten|LimeSurvey-Quotensystem und seine Verwendung zu erfahren.]]</div>


==The quotafull link==  
<span id="The_quotafull_link"></span>
==Der Quotefull-Link==  




A quotafull excludes participants from continuing the survey, because a certain quota has been exceeded.
Eine Quotevoll schließt Teilnehmer von der Fortsetzung der Umfrage aus, da eine bestimmte Quote überschritten wurde.
<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]] '''Hinweis:''' Lesen Sie den folgenden Wiki-Abschnitt, um mehr über das [[Umfragequoten|LimeSurvey-Quotensystem und seine Verwendung zu erfahren.]]</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|Dies ist nicht die einzige Lösung, mit der Sie Quotefull-, Complete- und Screenout-Weiterleitungen zu Ihrem Panel-Anbieter implementieren können! Beispielsweise bieten Ihnen das [[ExpressionScript – Präsentation]], der [[SGQA_identifier|SQGA-Bezeichner]] und die [[URL-Felder]] verschiedene Problemumgehungen, um dieselben Aufgaben (und sogar komplexere) zu erledigen. Weitere Hilfe finden Sie auch im [https://www.limesurvey.org/forum LimeSurvey-Forum].}}


=Survey panel integration via expressions=
<span id="Survey_panel_integration_via_expressions"></span>
=Umfragepanel-Integration über Ausdrücke=


{{Note|Under construction}}
{{Hinweis|Im Aufbau}}

Latest revision as of 07:26, 10 April 2024


Die folgenden Beispiele und Erklärungen basieren vollständig auf den Beiträgen unserer Benutzer. Fühlen Sie sich frei, einen Beitrag zu leisten, wenn Sie dazu beitragen möchten, unser offenes Wissen über Panel-Integration zu erweitern.


Einführung

Auf dieser Registerkarte können Sie die URL-Parameter definieren, die von Ihrer Umfrage akzeptiert werden. (Diese Parameter werden an die Start-URL der allgemeinen Umfrage angehängt). Diese Option ist wichtig, wenn Sie Ihre Umfrage mit einem professionellen Umfragepanel-Anbieter integrieren möchten, der die Teilnehmer für Sie bereitstellt. Letzteres stellt normalerweise die eindeutige ID jedes Umfrageteilnehmers bereit und Sie müssen diese eindeutigen IDs zur späteren Bezugnahme speichern.


  Achtung : Bei einigen Anbietern muss die eindeutige ID des Teilnehmers, die aufgrund einer Quotenbeschränkung oder beim Beenden der Umfrage weggelassen wird, in der End-URL der Umfrage an den Panel-Anbieter zurückgesendet werden Kontingent-URL.



Panel-Integration der Umfrage: „Umfragemenü“ > „Umfragemenü“ > „Panel-Integration“

Integration des Umfragepanels

Es wird eine leere Tabelle mit der Option angezeigt, „einen URL-Parameter hinzuzufügen“.



Zwei Felder müssen ausgefüllt werden:

  • Parameter: Geben Sie in dieses Feld den Namen des neuen Parameters ein.
  • Zielfrage: Der Wert des Parameters wird in der Umfragesitzung immer gespeichert, auch wenn Sie hier keine Zielfrage festlegen. Hier können Sie eine Frage vom Typ „Text sortieren“ oder „Mehrere Texte“ auswählen.
Wenn Sie den Wert des URL-Parameters nicht speichern, können Sie diesen Parameter weiterhin in der End-URL verwenden. Weitere Dokumentation finden Sie im Wiki-Abschnitt End-URL.

So verwenden Sie die Panel-Integrationsfunktion

Nachfolgend wird ein einfaches Beispiel vorgestellt, um die Verwendung der Panel-Integrationsfunktion zu erläutern.


1) Erstellen Sie zunächst eine „kurze/lange Freitextfrage“ und benennen Sie sie nach Belieben (wir verwenden „LS“ für das Feld „Fragecode“). Aktivieren Sie dann die Option „Diese Frage immer ausblenden“, die sich unter der Registerkarte „Anzeige“ im Menü der Frage befindet.

2) Gehen Sie zur Registerkarte „Panel-Integration“ und klicken Sie auf „URL-Parameter hinzufügen“.

Wählen Sie die Kurz-/Langtextfrage aus, die Sie im ersten Schritt erstellt haben. Auf der „Zielfrage“ landen die Teilnehmer, die vom jeweiligen professionellen Panel-Anbieter stammen. Es kann ausgeblendet werden, damit die Teilnehmer mit dem Ausfüllen der Umfrage beginnen können.



Der Name, den Sie für den Parameter auswählen, muss in den Eintragslink aufgenommen werden, den Sie später Ihrem Panel-Anbieter zur Verfügung stellen. In unserem Beispiel wird es „LSid“ heißen. Vergessen Sie nicht, auf die Schaltfläche „Speichern“ oben rechts in der Tabelle zu klicken!


3) Nun müssen Sie den Eintragslink einrichten, den Sie an Ihren Panel-Anbieter senden. Um den URL-Link Ihrer Umfrage zu erhalten, klicken Sie auf die Schaltflächen „Vorschau der Umfrage“.



Kopieren Sie die URL, auf die Sie über die Adressleiste zugegriffen haben:



Hinweis: Der Parameter „newtest“ wird zum Zurücksetzen der Sitzung verwendet. Dies ist nützlich, wenn Sie die Panel-Integration lokal testen möchten oder wenn Sie wissen, dass Ihre Teilnehmer dasselbe Gerät/den gleichen Browser zum Ausfüllen der Umfrage verwenden. Daher werden durch das Hinzufügen von „newtest=Y“ in der Umfrage-URL neue Antworten in der Antworttabelle erstellt, indem die Erstellung einer neuen Sitzung unabhängig vom verwendeten Gerät/Browser erzwungen wird.


Fügen Sie am Ende den neu hinzugefügten Parameter hinzu: &LSid="xxxxxx". Der Link sollte so aussehen:

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

Hinweis: Die GET-Parameter verwenden „?“ für den ersten Parameter und „&“ für den Rest. Wenn Sie bereits „?“ haben In Ihrer URL müssen Sie „&“ verwenden, um weitere GET-Parameter hinzuzufügen. Lesen Sie hier mehr über die GET-Parameter und ihre Verwendung.


Was auch immer Sie „xxxxxx“ ersetzen, wird in der kurzen/langen Freitextfrage gespeichert, wenn Ihr Befragter auf dieser Seite landet. Ich habe beispielsweise einem Benutzer den folgenden Link gesendet:

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

Die Zeichenfolge nach LSid wurde als Antwort auf die Kurz-/Langtextfrage gespeichert.



Template:Hinweis

Beispiele

Die folgenden Beispiele wurden erstellt, um Ihnen beim Hinzufügen zu helfen:

Hinweis: parametername={PASSTHRU:parametername}" stellt dem Panel-Anbieter die ID des Teilnehmers bereit.


  Achtung : Die unten bereitgestellten Lösungen nutzen die Passthrough-Felder'. Bitte beachten Sie, dass außer „parametername={PASSTHRU:parametername}'“ alles andere von Ihrem Panel-Anbieter bereitgestellt werden muss!



Der vollständige Link

Der vollständige Link muss in das End-URL-Feld eingefügt werden, das auch über automatisch zu laden für alle verfügt, die die gesamte Umfrage erfolgreich abgeschlossen haben.

Die URL, die Sie an den Panel-Anbieter zurücksenden müssen, sollte wie folgt aussehen:

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

Der Screenout-Link

Ein Screenout verhindert, dass der Teilnehmer die Umfrage fortsetzt, da er nicht zu Ihrer Umfragezielgruppe gehört. Für Screenouts müssen Sie das Kontingentlimit-Feld auf „0“ (Null) setzen und zulassen, dass die Kontingent-URL automatisch geladen wird, sobald sie ausgelöst wurde.

Fügen Sie dann den folgenden Link in das Kontingent-URL-Feld ein:

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

Datei:help.png Hinweis: Lesen Sie den folgenden Wiki-Abschnitt, um mehr über das LimeSurvey-Quotensystem und seine Verwendung zu erfahren.

Der Quotefull-Link

Eine Quotevoll schließt Teilnehmer von der Fortsetzung der Umfrage aus, da eine bestimmte Quote überschritten wurde.


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} 

Hinweis: Lesen Sie den folgenden Wiki-Abschnitt, um mehr über das LimeSurvey-Quotensystem und seine Verwendung zu erfahren.


Dies ist nicht die einzige Lösung, mit der Sie Quotefull-, Complete- und Screenout-Weiterleitungen zu Ihrem Panel-Anbieter implementieren können! Beispielsweise bieten Ihnen das ExpressionScript – Präsentation, der SQGA-Bezeichner und die URL-Felder verschiedene Problemumgehungen, um dieselben Aufgaben (und sogar komplexere) zu erledigen. Weitere Hilfe finden Sie auch im LimeSurvey-Forum.


Umfragepanel-Integration über Ausdrücke

Template:Hinweis