Eingebettete Daten in Website-/App-Analysen

Informationen zu eingebetteten Daten in Website-/App-Analysen

Alle Informationen, die von Website / App Insights nachverfolgt werden können, können auch an Ihre Ziel-Website oder Ziel-Umfrage gesendet werden. Wenn Ihr Ziel beispielsweise eine Website-Zufriedenheitsumfrage ist, können Sie Informationen darüber speichern, wie lange der Teilnehmer auf der Website war oder wie viele Seiten er besucht hat. Diese Informationen werden nicht im Intercept oder Creative selbst gespeichert, sondern an Ihre Website oder Umfrage weitergegeben.

Sie können Informationen an Umfragen oder Ihre Site übergeben, indem Sie eingebettete Daten festlegen. Eingebettete Daten sind benutzerdefinierte Variablen, die benannt und auf beliebige Werte gesetzt werden können. Beispiel: Sie verfügen über eingebettete Daten mit dem Namen Standort, die den Wert USA, Kanada, Irland usw. haben können.

Wann werden eingebettete Daten erfasst?

Standardmäßig werden eingebettete Daten unmittelbar vor der Anzeige der Umfrage für den Umfrageteilnehmer erfasst.

Bestimmte Creative-Typen und Konfigurationen ändern dieses Verhalten jedoch:

• Feedback-Schaltfläche: Eingebettete Daten werden gesammelt, wenn der Website-Besucher auf die Feedback-Schaltfläche klickt.
• Responsive-Dialogfeld: Die Option „Umfrage direkt im Dialog anzeigen“ ändert die Art und Weise, wie eingebettete Daten gesammelt werden:
  • Wenn diese Option aktiviert ist, wird die Umfrage direkt in das Creative eingebettet, und eingebettete Daten werden erfasst, sobald das Creative geladen wird.
  • Bei Deaktivierung zeigt das Creative eine Schaltfläche zum Öffnen eines neuen Fensters für die Umfrage an, und die Daten werden erfasst, wenn dieses neue Fenster geladen wird.
• Kreative Ziele: Für benutzerdefiniertes eingebettetes Feedback, Popover-Creatives, Pop-under-Creatives, Slider-Creatives und Infobar-Creatives steuert das Creative-Ziel, wie eingebettete Daten gesammelt werden:
  • Eingebettete Umfrage: Wenn die Umfrage in das Creative eingebettet ist, werden eingebettete Daten erfasst, sobald das Creative angezeigt wird.
  • Verknüpfte Umfrage: Wenn die Umfrage über einen Link oder eine Drucktaste geöffnet wird, werden eingebettete Daten erfasst, wenn auf den Link oder die Drucktaste geklickt wird.
    Tipp: Wenn bei Popups unter Creatives die Umfragensitzung beim Ändern der Seite oder beim Beenden der Website beginnt, werden eingebettete Daten erfasst, bevor das Popup-Fenster geöffnet wird.
• Templated eeingebettet Feedback: Sobald die erste Frage im vorlagenbasierten eingebetteten Feedback-Creative eingereicht wird, werden eingebettete Daten erfasst. Beispiel: Ein eingebettetes Feedback-Creative, das eine Frage „War das hilfreich“ fragt, gefolgt von einer Freitexteingabefrage, erfasst eingebettete Daten, sobald der Benutzer auf „Ja“ oder „Nein“ für die erste Frage klickt.

Aktualisieren eingebetteter Daten nach dem Öffnen der Umfrage

Einige Creatives aktualisieren fortlaufend eingebettete Daten, wenn sie auf Ihrer Website aktualisiert werden, während die Intercept-Umfrage geöffnet ist. Wenn beispielsweise das Intercept das Öffnen einer Umfrage in einem neuen Fenster auslöst und der Website-Besucher zu einer neuen Seite auf Ihrer Website navigiert, werden die eingebetteten Daten, die mit dieser offenen Umfragensitzung verknüpft sind, aktualisiert, um diese neue Seite widerzuspiegeln.

