Technische Dokumentation zu Website-/App-Analysen

Was ist ein Website-/App-Insights-Projekt und warum verwenden wir es auf unserer Website?

Qualtrics Website / App Insights hilft Unternehmen dabei, die Erfahrung eines Webbesuchers in ihren digitalen Medien zu messen und zu verbessern. Mit einem Website-/App-Insights-Projekt können Sie coole Grafiken auf Ihrer Website mit Links und eingebetteten Umfragen präsentieren, um Feedback zur Erfahrung Ihrer Besucher zu erhalten, sie über Ihre neuesten Angebote und Aktionen zu informieren und vieles mehr!

Sie und Ihre Kollegen haben Einfluss auf das Erscheinungsbild der Grafik (auch Kreativ genannt), die Bedingungen, unter denen sie erscheint (das Intercept), und den Code, mit dem sie implementiert wird.

Sobald der Code Ihres Projekts zu Ihrer Website hinzugefügt wurde, können Sie Änderungen aller Art vornehmen, ohne den Code jemals ändern oder Kontakt zu Ihrem IT-Team aufnehmen zu müssen. Machen Sie einfach die Arbeit in Qualtrics, und die Creatives und Intercepts Ihrer Websites werden sich entsprechend ändern.

Ist es sicher?

Wir übertragen keinerlei Daten auf die Qualtrics-Server, sofern diese nicht für die Evaluierung der Intercept Logik benötigt werden. Und selbst diese Daten werden nicht in unserem System gespeichert.

Zum Schutz dieser Daten bei der Übertragung sowie vor Mittelmannangriffen verwendet Qualtrics stets das „HTTPS“-Protokoll. Der Begriff Protokoll bezieht sich auf die Art und Weise, wie Inhalt zum Webbrowser eines Besuchers übertragen wird.

Wo finde ich den Projektcode zur Bereitstellung?

Bereitstellungscode (oder Projektimplementierungscode) finden Sie auf der Registerkarte Bereitstellung in Ihrem Projekt. Sie können den Code einfach kopieren und zur Implementierung an Ihr Web-Entwicklungsteam senden. Der Code muss nicht modifiziert werden.

Der Bereitstellungscode zeigt jedes Intercept an, das in diesem gesamten Projekt erstellt wurde.

Wie funktioniert der Code?

Bereitstellungscode ist asynchron und wird daher erst ausgeführt, nachdem alle anderen Inhalte einer Seite geladen wurden. Daher verhindert Bereitstellungscode auch nicht, dass andere Elemente Ihrer Seite geladen werden. Der Code wird ausgeführt, sobald das onLoad-Ereignis ausgelöst wurde.

Lassen Sie uns den Prozess durchgehen, was passiert, wenn ein Besucher eine Seite in seinem Browser anzeigt, die Bereitstellungscode enthält:

• Der Bereitstellungscode (in der Regel im HTML-Kopf platziert) wird sofort beim Laden der Seite ausgeführt und fügt am Ende des HTML-Bodys einen weiteren <script> -Tag ein, wenn das onLoad-Ereignis der Seite ausgelöst wird.
• Dieses <script> Tag fordert JavaScript-Code (Orchestrator) von Qualtrics-Servern an, der in einem Content Delivery Network (CDN) zwischengespeichert wird.
• Der Orchestrator ruft Qualtrics-Server gezielt auf, um zu ermitteln, welche Creatives angezeigt werden sollen. Diese Anfrage wird nicht im Cache des CDN gespeichert.
  • Gegebenenfalls wird ein zweiter Targeting-Request an die Server geschickt, um die benötigten Daten zu erhalten (z.B. JavaScript-Ausdruck oder Cookie-Targeting).
  • Qualtrics bezieht die Website-/App-Insights-Definition aus der Datenbank und erstellt den Code entsprechend.
• Je nach Targeting-Antwort erfolgen zusätzliche Anfragen über den Orchestrator, um die zur Darstellung der Seite benötigten Inhalte abzurufen. Die Anzahl der ausgeführten Anfragen hängt von der Anzahl der Creatives ab, um die Pass-Targeting-Logik anzuzeigen. Sämtliche Inhalte werden im Cache des CDN gespeichert, damit sie möglichst schnell geladen werden.
• Die Creatives werden auf der Seite angezeigt.

