zum Hauptinhalt springen
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Single-Page-Webanwendung

Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

Informationen zu Single-Page-Anwendungen

Single Page Applications (SPA) sind eine spezielle Art von Web-Apps. Ein SPA lädt eine einzelne Seite, wenn Sie eine Website aufrufen und ab diesem Zeitpunkt alle nachfolgenden Inhalte auf dieselbe Seite laden, auf der Sie navigieren. Dies funktioniert scheinbar wie eine normale Website, aber wenn Sie zwischen „Seiten“ wechseln, wird die Seite nicht neu geladen.

Standardmäßig wird Bereitstellungscode ausgeführt, sobald eine Webseite geladen wird. Da SPAs jedoch nicht aktualisiert werden, wenn Sie zwischen Seiten navigieren, wird der Bereitstellungscode nicht neu ausgewertet, wenn Sie zwischen Seiten navigieren. Wenn Sie die unten beschriebenen Techniken verwenden, können Sie den Bereitstellungscode nahtlos auf Ihrer SPA-Website verwenden.

Tipp: Einige dieser Techniken verwenden die JavaScript-API für Website-Feedback. Eine detaillierte Dokumentation zur JavaScript-API für Qualtrics-Website-Feedback finden Sie auf dieser Seite.
Achtung: Die folgende Dokumentation erfordert Programmierkenntnisse für die Implementierung. Wir empfehlen, diese Informationen an das Team weiterzuleiten, das Ihren Bereitstellungscode implementiert. Unser Support bietet keine Hilfe oder Beratung im Zusammenhang mit benutzerdefinierter Codeerstellung. Stattdessen können Sie sich gerne in unserer Benutzer-Community erkundigen. Wenn Sie mehr über unsere Services für kundenspezifisches Coding erfahren möchten, wenden Sie sich an Ihren Qualtrics Account Executive.
Tipp: Javascript ist nicht in allen Qualtrics-Lizenzen enthalten. Wenden Sie sich an Ihren Qualtrics Account Executive, wenn Sie Zugriff erhalten möchten.

Intercept-Logik bei URL-Änderung automatisch neu auswerten

Wenn Ihre Single-Page-Anwendung von der clientseitigen Weiterleitung für die Benutzernavigation abhängt, können Sie die Neubewertung von Intercepts bei nachfolgenden URL-Änderungen erzwingen, indem Sie die Intercept-Logik Neuevaluieren aktivieren, wenn sich die URL auf der Ebene des Website-Feedback-Projekts ändert. Wenn Sie diese Einstellung aktivieren, können Sie zusätzlich zur Auswertung, die beim initialen Laden der Seite erfolgt, auch die Abfanglogik auswerten.

Um die automatische Neubewertung der Intercept-Logik zu aktivieren, führen Sie die folgenden Schritte aus:

  1. Navigieren Sie in Ihrem Website-Feedback-Projekt zu den Einstellungen.Navigieren zu den Projektoptionen über die Seite „Einstellungen“ im Website-Feedback
  2. Klicken Sie auf Projekt verwalten.
  3. Wählen Sie Projektoptionen aus dem Dropdown-Menü aus.
  4. Stellen Sie sicher, dass die Intercept-Logik neu ausgewertet wird, wenn die URL-Änderungen im Abschnitt Support für Single-Page-App (SPA) markiert ist.Intercept-Logik neu auswerten, wenn die URL-Änderungsoption in den Projektoptionen markiert ist
Tipp: Wenn Sie dieses Verhalten testen möchten, müssen Sie das Bookmarklet auf Projektebene verwenden. Sie können dieses Verhalten nicht mit dem Bookmarklet eines bestimmten Intercepts testen.

Achtung: Wenn Sie diese SPA-Einstellung in Verbindung mit der Intercept-Level-Option zum Anzeigen mit benutzerdefiniertem JavaScript-Code (manuell) verwenden möchten, müssen Sie trotzdem den 

QSI.API.run();

Methode, um das Intercept abzurufen, das auf jeder SPA-Seite angezeigt werden soll.