Darüber hinaus sind Intercepts nicht die einzige Möglichkeit, eingebettete Daten zu sammeln. Eingebettete Datenwerte werden in der folgenden Reihenfolge gesammelt:

1. Eingebettete Intercept-Daten werden zuerst gesammelt. Weitere Informationen finden Sie unter Wann werden eingebettete Daten erfasst? für spezifische Informationen, die vom Creative des Intercepts abhängen.
2. Eingebettete Daten des Umfragenverlaufs werden gesammelt, nachdem die Umfrageantwort übermittelt wurde. Weitere Informationen finden Sie unter Eingebettete Daten.
3. Eingebettete XM-Directory-Daten werden zuletzt angewendet, wenn das Intercept mit XM Directory verknüpft ist und der Kontakt bereits im Verzeichnis vorhanden ist.

Wenn in diesen drei Schritten identische eingebettete Datenschlüssel vorhanden sind, werden die zuletzt gesammelten Werte in der Umfrageantwort erfasst. Wenn beispielsweise ein Feld namens „customerId“ durch das Intercept, den Umfragenverlauf und XM Directory festgelegt wird, wird der XM Directory-Kontaktwert für die „customerId“ in der Umfrageantwort gespeichert.

Eingebettete Daten festlegen

In der Regel geben Sie eingebettete Daten für einzelne Aktionen in Ihrem Intercept an. Angenommen, Sie randomisieren zwei verschiedene Aktionssätze. Bei einer Aktion können Sie ein eingebettetes Datenfeld namens “Bedingung” mit dem Wert “Version 1” und bei einer anderen Aktion ein eingebettetes Datenfeld “Bedingung” mit dem Wert “Version 2” hinzufügen.

Eingebettete Daten für eine beliebige Aktion festlegen

1. Klicken Sie bei jeder Aktion auf Optionen.
   
2. Wählen Sie Eingebettete Daten.
3. Geben Sie einen Namen für das erste eingebettete Datenfeld ein.
   
4. Wählen Sie den Werttyp aus.
   Tipp: Ein statischer Wert bedeutet, dass der Wert des eingebetteten Datenfelds für jeden Besucher identisch ist, der diese Aktion erhält (z. B. 1 Aktion „Bedingung“ mit dem Wert 1 und die andere „Bedingung“ mit dem Wert 2). Die anderen eingebetteten Datenwertoptionen sind dynamisch, d.h. sie passen sich abhängig vom jeweiligen Besucher an (z. B. welche Seite der Besucher sah, als er das Creative sah).
5. Wenn ein Feld bereitgestellt wird, geben Sie einen Wert für Ihre eingebetteten Daten ein.
   
6. Wenn Sie zusätzliche eingebettete Datenfelder hinzufügen möchten, klicken Sie auf das Pluszeichen (+) rechts neben dem ersten Feld, und wiederholen Sie die Schritte 4 bis 6.
7. Klicken Sie auf Speichern.

Mehrere eingebettete Datenfelder

Es gibt ein Limit von 20 KB beim Sichern eingebetteter Daten. Bestimmte Felder (z. B. Aufgezeichneter Website-Verlauf) nehmen mehr von diesem Platz ein als andere. Sollte nicht genügend Platz zum Senden aller eingebetteten Datenfelder an die Ziel-Website vorhanden sein, werden die Felder oben in der Liste priorisiert.

Sie können die Priorität eingebetteter Datenfelder festlegen, indem Sie einfach auf die Punkte links neben einem beliebigen Feld klicken und das Element in der Liste nach oben oder unten verschieben.

Eingebettete Daten als Creative festlegen

