> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Ein Umfrageelement zu Ihrem Widget hinzufügen
> Erstellen Sie NPS-, CSAT- und Feedback-Umfragen im Widget Studio mithilfe von Umfrageelementen wie Schaltflächen, Skalen, Mehrfachauswahl und Feldern für kurze oder lange Antworten.
Im Widget Studio können Sie mit einer Reihe spezieller **Survey elements** voll funktionsfähige Umfragen erstellen (z. B. NPS, CSAT, Zufriedenheitsformulare, Produktfeedback). Jedes Element verfügt über eigene Anpassungsmöglichkeiten.
Die Suite der Umfrageelemente ermöglicht Folgendes:
* Strukturierte, markenkonforme NPS- und CSAT-Widgets erstellen.
* Qualitatives und quantitatives Feedback sammeln.
* Detaillierte Validierungsregeln anwenden.
* Antworten flexibel exportieren oder weiterleiten.
Umfragedaten können **entweder in Kameleoon** (im .csv-Format exportierbar) gesammelt oder **über eine HTTP-Anfrage an einen externen Dienst** gesendet werden.
## Umfrageelemente
Umfrageelemente sind im Bereich **Survey** im Panel **Add element** aufgelistet.
* **Button:** Erforderlich, um die Übermittlung der Umfrage auszulösen.
* **Short answer:** Erfasst kurze Texteingaben von Benutzern.
* **Long answer:** Ideal für längere, offene Rückmeldungen.
* **Multiple choice:** Unterstützt Kontrollkästchen, Einzel- oder Mehrfachauswahl, optionales „Other"-Feld und Randomisierung von Antworten.
* **NPS:** Sammelt Net-Promoter-Score-Daten mit optionalen Folgefragen.
* **Scale:** Stellt eine Skala mit Zahlen oder Emojis dar.
Jedes Element kann mit dedizierten Einstellungs- und Stiloptionen im Widget Studio konfiguriert werden.
## Einstellungen
### Button
#### Allgemeine Einstellungen
* **Button text:**
* Geben Sie den Text Ihrer Schaltfläche in das Textfeld ein.
* Verwenden Sie die Schaltflächen oberhalb des Textfeldes, um:
* Ihren Text mit KI zu bearbeiten.
* Auf Stiloptionen zuzugreifen.
* Die Schriftart Ihres Textes zu bearbeiten.
* Die Ausrichtung Ihres Textes zu ändern.
* Die Farbe Ihres Textes zu bearbeiten.
* Einen Emoji hinzuzufügen.
* Klicken Sie auf das **three-dots menu**, um:
* Die Formatierung zu entfernen.
* Den Texteditor zu erweitern.
* **Style:** Ändert den Hintergrundtyp und die Farbe der Schaltfläche.
* **Animation:** Wählen Sie eine Eingangs- oder Ausgangsanimation für Ihre Schaltfläche aus.
#### Erweiterte Einstellungen
In **Advanced Settings** können Sie Folgendes festlegen:
* **Default state:** Ob die Schaltfläche standardmäßig angezeigt wird.
Wenn Sie **Disabled** auswählen und zuvor **Make required** für eine Umfrage aktiviert haben, wird die Schaltfläche automatisch aktiviert, sobald Benutzer alle erforderlichen Elemente auf demselben Bildschirm beantwortet haben.
* **Redirection URL:** Die URL, zu der Benutzer, die auf die Schaltfläche klicken, weitergeleitet werden.
* **Open in new tab:** Schalten Sie um, ob die Weiterleitungs-URL in einem neuen Tab geöffnet wird.
#### Design
Das Menü **Design** enthält zwei Registerkarten: **General** und **Style**.
##### General
In der Registerkarte **General** können Sie Folgendes festlegen:
* **Alignment:** Ändert die Ausrichtung der Schaltfläche.
* **Reposition and resize:** Sie können Ihre Schaltfläche auf der **X**- und **Y**-Achse positionieren oder ihre Breite und Höhe in Pixeln oder Prozent definieren.
* Klicken Sie auf **Activate translate settings**, um auf Übersetzungsoptionen zuzugreifen. Sie können Ihre Schaltfläche von ihrer aktuellen X- oder Y-Achsenposition um einen festgelegten Wert in Pixeln oder Prozent verschieben.
* **Devices Synchronization:** Wählen Sie ein Gerät aus und legen Sie fest, wie die Schaltfläche mit anderen Geräten synchronisiert wird.
* **Fully synchronized:** Alle Eigenschaften der Schaltfläche werden mit dem Master-Gerät synchronisiert.
* **Partially synchronized:** Alle Eigenschaften der Schaltfläche werden mit dem Master-Gerät synchronisiert, es sei denn, eine Eigenschaft ändert sich auf einem anderen Gerät.
* **No synchronization:** Keine der Eigenschaften der Schaltfläche wird mit dem Master-Gerät synchronisiert. Sie müssen die Eigenschaften der Schaltfläche auf diesem Gerät separat festlegen.
* **Hide:** Die Schaltfläche wird auf dem Gerät nicht angezeigt.
* **Padding:** Fügt Abstand zwischen den Rändern der Schaltfläche und ihrem Text hinzu.
* **CSS And Classes:** Fügen Sie CSS und Klassen hinzu, um Ihre Schaltfläche zu gestalten.
##### Style
In der Registerkarte **Style** können Sie Folgendes festlegen:
* **State:** Kann **Enabled**, **Hover** oder **Disabled** sein.
* **Text:** Legt die Zeilenhöhe des Textes fest und wendet die gewünschten Transformationen an.
* **Background:** Ändert den Hintergrundtyp oder die Farbe der Schaltfläche.
* **Border:** Fügt einen Rahmen um alle Seiten der Schaltfläche oder einen benutzerdefinierten Rahmen hinzu.
* **Shadow:** Fügt einen Schatten hinzu und bearbeitet dessen Farbe oder Position.
### Short Answer und Long Answer
#### Allgemeine Einstellungen
* **Label/Question:** Die Hauptaufforderung/Frage.
* **Placeholder (optional):** Text, der vor der Benutzereingabe angezeigt wird; verschwindet, sobald der Benutzer mit der Eingabe beginnt.
* **Pre-filled value (optional):** Fügt eine vordefinierte Antwort in das Feld ein.
* **Default state:** Bestimmt, ob das Feld beim Laden aktiviert oder deaktiviert ist.
#### Erweiterte Einstellungen
* **Label position:** Positionieren Sie das Label über oder unter dem Eingabefeld.
* **Character limit:** Maximale Anzahl an zulässigen Zeichen.
* **Make required:** Zwingt Benutzer, eine bestimmte Frage vor dem Absenden zu beantworten. An das Label wird automatisch ein `*` angehängt. Durch Aktivieren von **Make required** wird der Abschnitt **Validation rule** angezeigt, in dem Sie zusätzliche Eingabebeschränkungen festlegen können.
* **Validation rule:**
| Regeltyp | Beschreibung |
| ---------------- | ------------------------------------------------------------------------------- |
| **Not empty** | Die Eingabe darf nicht leer sein. |
| **Alphanumeric** | Akzeptiert nur Buchstaben und Zahlen. |
| **Length** | Legen Sie eine min./max. Zeichenanzahl fest. |
| **Regex** | Wenden Sie einen benutzerdefinierten regulären Ausdruck zur Formatkontrolle an. |
* **Error message:** Benutzerdefinierte Meldung, die bei fehlgeschlagener Validierung angezeigt wird. Der Stil der Fehlermeldung kann in **Design** > **Answers** konfiguriert werden, indem Sie den Zustand **Invalid** auswählen.
### Multiple Choice
#### Allgemeine Einstellungen
* **Question:** Der Fragetext, der über den Antworten angezeigt wird.
* **Answers:** Fügen Sie Antwortmöglichkeiten hinzu, entfernen oder ordnen Sie sie neu. Klicken Sie auf **Add an answer**, um weitere Optionen zu erstellen.
#### Erweiterte Einstellungen
* **Multiple selection:** Erlaubt Benutzern, mehr als eine Antwort auszuwählen. Wenn deaktiviert, kann nur eine Antwort ausgewählt werden.
* **Add "Other":** Fügt eine offene Texteingabe mit der Bezeichnung „Other" hinzu, damit Benutzer eine benutzerdefinierte Antwort schreiben können.
* **Randomize answers:** Mischt die Reihenfolge der aufgeführten Antworten für jeden Benutzer zufällig, um die Auswahlverzerrung zu reduzieren.
* **Make required:** Wenn aktiviert, müssen Benutzer mindestens eine Antwort auswählen, um die Umfrage abzusenden. Nach dem Frage-Label wird automatisch ein `*` angehängt (gleicher Stil wie **Question** in der Registerkarte **Design**).
### Scale
#### Allgemeine Einstellungen
* **Scale type:** Emojis, Stars, Hearts oder Numbers.
* **Scale item count:** Anzahl der Werte auf der Skala (z. B. 1-5).
* **Question:** Die Hauptaufforderung.
#### Skalen-Labels
* **Label position:** Wählen Sie, ob Labels über, unter oder gar nicht angezeigt werden sollen.
* Sie können Labels für jedes Skalenelement anpassen.
#### Erweiterte Einstellungen
**Make required:** Verpflichtende Antwort vor dem Absenden.
### NPS
#### Fragestruktur
* Der Wortlaut der NPS-Frage ist aufgrund der Standardisierung teilweise festgelegt. Nur Teile der Frage können bearbeitet werden. Um die Sprache zu ändern, gehen Sie zur Registerkarte **Translation** und legen Sie eine Standardsprache fest.
#### Felder
* **How likely are you to recommend (X) to (Y)?**
* Sie können die Felder für Produkt/Dienstleistung und Ziel bearbeiten.
* **Follow-up question (optional):**
* Kann **All users** oder nur folgenden Gruppen angezeigt werden:
* Promoters (Score 9-10)
* Passives (Score 7-8)
* Detractors (Score 0-6)
* Ermöglicht bedingte Folgeinhalte.
* **Make required:** Nur der **anfängliche NPS-Score** kann als erforderlich markiert werden. Die Folgefrage ist immer optional.