Feedback-Integrationsleitfaden

Erfahren Sie, wie Sie ein Feedback-Widget hinzufügen, um Besucherfeedback zu sammeln.

Funktionsweise

Das PrivateStater Feedback-Widget bietet folgende Funktionen:

Skriptinstallation

Nutzen Sie die Methoden in diesem Dokument, um privatestater.js zu installieren.

Überspringen Sie diesen Abschnitt, wenn Sie das Skript bereits installiert haben.

Schritt 2: Feedback im Dashboard aktivieren

  1. Gehen Sie zu Dashboard > Website > Feedback > Einstellungen
  2. Schalten Sie Feedback aktivieren ein
  3. Konfigurieren Sie die nötigen Optionen

Einstellungsoptionen

Einstellung Beschreibung Standard
Aktivieren Feedback-Widget nutzen Deaktiviert
Localhost erlauben Tests auf localhost erlauben Deaktiviert
Texteingabe Text-Feedback erfassen Aktiviert
Emoji-Bewertung Emoji-Bewertung erfassen Aktiviert
Screenshot-Anhang Besucher können Screenshots anhängen Aktiviert
E-Mail-Erfassung E-Mail-Feld anzeigen Deaktiviert
Geräteinfo (Analytics) Feedback mit Analytics-Sitzungen verknüpfen Aktiviert
Konsolenfehler anhängen Erfasste Konsolen-Logs anhängen Aktiviert
Tägliche E-Mail-Zusammenfassung Maximal eine Digest-E-Mail pro Tag bei neuem Feedback Aktiviert
Widget-Position Position des schwebenden Buttons Unten rechts

Widget-Positionen

Wert Beschreibung
bottom-right Unten rechts (Standard)
bottom-left Unten links

Automatische Widget-Anzeige

Wenn Feedback aktiviert ist, erscheint automatisch ein schwebender Button auf Ihrer Website.
Zusätzlicher HTML-Code ist nicht nötig.

Ablauf

  1. Besucher klickt auf den schwebenden Button
  2. Feedback-Popup öffnet sich
  3. Emoji-Bewertung wählen (falls konfiguriert)
  4. Text eingeben (falls konfiguriert)
  5. Screenshot anhängen (falls konfiguriert)
  6. Auf Weiter klicken (oder direkt Senden, wenn Schritt 2 ausgeblendet ist)
  7. In Schritt 2 E-Mail eingeben (falls konfiguriert) und technische Anhänge wählen
  8. Absenden

Programmatischer Aufruf

Wenn Sie das Feedback-Widget von einem eigenen Button oder bei einem bestimmten Ereignis öffnen möchten:

window.PrivateStater.showFeedback();

Verwendungsbeispiele

<!-- Custom Feedback Button -->
<button onclick="window.PrivateStater.showFeedback()">
    Leave Feedback
</button>

// Request feedback on specific condition
if (userCompletedPurchase) {
    window.PrivateStater.showFeedback();
}

Optionen

window.PrivateStater.showFeedback({
    onClose: function() {
        console.log('Feedback widget closed');
    }
});

Erfasste Daten

Standardmäßig erfasste Daten

Feld Beschreibung Bedingung
Bewertung (rating) Emoji-Bewertung (1~4) Wenn Emoji-Bewertung aktiviert
Text (text) Feedback-Inhalt (max. 2000 Zeichen) Wenn Texteingabe aktiviert
E-Mail (email) E-Mail für Antworten Wenn E-Mail-Erfassung aktiviert
Screenshot (screenshot) Bildschirmaufnahme Wenn Nutzer anhängt

Emoji-Bewertung

Wert Emoji Deutsch Englisch
1 😠 Schlecht Hate
2 😕 Geht so Dislike
3 😊 Gut Like
4 😍 Super Love

Optionaler technischer Anhang

Wenn der Besucher den technischen Anhang im Widget aktiviert, kann PrivateStater zusätzlichen Kontext speichern:

Feld Beschreibung Bedingung
technicalAttachment Einwilligungsflag für technischen Kontext Immer im Submit-Payload enthalten
pageUrl URL bei Feedback-Abgabe Wenn technischer Anhang aktiviert
language Browsersprache Wenn technischer Anhang aktiviert
consoleLogs Erfasste Browser-Konsolen-Logs Wenn technischer Anhang und Konsolen-Logs aktiviert
analyticsSessionConsent Einwilligung zur Verknüpfung mit Analytics-Sitzung Wenn technischer Anhang und Geräteinfo aktiviert
visitorHash / sessionIndex / sessionStartedAt Felder zur Sitzungsverknüpfung für Analytics v2 Wenn Analytics-Sitzungsverknüpfung aktiviert

Bei älteren Feedback-Einträgen können Browser- und Gerätefelder noch vorhanden sein.

Feedback im Dashboard verwalten

Feedback-Liste

Im Dashboard sehen Sie gesammeltes Feedback:

Statusverwaltung

Status Beschreibung
Ungelesen Neu eingegangenes Feedback
In Bearbeitung Wird geprüft oder bearbeitet
Abgeschlossen Erledigt oder geschlossen
Blockiert Automatisch blockiertes Feedback

Funktionen

Statistiken

Statistik Beschreibung
Gesamt-Feedback Gesamtzahl im gewählten Zeitraum
Durchschnittsbewertung Durchschnittliche Emoji-Bewertung (1~4)
Ungelesen Anzahl ungelesenen Feedbacks

Styling

Das Feedback-Widget ist per Shadow DOM isoliert und wird von externem CSS nicht beeinflusst. Es passt sich automatisch an Dark und Light Mode an (Erkennung über prefers-color-scheme).

Mehrsprachigkeit

Das Feedback-Widget wird je nach Browsersprache automatisch auf Koreanisch oder Englisch angezeigt.
Für weitere Sprachen schreiben Sie mir an hello@privatestater.com, dann ergänze ich sie.

Temporäre Speicherung von Formulardaten

Schließt der Nutzer das Widget beim Schreiben, werden Eingaben vorübergehend gespeichert. Beim erneuten Öffnen wird der vorherige Inhalt wiederhergestellt.

Datenschutz

Fehlerbehebung

Widget wird nicht angezeigt

  1. Prüfen Sie, ob Feedback im Dashboard aktiviert ist
  2. Prüfen Sie die korrekte Skriptinstallation
  3. Prüfen Sie die Browser-Konsole auf Fehler

Funktioniert nicht auf localhost

Aktivieren Sie Localhost erlauben im Dashboard.

Screenshot-Anhang schlägt fehl