In den obigen Schritten wurde beschrieben, wie Sie eingebettete Daten für eine bestimmte Aktion sichern. Wenn Sie jedoch möchten, dass alle Aktionen, die ein bestimmtes Creative verwenden, dieselben eingebetteten Daten haben, können Sie auch eingebettete Daten für das Creative selbst festlegen. Die Schritte sind identisch, aber Sie finden das eingebettete Datenmenü, indem Sie mit der rechten Maustaste auf das Ziel Ihres Creatives klicken, auf den Dropdown-Pfeil in der Symbolleiste oben klicken und Eingebettete Daten auswählen.

Diese finden Sie auch im Abschnitt Bearbeiten Ihres Creatives.

Eingebettete Daten für mehrere Ziele mit JavaScript festlegen

Manchmal möchten Sie eingebettete Datenwerte für mehrere Bilder oder Ziele in Ihrem Creative festlegen. Das eingebettete Datenfeld kann jedoch nicht mehrere Ziele im Creative haben. Um Informationen zu erfassen und weiterzugeben, können Sie JavaScript verwenden, um mehrere eingebettete Datenfelder anzulegen, die jeweils einen eigenen Wert haben.

<div onclick="window._qLastClicked = 'Happy';">

Um die größte Flexibilität bei der Übergabe eingebetteter Daten und der Auswahl von Targeting-Bedingungen für die Anzeige von Intercepts zu ermöglichen, nutzt Qualtrics die integrierte Eval-Funktion des Browsers für JavaScript-Ausdrücke. Wenn die Sicherheitsrichtlinie Ihrer Website die Verwendung von eval nicht zulässt, wird in Ihrer Browser-Konsole möglicherweise ein Fehler wie “Abgelehnt, eine Zeichenfolge als JavaScript auszuwerten, da ‘unsafe-eval’ keine zulässige Quelle des Skripts in der folgenden Content-Sicherheitsrichtlinien-Direktive ist” angezeigt.

Wenn dieser Fehler auftritt und Sie die Einstellungen der Inhaltssicherheitsrichtlinie Ihrer Site nicht aktualisieren können, müssen Sie mit Ihrem Entwicklungsteam zusammenarbeiten, um den folgenden Codeblock auszuführen, bevor Qualtrics lädt:

window.QSI = window.QSI || {};
window.QSI.config = window.QSI.config || {};
window.QSI.global = window.QSI.global || {};
window.QSI.config.enableSecureVariables = true;
window.QSI.global.enableJSSanitization = true;

Nachdem Sie diesen Codeblock ausgeführt haben, können Sie eine begrenzte Teilmenge von JavaScript in Ihren Targeting-Bedingungen und eingebetteten Datenfeldern verwenden. Diese Teilmenge von JavaScript erlaubt nur den Variablenzugriff mit den Operatoren Punkt („.“) und Klammer („[]“), sodass Sie Variablenkontext sammeln können, ohne sich Sorgen um Sicherheitsbedenken bezüglich der Funktionsausführung machen zu müssen. Sie können keine Funktionsaufrufe wie document.querySelector() verwenden.

Eingebettete Datenwerttypen

Wenn Sie den Wert Ihrer eingebetteten Daten festlegen, können Sie auswählen, um welche Art von Variablen es sich bei diesen eingebetteten Daten handelt. Nachfolgend finden Sie eine Erläuterung dazu, was jeder Typ von eingebetteten Daten erfasst, und zugehörige Abfangbedingungen.

• Statisch: Legen Sie benutzerdefinierte eingebettete Daten an, und definieren Sie deren Werte.
• Intercept-ID: Hiermit wird die interne ID des Intercept erfasst. Diese ID kann verwendet werden, um zu sehen, welches Intercept ein Besucher gesehen hat, wenn Sie mehrere Intercepts haben, die wieder mit derselben Site/Umfrage verknüpft sind.
• Creative-ID: Hier wird die interne ID des Creatives erfasst. Diese ID kann verwendet werden, um zu sehen, welches Creative ein Besucher gesehen hat, wenn Sie mehrere Creatives haben, die wieder mit derselben Site/Umfrage verknüpft sind.
• Aufgezeichneter Website-Verlauf: Hier werden alle Websites erfasst, die Ihr Besucher besucht hat und die den Projektcode auf der Seite aufweisen. Diese Informationen werden in einem Cookie gespeichert, den Website / App Insights auf dem Browser platziert.
  Tipp: Die Menge der aufgezeichneten Geschichte hängt von den Limits ab, die auf diesem Cookie platziert sind. Das Limit wird auf der Admin-Seite festgelegt.