Der Bereitstellungscode ist dynamisch, was bedeutet, dass Änderungen, die an Intercepts und Creatives innerhalb der Website/App Insights Projektoberfläche vorgenommen werden, nicht dazu führen, dass sich der Code selbst ändert. Daher können Änderungen an Website-/App-Insights-Projekten von einem Konto aus vorgenommen werden, und Code muss nicht auf der Website ausgetauscht werden, damit die Änderungen angezeigt werden.

Wie stelle ich ein Website-/App-Insights-Projekt bereit?

1. Code direkt zu Ihren Webseiten hinzufügen

Bereitstellungscode kann an beliebiger Stelle zu einer Webseite hinzugefügt werden. Da der Code asynchron ausgeführt wird, beginnt der Ladevorgang erst, nachdem sämtliche Inhalte einer Webseite vollständig geladen sind (darunter Bilder, Script-Dateien, CSS-Dateien usw.).

Unsere Anfragen erfolgen, sobald das onLoad-Ereignis ausgelöst wird: https://www.w3schools.com/jsref/event_onload.asp

Darüber hinaus wird der Ort, an dem Creatives tatsächlich auf der Webseite erscheinen, durch Einstellungen bestimmt, die in der Qualtrics-Schnittstelle festgelegt werden. (Siehe Informationen zur benutzerdefinierten Position.) Daher hat die Position des Codes innerhalb der Seite keine Auswirkungen darauf, wo der Seiteninhalt angezeigt wird.

2. Globale Kopf-/Fußzeile (empfohlen)

Es wird empfohlen, den Bereitstellungscode in der globalen Kopf- oder Fußzeile hinzuzufügen. Dadurch wird der Code in einem Zug auf der gesamten Website angewendet. Diese Methode ist die einfachste Methode für das Deployment, da Sie nicht wiederholt Code zu mehr Seiten hinzufügen müssen, was ein langwieriger Prozess sein kann. Wenn Code auf diese Weise global zu Ihrer Site hinzugefügt wurde, können Sie die Logik Aktuelle URL in einem Intercept verwenden, um zu steuern, auf welchen Seiten ein Intercept tatsächlich angezeigt wird.

3. Tag-Manager verwenden

Eine weitere Option besteht darin, den Bereitstellungscode einem Tag-Management-System hinzuzufügen, anstatt ihn direkt auf den Standortcode anzuwenden. Code kann in der Qualtrics-Oberfläche kopiert und direkt in einen Tag Manager eingefügt werden.

Häufige Tag-Management-Systeme, die unsere Kunden in Verbindung mit Website / App Insights verwenden, sind Adobe Launch, Tealium, Ensighten und Google Tag Manager. Insbesondere Tealium verfügt über einen Assistenten, der eine einfache Implementierung von Website-/App-Erkenntnissen ermöglicht. Hierzu benötigen Sie lediglich die Zonen-ID des zu implementierenden Projekts sowie Ihre Organisations-ID.

Die Organisations-ID erhalten Sie, indem Sie zu den Kontoeinstellungen wechseln und die Registerkarte „Qualtrics-IDs“ auswählen.

Die mit ZN_ beginnende Zonen-ID finden Sie:

1. in der URL des Projekts, wenn Sie sich darin befinden, oder
   
2. Im Bereitstellungscode des Projekts.
   

Wer ist in der Regel an der Website-/App-Insights-Implementierung beteiligt?

Personen innerhalb Ihrer Organisation, die über die erforderlichen Berechtigungen verfügen, Inhalte zur Website Ihres Unternehmens hinzuzufügen. Im Normalfall handelt es sich dabei um Mitarbeiter von IT-Teams, Web-Content-Teams usw.

Werden Website-/App-Einblicke unsere Website verlangsamen?

