Dokumentation

Umfragen

Umfragen anlegen, öffnen, beantworten und auswerten.

Umfragen gehören zu einem Event. Sie können im Entwurf vorbereitet, geöffnet und später geschlossen werden. Antworten sind anonym, solange kein Ticket-Token mitgeschickt wird.

Status

Status	Bedeutung
draft	Entwurf. Fragen lassen sich bearbeiten.
open	Offen. Die Umfrage ist öffentlich erreichbar und nimmt Antworten an.
closed	Geschlossen. Es werden keine Antworten mehr angenommen.

Fragen lassen sich nur im Entwurf ändern. Eine offene Umfrage zeigt ihre Fragen unverändert an. Öffentlich erreichbar ist eine Umfrage nur, wenn sie offen ist und das Event veröffentlicht wurde.

Fragetypen

Typ	Antwort
single	Genau eine Option.
multi	Mehrere Optionen, ohne Doppelte.
text	Freitext.
scale	Ganze Zahl zwischen zwei Grenzen. Die Grenzen stehen als zwei Optionen mit numerischen Schlüsseln in der Frage.

Teilnahme

Der öffentliche Link lautet /e/<slug>/umfrage/<surveyId>. Auf der Ticketseite verlinkt Eventwerk offene Umfragen mit dem Ticket-Token als Parameter t.

Mit gültigem Ticket-Token wird die Antwort mit der Anmeldung verknüpft.
Pro Anmeldung ist eine Teilnahme möglich. Eine zweite Antwort ergibt already_responded.
Ohne Token oder mit unbekanntem Token wird die Antwort gespeichert, aber nicht mit einer Anmeldung verknüpft.
Pflichtfragen müssen beantwortet werden, sonst antwortet die API mit question_required.
Optionen müssen zur Frage gehören, sonst antwortet die API mit invalid_option.

Auswertung

Die Ergebnisse zeigen die Zahl der Teilnahmen und je Frage die Verteilung. Einfach- und Mehrfachauswahl liefern Anzahl und Prozent je Option. Textfragen liefern die Texte. Skalen liefern Minimum, Maximum, Durchschnitt und die Verteilung der Werte.

Eine Umfrage ist kein Pflichtformular. Gäste können sie auch ohne Anmeldung beantworten, wenn der Link geteilt wird. Mit Ticket-Token bleibt die Teilnahme dagegen eindeutig.