• Ereignis-Tracking: Ermöglicht Ihnen, das Ereignis-Tracking einzurichten.
• Adobe Analytics: Siehe Adobe Analytics.
• Adobe Experience ID: Siehe Adobe Analytics.
• Anzahl einmaliger besuchter Seiten: Damit wird die Anzahl der verschiedenen Seiten erfasst, die der Benutzer auf Ihrer Site besucht hat. Beispielsweise zählt das doppelte Aufrufen derselben Seite als 1 Seite. Siehe Seitenzählungsbedingungen.
• Gesamtanzahl besuchter Seiten: Damit wird die Gesamtzahl der Seiten erfasst, die der Benutzer auf Ihrer Site besucht hat. Siehe Bedingungen für Seitenanzahl.
• Auf der Website aufgewendete Zeit: Die auf der Website aufgewendete Zeit erfasst zwei Metriken: die Zeit, die vor Ort aufgewendet wird, und die Zeit, die vor Ort konzentriert wird. Die Zeit, die vor Ort verbracht wird, bezieht sich darauf, wie lange der Besucher Ihre Website in einem Browserfenster geöffnet hat. Zeit fokussiert Auf Site bezeichnet, wie lange der Besucher seine Website als vorderes, „fokussiertes“ Fenster auf seinem Computer geöffnet hat.  Siehe Aufgewendete Zeit auf Site oder Zeit fokussiert auf Site.
  Tipp: In Ihren Daten werden die auf der Website aufgewendete Zeit und die auf der Website fokussierte Zeit zusammen als zwei Zahlen gespeichert, die durch eine vertikale Linie getrennt sind. Die Zahl auf der linken Seite der Zeile ist die Zeit, die vor Ort benötigt wird, während die Zahl rechts neben der Zeile die Zeit im Fokus auf der Site ist.
  
• Aktuelle Seiten-URL: Die Seite, auf der sich der Besucher befindet, wenn das Intercept erscheint. Siehe Aktuelle Seiten-URL.
• HTML auf Site: Geben Sie das HTML auf der Seite an, für die Sie den Wert erfassen möchten. Beispiel: Sie haben ein Element für Ihren Einkaufswagen und möchten wissen, wie viele Artikel sich im Warenkorb des Besuchers befinden. Siehe HTML auf Site.
• Wert aus Cookie: Erfassen Sie den Wert aus einem bestimmten Cookie auf Ihrer Website. Beispiel: Sie haben ein Cookie namens return_visitor, das erfasst, ob jemand Ihre Site bereits besucht hat oder nicht. Siehe Cookie-Bedingung.
• URL-Parameter: Wenn auf Ihrer Website Parameter zu den URLs hinzugefügt wurden, können Sie mit dieser Option den Wert eines beliebigen Parameters erfassen.
• URL-Regex: Erfasst Regex-Quelltext.
  Tipp: Regex ist eine benutzerdefinierte Quelltextfunktion. Leider kann der Qualtrics Support Sie nicht in Bezug auf benutzerdefinierten Code beraten. Stattdessen können Sie sich gerne in unserer Benutzer-Community erkundigen.
• Wert aus JavaScript: Diese Option erfasst benutzerdefiniertes JavaScript von Ihrer Site. Der angegebene Wert muss ein JavaScript-Ausdruck/-Aufruf sein.
  Tipp: JavaScript ist eine benutzerdefinierte Coding-Funktion. Leider kann der Qualtrics Support Sie nicht in Bezug auf benutzerdefinierten Code beraten. Stattdessen können Sie sich gerne in unserer Benutzer-Community erkundigen.
