====== Panel-Redirects =====

Der Baustein "Panel-Redirects" ...

  * liest Teilnahme-Kennungen ein, welche von einem Panel-Anbieter beim Aufruf des Fragebogens übergeben werden,
  * erstellt Ihnen dazu passend einen Link, welchen Sie dem Panel-Anbieter übermitteln können und
  * löst abhängig vom Interview-Status den passenden Redirect aus.

Verwenden Sie Redirects wie folgt:

  - Erstellen Sie einen Baustein "Panel-Redirects" und tragen Sie dort die Redirect-URLs ein, die Sie vom Panel-Anbieter bekommen haben.
  - Ziehen Sie den Baustein "Panel-Redirects" unter **Fragebogen zusammenstellen** auf die erste Seite des Fragebogens.
  - Veröffentlichen Sie den Fragebogen ([[:de:survey:publish]])
  - Öffnen Sie den "Panel-Redirects" Baustein, sehen Sie hier nach, wie der "Link zum Fragebogen" lautet (inkl. der Parameter für die Panel-ID) und teilen Sie dem Panel-Anbieter diesen Link mit.


===== Interview-Abschluss ohne Weiterleitung =====

Sie können für die unterschiedlichen Situationen entweder eine Redirect-URL eintragen oder einen Text aus dem Fragenkatalog auswählen. Wenn Sie z.B. einen Screenout nutzen möchten, in diesem Fall aber keine Weiterleitung zu einem Panel-Anbieter erfolgen soll, dann ...

  - erstellen Sie im **Fragenkatalog** einen neuen Text und tragen Sie dort ein, was Befragte im Falle eines Screenouts angezeigt werden soll.
  - Wählen Sie diesen Text im "Panel-Redirects" Baustein unter "Alternative Verabschiedungen" für den Screenout aus.

Sie müssen in einem "Panel-Redirects" Baustein auch gar keine URLs eintragen.


===== Redirects und Interviewstatus =====

Ein Redirect ist eine URL (Internetadresse), an welche Befragte automatisch weitergeleitet werden.

Es gibt üblicherweise 4 unterschiedliche Redirects. Nicht jeder Panel-Anbieter verwendet alle Redirects. Falls Sie nur einen Redirect bekommen, tragen Sie diesen als "Complete" Redirect ein.

  * "Complete" -- Für Befragte, die den Fragebogen vollständig ausgefüllt haben.
  * "Screenout" -- Für Befragte, die nicht Teil der Grundgesamtheit sind und daher frühzeitig abgewiesen werden.
  * "Quota Full" -- Wird im Fall einer Quoten-Stichprobe verwendet für Befragte, in deren Quota-Gruppe bereits ausreichend Fälle erhoben wurden (siehe [[:de:survey:quota]]).
  * "Quality Fail" -- Für Befragte, deren Antworten nicht den Kriterien für valide Antworten entsprechen, z.B. Aufgrund von Kontrollfragen, Instructed Response Items, Bogus Items oder Antwortzeiten.

Oftmals muss in den Redirect ein Wert eingesetzt werden, welcher vom Panel-Anbieter eingangs im Link übergeben wurde. Diese Werte (Parameter) müssen durch eckige Klammern im Link markiert sein, z.B.

    https://www.example.com/complete?id=[panelID]&study=123
    

===== Der Link zum Fragebogen =====

Die oben genannten Parameter möchte der Panel-Anbieter beim Aufruf des Fragebogens an SoSci Survey übergeben.

Wenn Sie die Panel-Redirects im Baustein eingetragen und gespeichert haben, prüft SoSci Survey, welche Parameter benötigt werden und zeigt im Karteireiter "Link für das Panel" einen Link zum Fragebogen an, welcher Platzhalter für die entsprechenden Parameter enthält, z.B.

    https://www.soscisurvey.de/example/?panelID=[panelID]

Die Panel-Anbieter fügen dann anstelle des Platzhalters ''[panelID]'' für jede Panelist:in einen Code ein. SoSci Survey speichert diesen Code im Datensatz und trägt ihm beim Redirect an der passenden Stelle ein.

**Wichtig:** Verwenden Sie den Link, den Ihnen der Baustein "Panel-Redirects" im Karteireiter "Link für das Panel" anzeigt und __nicht__ den Link hier aus der Anleitung auch auch __nicht__ den Link, der Ihnen unter "Fragebogen veröffentlichen" angezeigt wird.


===== Auslösen der Redirects im Fragebogen =====

Standardmäßig wird der "Complete" Redirect ausgelöst, wenn eine Person den Fragebogen bis zum Ende ("Letzte Seite") ausgefüllt hat.

Falls Sie eine [[:de:survey:quota]] verwenden, kann diese den "Screenout" und den "Quota Full" Redirect auslösen.

Diesen und weitere im Baustein definierte Redirects können Sie mit der Funktion ''[[:de:create:functions:setstatus]]'' auslösen.


===== Qualitätskontrolle =====

Wenn Sie beispielsweise drei Instructed Response Items verwenden, und Teilnehmer:innen an den "Quality Fail" Redirect weiterleiten möchten, wenn sie entweder zwei von drei Items falsch beantwortet oder den Fragebogen in weniger als 8 Minuten (480 Sekunden) bearbeitet haben, dann gehen Sie wie folgt vor.

  - Ziehen Sie unter **Fragebogen zusammenstellen** eine zusätzliche Seite vor die "Letzte Seite"
  - Ziehen Sie ein Element "PHP-Code" von rechts in die Seite und fügen Sie folgenden PHP-Code ein.

Für das Code-Beispiel nehmen wir an, dass die drei Instructed Response Items die Variablen SK01_04, SK03_05 und SK06_03 verwenden. Die richtigen Antworten wären exemplarisch 1, 3 und 5.

<code php>
// Anzahl der korrekte Antworten ermitteln
$correct = 
  (value('SK01_04') == 1) +
  (value('SK03_05') == 3) +
  (value('SK06_03') == 5);
  
// Prüfung der Kriterien
if (
  ($correct < 2) ||
  (caseTime('hitherto') < 480)
) {
  // Redirect "quality fail" auslösen
  setStatus('quality fail');
}

// Ansonsten Redirect "complete" auslösen
setStatus('complete');
</code>