Manuelle Implementierung mit JavaScript-API

Tipp: Eine detaillierte Dokumentation zur JavaScript-API für Qualtrics-Website-Feedback finden Sie auf dieser Seite.

Diese Methode beschreibt, wie Sie Ihren Deployment-Code so umstellen können, dass er manuell ausgeführt wird.  Das bedeutet, dass der Deployment-Code erst dann ausgeführt oder die zugehörige Logik ausgewertet wird, wenn die entsprechende JavaScript-API-Anforderung initiiert wurde.

Manuell einzuspielen

  1. Navigieren Sie zur Registerkarte Einstellungen.
    Navigieren zu den Projektoptionen über die Seite „Einstellungen“ im Website-Feedback
  2. Klicken Sie auf die Dropdown-Liste Projekt verwalten.
  3. Wählen Sie Projektoptionen.
  4. Aktivieren Sie die Option Projekt manuell laden.
    Die Option Projekt manuell laden ist in den Projekteinstellungen markiert.
  5. Kehren Sie zur Registerkarte Intercepts zurück, und legen Sie bei Bedarf die Logik auf Ihr Intercept oder den Aktionssatz fest.
    Festlegen der Logik auf der Intercepts-Seite
  6. Platzieren Sie den Bereitstellungscode auf Ihrer Website, vorzugsweise in einer globalen Kopf- oder Fußzeile, sodass er auf allen Seiten geladen wird.
  7. Fügen Sie die entsprechenden JavaScript-API-Anforderungen hinzu, je nachdem, wie oft Ihre Website auf das Intercept verweisen soll. Diese Anforderungen finden Sie im Abschnitt unten.

JavaScript-API-Anforderungen

Tipp: Eine detaillierte Dokumentation zur JavaScript-API für Qualtrics-Website-Feedback finden Sie auf dieser Seite.

Wenn Sie möchten, dass Qualtrics Ihr Projekt in einer einzigen Instanz bewertet, verwenden Sie diese beiden Anfragen:

  1. Diese Anforderung lädt den Deployment-Code für alle Intercepts und Creatives auf der Seite. Das „Laden“-API entspricht dem erneuten Laden einer Seite, auf der Code vorhanden ist. 
    QSI.API.load();
    Tipp: Wenn Sie in Ihren Projekteinstellungen Projekt manuell laden aktiviert haben, müssen Sie dieses API nicht aufrufen, um den Bereitstellungscode beim ersten Laden der Seite zu laden. Es ist nur erforderlich, das Laden zu erzwingen, um Zustandsänderungen auf der Seite zu berücksichtigen, die ohne erneutes Laden erfolgen.
  2. Dadurch wird die Auswertung des Deployment-Codes gestartet und alle Creatives werden angezeigt, wenn sie die Anzeigebedingungen erfüllen. 
    QSI.API.run();

Wenn Qualtrics Ihren Projektcode mehr als einmal auf derselben Seite bewerten soll, wiederholen Sie jeweils die folgenden drei Schritte:

  1. Diese Anforderung entfernt den Bereitstellungscode für alle Intercepts oder Creatives, die auf der Seite vorhanden sind. 
    QSI.API.unload();
  2. Dadurch wird der Bereitstellungscode für alle Intercepts oder Creatives auf der Seite geladen. Dies entspricht dem Neuladen der Seite. 
    QSI.API.load();
  3. Dadurch wird die Auswertung des Deployment-Codes gestartet und alle Creatives werden angezeigt, wenn sie die Anzeigebedingungen erfüllen. 
    QSI.API.run();

Häufig gestellte Fragen

Viele Seiten dieses Portals wurden mithilfe maschineller Übersetzung aus dem Englischen übersetzt. Obwohl wir bei Qualtrics die bestmögliche maschinelle Übersetzung ausgewählt haben, um ein möglichst gutes Ergebnis zu bieten, ist maschinelle Übersetzung nie perfekt. Der englische Originaltext gilt als offizielle Version. Abweichungen zwischen dem englischen Originaltext und den maschinellen Übersetzungen sind nicht rechtlich bindend.