Actions

Panel integration/de: Difference between revisions

From LimeSurvey Manual

No edit summary
No edit summary
Line 13: Line 13:




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





Revision as of 07:48, 1 August 2023


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.



Um auf die Panel-Integration Ihrer Umfrage zuzugreifen, gehen Sie in das Umfrage-Menü und klicken Sie auf die Registerkarte Panel-Integration.

Umfrage-Panelintegration


Nach dem Zugriff wird eine leere Tabelle mit der Option "Hinzufügen eines URL-Parameters" angezeigt.



Zwei Felder müssen ausgefüllt werden:

  • Parameter: Geben Sie in diesem Feld den Namen des neuen Parameters ein. Sie wird in die URL aufgenommen;
  • 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.
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 End-URL verwenden. Für weitere Dokumentation lesen Sie bitte weiter in der End-URL Wiki Sektion.

Wie benutzt man 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.


Datei:Beispiel – URL-Parameter hinzufügen.png


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


Datei:Finden Sie die URL – Panel-Integration.png


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


Datei:URL-Vorschaufrage – Panel-Integration.png


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.


Datei:ABCD5 – Panel-Integration.png


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.

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