• Page Referrer: Die Seite, auf der sich der Besucher befand, bevor er mit Ihrem Intercept auf die Seite kam. Siehe Page Referrer.
• Site Referrer: Die Website, auf der sich der Besucher befand, bevor er auf Ihrer Website ankam. Siehe Site Referrer.
• Suchbegriff: Erfasst den Begriff, nach dem der Besucher auf Ihrer Website angekommen ist. Siehe Suchbegriff.
• Wert aus Google Data Layer: Diese Option erfasst benutzerdefinierte Google-Data-Layer-Variablen von Ihrer Website. Siehe Google Analytics in Website-/App-Analysen verwenden.

Speichern eingebetteter Daten in einer Qualtrics-Umfrage

Wenn es sich bei Ihrem Ziel um eine Qualtrics-Umfrage handelt, stehen eingebettete Daten, die an sie gesendet werden, zur Verwendung in der Umfragelogik zur Verfügung, ohne dass eine zusätzliche Aktion erforderlich ist. Wenn Sie diese eingebetteten Daten jedoch in den Umfrageergebnissen speichern möchten, müssen Sie sie Ihrem Umfragenverlauf hinzufügen.

Führen Sie die Schritte auf der Supportseite für eingebettete Daten aus, um sie Ihrem Umfragenverlauf hinzuzufügen. Behalten Sie für den Wert des Felds die Einstellung Wert wird aus Panel oder URL gesetzt bei.

Eingebettete Daten mit anderen Zielen verwenden

Auch wenn es sich bei Ihrem Ziel nicht um eine Qualtrics-Umfrage handelt, können Sie dennoch eingebettete Daten nutzen und die Informationen wie bei einer Qualtrics-Umfrage weitergeben. Die eingebetteten Daten werden im Request-Body (POST-Methode) übergeben, sodass Sie mehrere eingebettete Datenelemente erfassen und an die Qualtrics-XM-Plattform senden können, ohne sie in der sichtbaren Umfrage-URL sehen zu müssen.

Eingebettete Datensammlung testen

Sie können testen, welche eingebetteten Daten gesammelt wurden, indem Sie dieses Snippet in der Entwicklerkonsole ausführen, wenn Sie erwarten würden, dass eingebettete Datenwerte vom Intercept gesammelt werden:

window.QSI.EmbeddedData.getEmbeddedData('YOUR_INTERCEPT_ID')

Wenn die gesammelten Werte nicht Ihren Erwartungen entsprechen oder leer sind, hängt die Fehlerbehebung davon ab, welche Art von eingebetteten Daten Sie sammeln möchten:

1. Statisch: Wenn statische eingebettete Datenfelder fehlen oder falsch sind, müssen Sie möglicherweise die neueste Version des Intercepts veröffentlichen.
2. Google-Datenschicht: Wenn in der Google-Datenschicht eingebettete Datenfelder fehlen oder falsch sind, haben Sie möglicherweise den falschen Datenschicht-Ausdruck. Alternativ kann der Wert durch eine nachfolgende Aktualisierung der Datenschicht überschrieben worden sein. Qualtrics verfolgt nur den neuesten Wert in der Datenschicht. Weitere Informationen zur Integration der Google-Datenschicht mit einem Intercept finden Sie unter Google Analytics mit Website/App Insight verwenden.
3. JavaScript: Wenn falsche eingebettete JavaScript-Datenfelder fehlen, haben Sie möglicherweise den falschen Ausdruck. Bitte arbeiten Sie mit Ihrem Entwicklungsteam zusammen, um zu bestätigen, dass die Variable, die Sie suchen, auf der Seite, die Sie testen, vorhanden ist.

Fehlerbehebung bei leeren oder falschen eingebetteten Daten in Umfrageantworten