Bereitstellungscode ist asynchron und wird daher erst ausgeführt, nachdem alle anderen Inhalte einer Seite geladen wurden. Daher verhindert Bereitstellungscode auch nicht, dass andere Elemente Ihrer Seite geladen werden. Der Code wird ausgeführt, sobald das onLoad-Ereignis ausgelöst wurde.

Was passiert, wenn Qualtrics offline ist? Ergeben sich dadurch Probleme auf unserer Website?

Wenn bei Qualtrics Ausfälle oder Probleme auftreten, werden die Intercepts einfach nicht auf der Seite angezeigt. Darüber hinaus hat dies keine Auswirkungen auf die Erfahrung des Besuchers auf Ihren Websites.

Wie schnell wird der Code auf meiner Website ausgeführt?

Bei über 50 % aller Anfragen ist davon auszugehen, dass der Bereitstellungscode innerhalb von 300 Millisekunden geladen wird. Bei über 90 % aller Anfragen ist von 750 Millisekunden auszugehen. Die Geschwindigkeit hängt vom geografischen Standort des Benutzers und der Anzahl der Intercepts und Creatives eines Projekts ab.

Debug-Fenster öffnen

Sie können das Debugging-Fenster verwenden, um zu diagnostizieren, warum ein Intercept nicht auf einer bestimmten Webseite angezeigt wurde. In diesem Fenster werden alle Bedingungen angezeigt, die erforderlich sind, damit das Intercept angezeigt wird und ob die Bedingungen erfolgreich waren oder fehlgeschlagen sind.

Wie Sie das Debugging-Fenster öffnen, hängt davon ab, wann Ihr Intercept implementiert wurde.

Vor März 2019 implementierte Intercepts

Für Intercepts, deren Bereitstellungscode vor März 2019 implementiert wurde, können Sie das Debug-Fenster aktivieren, indem Sie die Q_DEBUG-Abfragezeichenfolge an die URL anhängen. Dieser Query-String sollte mit einem ? angehängt werden. oder &, wie in den Beispielen unten dargestellt:

Nach März 2019 implementierte Intercepts

Führen Sie für Intercepts, deren Bereitstellungscode nach März 2019 implementiert wurde, die folgenden Schritte aus, um das Debugging-Fenster zu öffnen:

1. Öffnen Sie die Entwicklertools Ihres Browsers.
2. Führen Sie den folgenden JavaScript-Befehl aus:
   QSI.API.unload();
QSI.isDebug = true;
QSI.API.load();
QSI.API.run();

Tipps zur Fehlerbehebung

Intercept-Logik und Aktionssatzlogik

• Vergewissern Sie sich, dass die Werte korrekt sind.
• Untersuchen Sie Ihre Verwendung von “ist” vs. “Enthält”
• Prüfen Sie die Verwendung von Und/Oder-Logik.
• Vergewissern Sie sich, dass die Werte keine Leerstellen enthalten.

Revisionsverlauf

Stellen Sie sicher, dass es sich bei der veröffentlichten Version um die aktuellste Version handelt (oder um die Version, die Sie erwarten würden).

Sehen Sie sich die Website / App Insights Network Request an

1. Öffnen Sie Entwicklertools in Ihrem Browser.
2. Sehen Sie sich die Netzwerkanfrage für an.Q_ZID usw.
   • Keine Netzwerkanforderung: Die Implementierung funktioniert nicht.
   • Netzwerkanforderung: Prüfen Sie die Parameter der Anforderung auf Inkonsistenzen. Mitunter wird der Code mithilfe eines Tag-Management-Systems implementiert. In einigen Fällen kann es sein, dass diese Implementierung die Parameter unserer Anfrage der aktuellen URL usw. durcheinanderbringt.
   • Netzwerkaufforderung mit Fehler: Prüfen Sie, ob Ihr Projekt aktiviert ist.

Weitere hängende Skriptanfragen suchen, die unser Skript beeinträchtigen könnten

1. Klicken Sie mit der rechten Maustaste auf einen beliebigen Bereich der Seite in Ihrem Browser.
2. Wählen Sie Element prüfen.
3. Wählen Sie Console (hier werden Fehler angezeigt).

Häufig gestellte Fragen