Antworten nach Fragetyp
Wie Fragen und Antworten je Fragetyp in der API aussehen.
Jede Frage hat in der API einen type, jede Antwort einen passenden question_type. Darüber erkennst du, wie die Antwort aufgebaut ist. Der Name des Fragetyps in PollHero steht zusätzlich in original_type.
Fragetypen
type | Fragetyp in PollHero | Zusatzfelder der Frage |
|---|---|---|
single | Single Select | answer_choices |
multiple | Multi Select | answer_choices |
text | Short Free Text, Long Free Text | – |
rating | Rating Scale | scale |
nps | Net Promoter Score (NPS) | scale |
csat | Customer Satisfaction Score (CSAT) | scale (1–5) |
ces | Customer Effort Score (CES) | scale (1–5 bei CES 1.0, 1–7 bei CES 2.0) |
smiley_scale | Emojis | – |
matrix | Matrix | answer_choices (Zeilen) |
ranking | Ranking | answer_choices |
mailing | Mailing | – |
button_next | Engagement Trigger | – |
empty | Thank You Message | – |
answer_choicesenthält je Optioncontent(Text) undallows_free_text(Option mit freier Eingabe, z. B. „Sonstiges“).- Antwortoptionen haben keine ID. Antworten verweisen über den Text auf eine Option.
scaleenthältminundmaxder Skala.
Aufbau der Antworten
Jede Antwort enthält question_id und question_type. Der Rest hängt vom Fragetyp ab:
question_type | Aufbau |
|---|---|
single | "answer": { "content": "Option A" } |
multiple, ranking, matrix | "answers": [ { "content": "A" }, { "content": "B" } ] |
text | "answer": "Freier Text", optional "sentiment": "positive" |
rating, csat, ces | "answer": { "rating": 4 } |
nps | "answer": { "content": 9, "tag": "promoter" } |
smiley_scale | "answer": { "content": "fiveFaces3" } |
mailing | "answer": "kunde@example.com" |
Details je Fragetyp
- Single Select: Bei einer Single-Select-Frage mit freier Eingabe steht der eingegebene Text in
content. Ausnahmsweise mehrere Werte werden wie bei Multi Select alsanswersgeliefert. - Ranking:
answersist nach Rang sortiert. Der erste Eintrag ist Platz 1. - Matrix:
answersenthält die gewählte Bewertung je Zeile, in der Reihenfolge der Zeilen ausanswer_choices. - Text:
sentimentistpositive,negativeoderneutral. Es fehlt, wenn keine Stimmungsanalyse vorliegt. - NPS:
tagistpromoter(9–10),passive(7–8) oderdetractor(0–6). Bei der Emoji-Darstellung mit fünf Gesichtern (Skala 1–5) gilt: 5promoter, 4passive, sonstdetractor. - CSAT und CES:
ratingist der gewählte Wert der Skala. Den CSAT-Wert oder den CES berechnest du daraus wie im Reporting, siehe So zählen wir Impressionen, Antworten und Raten.
Werte bei Emojis
content enthält einen festen Schlüssel für das gewählte Emoji:
| Darstellung | Werte (von negativ nach positiv) |
|---|---|
| 2 Daumen | thumb1 (Daumen runter), thumb0 (Daumen hoch) |
| 3 Gesichter | face0, face1, face2 bzw. threeFaces0, threeFaces1, threeFaces2 |
| 5 Gesichter | fiveFaces0 bis fiveFaces4 bzw. newFiveFaces0 bis newFiveFaces4 |
Übersprungene Fragen und Aktionen
- Übersprungene Fragen fehlen in
answers. - Wurde zu einer Frage nur eine Aktion erfasst und keine Antwort, enthält der Eintrag statt
answerdas Feldaction:closed(Umfrage geschlossen),next(Engagement Trigger gestartet),end(Umfrage beendet) odercustom_button_clicked(individueller Button der Thank You Message).
{ "question_id": "…", "question_type": "empty", "action": "custom_button_clicked" }- Antworten auf gelöschte Fragen werden nicht ausgegeben. Die Frage selbst bekommst du mit
include_deleted=truebeim Abruf der Fragen.