Wenn die Variablen beim Testen angezeigt werden, aber nicht in der tatsächlichen Umfrageantwort, kann es zu einem Timing-Problem zwischen dem Zeitpunkt, an dem Qualtrics die Daten erfasst, und dem Zeitpunkt, an dem die Daten tatsächlich auf der Seite verfügbar sind, kommen.

Führen Sie die folgenden Schritte aus, um Fehler zu beheben:

1. Laden Sie die Seite neu, und testen Sie dann Ihre eingebetteten Daten mithilfe des Code-Snippets im obigen Abschnitt.
2. Führen Sie den folgenden Code in Ihrer Browser-Konsole aus:
   QSI.API.unload();
QSI.API.load().then(QSI.API.run);
3. Nehmen Sie an der Umfrage teil.
4. Eine HTTPS-Anforderung wird im Netzwerkprotokoll der Website angezeigt, wenn eine Umfragesitzung über ein Intercept beginnt. Diese Anforderung enthält die Umfrage-ID und alle zugeordneten eingebetteten Daten aus der Intercept-Konfiguration. Wenn Sie die Payload dieser Anfrage prüfen, können Sie überprüfen, ob die Sitzung mit eingebetteten Daten gestartet wurde.

Wenn nun die korrekten Werte übergeben werden, handelt es sich wahrscheinlich um ein Timing-Problem, und Sie müssen Ihr Intercept auslösen, nachdem die Datenwerte auf Ihrer Seite ausgefüllt wurden. Dies kann über die QSI.API-Aufrufe oder über einen Tag-Manager erfolgen. Weitere Informationen finden Sie unter Projekt-Bereitstellungscode.

Anzeigen von eingebetteten Intercept-Daten in einem Dashboard

Möglicherweise möchten Sie Ihre Web-/App-Analysen in einem CX-Dashboard anzeigen. In diesem Abschnitt werden die allgemeinen Schritte zum Anzeigen Ihrer eingebetteten Daten in einem lesbaren Format behandelt.

1. Fügen Sie in Ihrer Intercept-Logik die eingebetteten Datenfelder hinzu, die Sie in Ihrem Dashboard anzeigen möchten.

   Tipp: Allgemeine Felder sind:

   • Intercept-ID: Zum Anzeigen der ID oder des Namens des Intercepts.
   • Creative-ID: Zum Anzeigen der ID oder des Namens des Creatives.
   • Wert aus JavaScript: Zur Anzeige von Daten aus einem JavaScript-Ausdruck.
   • Adobe Analytics-Variablen: Zum Anzeigen von Daten aus Adobe Analytics benutzerdefinierter eVars.
   • Statischer Wert: Zur Übergabe eines benutzerdefinierten Werts, z. B. des Intercept-Namens, des kreativen Namens oder Informationen über Ihre Website.
2. Fügen Sie in der in Ihrem Intercept angezeigten Umfrage eingebettete Datenfelder hinzu, die mit Ihren Intercept-Feldern übereinstimmen.
   
3. Ordnen Sie Ihre Umfrage einem CX-Dashboard zu, und stellen Sie sicher, dass Ihre eingebetteten Datenfelder enthalten sind.
4. Wenn ein Feld wie Intercept-ID oder Creative-ID angezeigt wird, können Sie Ihre ID so umkodieren, dass stattdessen das Intercept oder der Creative-Name angezeigt wird.
   Beispiel: Im obigen Beispiel zeigen wir Daten aus zwei verschiedenen Creatives im selben Dashboard an. Um die Anzeige von Daten für einzelne Creatives benutzerfreundlich zu gestalten, haben wir Creative ID als eingebettetes Datenfeld hinzugefügt und die individuellen ID-Werte als Creative-Namen umkodiert. Anschließend können wir dieses Feld als Dashboard-Filter hinzufügen und dieses Feld in Widgets verwenden.

FAQs