XM Directory-Integration mit digitalen Intercepts

Informationen zur XM Directory-Integration mit digitalen Intercepts

Mit XM Directory können Sie Ihr eigenes internes Panel mit umfangreichen Profilen Ihrer Kunden und Interessenten erstellen. Mit einem organisationsweiten Kontaktverzeichnis können Sie die zahlreichen Kontaktpunkte von Kontakten mit Ihrer Organisation anzeigen, sodass Sie einfacher denn je Erkenntnisse über ihre Erfahrung mit Ihrer Marke gewinnen können.

Durch die Integration von Website/App Insights mit XM Directory können Sie die Vorteile von XM Directory mit Ihren Website-Besuchern nutzen. Sie können die Omnichannel-Kontakthäufigkeit einrichten, um sicherzustellen, dass Ihre Website-Besucher keine E-Mail-Einladung erhalten, wenn sie bereits ein Web-Intercept erhalten haben, und umgekehrt. Sie können auch die Anzeige von Website- und App-Intercepts auf bestimmte Segmente von Benutzern ausrichten sowie segment- und reisespezifische Einblicke erhalten

Bevor Sie diese Funktion verwenden können, benötigen Sie Zugriff auf Folgendes:

1. Zugriff auf XM Directory.
2. Zugriff auf Website-/App-Feedback.
3. Kontakte oder Segmente innerhalb von 1 Ihrer Verzeichnisse.

Einrichten der Integration

XM Directory

Die Integration mit Website-Intercepts verwendet Ihre vorhandene XM Directory-Konfiguration. Wenn Sie Ihr Verzeichnis noch nicht eingerichtet haben, finden Sie weitere Informationen unter Getting Started with XM Directory.

Um die Integration optimal zu nutzen, befolgen Sie die folgenden Best Practices:

• Halten Sie Ihre Kontakte auf dem neuesten Stand. Dadurch kann Qualtrics unterscheiden, ob es sich bei Ihren Website-Besuchern um vorhandene Kontakte oder neue Besucher handelt.
  Beispiel: Richten Sie eine Automatisierung des Kontaktimports ein, um XM Directory mit Ihren Kundenlisten synchron zu halten, oder arbeiten Sie mit Ihrem Entwicklungsteam zusammen, um Kontakte mithilfe der Funktion zum Anlegen eines neuen Kontakts und Aktualisieren von Kontakt-API-Aufrufen zu erstellen.
• Doppelte Kontakte automatisch zusammenführen. Sie können nur neu angelegte Kontakte oder alle vorhandenen Kontakte zusammenführen. Weitere Informationen finden Sie unter Zusammenführen doppelter Kontakte in XM Directory.
  Tipp: Durch das Zusammenführen von Kontakten basierend auf dem Feld Externe Datenreferenz wird sichergestellt, dass jeder Kontakt einen eindeutigen Wert hat.

Intercepts

Um von Ihrem Website-/App-Insights-Projekt aus auf die Vorteile von XM Directory zugreifen zu können, müssen Sie zunächst sicherstellen, dass Qualtrics weiß, wer Ihre Website besucht, und diese Informationen mit Ihren vorhandenen Kontakten abgleichen können. Dazu müssen Sie den JavaScript-Ausdruck angeben, der in der angemeldeten Sitzung des Benutzers ausgewertet wird, um die externe Referenz-ID für den Kontakt zu erhalten.

Als Nächstes müssen Sie Informationen über Ihre Besucher an Qualtrics weiterleiten. Die Schritte unterscheiden sich, wenn Sie eine Website und eine mobile App verwenden.

Wenn Sie eine Website verwenden, arbeiten Sie mit Ihrem Webentwicklungsteam zusammen, um Ihrer Website zusätzlich zum Projektimplementierungscode den folgenden Code-Snippet hinzuzufügen. Das Snippet übergibt die externe Referenz-ID des Benutzers an Qualtrics, um den Website-Besucher mit einem Kontakt in XM Directory zu verknüpfen. Legen Sie diesen Code-Snippet beim Laden der Seite an, und stellen Sie sicher, dass der Wert der ID bereits abgerufen wurde.

Klicken Sie hier, um den Code-Snippet anzuzeigen.

if(typeof QSI === "undefined") {

     QSI = {};

     QSI.config = {

       externalReference: extRef

     };

 }

Wenn Sie eine mobile App verwenden, arbeiten Sie mit Ihrem Entwicklungsteam für mobile Apps zusammen, um die neueste Version des Qualtrics Mobile App SDK zu integrieren. Weitere Informationen finden Sie in der API-Dokumentation.

Verknüpfung mit XM Directory

Mit Link mit XM Directory können Sie eine Verknüpfung zwischen Ihrem Digital-Projekt und einem Verzeichnis aus XM Directory einrichten. Wenn diese Option ausgewählt ist, werden eingebettete Kontaktdaten für Benutzer automatisch zu ihrer Umfrageantwort hinzugefügt. Weitere Informationen finden Sie unter Eingebettete Daten mit XM Directory verwenden. Darüber hinaus wird jedes Mal, wenn Ihr Intercept angezeigt wird, ein Ereignis in der XM Directory-Kontaktpunkt-Zeitleiste Ihres Besuchers erstellt.

Verknüpfen von XM Directory mit Website & App-Insight-Projekt

1 Website & App-Insight-Projekt kann nur mit 1 Verzeichnis verknüpft werden. Dadurch wird sichergestellt, dass keine Probleme mit Kontakthäufigkeitsregeln auftreten, insbesondere wenn derselbe Kontakt in verschiedenen Verzeichnissen mit unterschiedlichen Häufigkeitsregeln vorhanden ist. Außerdem werden alle digitalen Kontaktpunkte an einem zentralen Ort zusammengefasst, um sie zu organisieren und zu pflegen.

Um ein Website&-App-Insight-Projekt mit einem Verzeichnis zu verknüpfen, wechseln Sie zur Registerkarte Einstellungen des Projekts, aktivieren Sie Link zu XM Directory, und wählen Sie das Verzeichnis aus der Dropdown-Liste aus.

Nachdem das Projekt mit einem Verzeichnis verknüpft wurde, können Sie ein Intercept mit einem Verzeichnis verknüpfen, indem Sie zu Intercept-Optionen wechseln und Dieses Intercept mit XM Directory verknüpfen auswählen.

Automatisches Anlegen von Ansprechpartnern

XM Directory-Kontakte können jedes Mal erstellt werden, wenn Benutzer Webseiten mit Qualtrics Website & App-Insights-Projektbereitstellungscode auf ihnen aufrufen. Diese Option ermöglicht das automatische Hinzufügen von Kontakten, wenn der Implementierungscode für Website & App Insights auf der Webseite ausgeführt wird, sodass keine manuellen Datei-Uploads oder SFTP-basierten Automatisierungen erforderlich sind.

Um die automatische Kontakterstellung zu aktivieren, müssen Sie zunächst das Projekt Website & App Insights auf der Registerkarte Projekteinstellungen mit dem XM Directory verknüpfen. Klicken Sie dann auf das Häkchen neben der Option Wenn der Kontakt nicht in Ihrem Verzeichnis vorhanden ist, fügen Sie ihn automatisch hinzu.

Sie können die folgenden Informationen für jeden Kontakt hinzufügen:

Vorname
Nachname
Sprache
Zusätzliche Schlüssel-Wert-Paare (z. „Standort“: „Seattle“, „Geschlecht“: „Weiblich“). Sie können bis zu 200 Paare hinzufügen.

Einrichten von Kontakthäufigkeitsregeln für Intercepts

Kontakthäufigkeitsregeln können konfiguriert werden, um die Häufigkeit der Anzeige eines Intercepts einzuschränken. Sie können allgemeine Verzeichnisregeln sowie benutzerdefinierte Regeln für bestimmte Umfragen verwenden. Für Umfragen, die auf vielen Geräten oder Browsern angezeigt werden können, z.B. passive Feedback-Intercepts, empfehlen wir, die Kontakthäufigkeit nicht zu verwenden.

1. Öffnen Sie ein vorhandenes Website-/App-Feedback-Projekt, oder erstellen Sie ein neues Projekt.
2. Öffnen Sie ein vorhandenes Intercept, oder erstellen Sie ein neues Intercept.
3. Bearbeiten Sie die Optionen Anzeigehäufigkeit und XM Directory.
   
4. Aktivieren Sie Link with XM Directory.
   
   Tipp: Wenn diese Option ausgewählt ist, werden die eingebetteten Kontaktdaten für Benutzer, die an dieser Umfrage teilnehmen, automatisch zu ihrer Umfrageantwort hinzugefügt. Siehe Eingebettete Daten mit XM Directory verwenden.
5. Bestätigen Sie das ausgewählte Verzeichnis, das auf der Seite Einstellungen festgelegt wird.
6. Aktivieren Sie Kontakthäufigkeitsregeln.
7. Sichern Sie Ihre Änderungen.
8. Die nächsten Schritte unterscheiden sich je nachdem, ob Sie diese Funktion auf einer Website oder einer mobilen App implementieren.
   • Website: Geben Sie auf Ihrer Website, auf der Sie das Intercept starten, den JavaScript-Ausdruck an, der in der angemeldeten Sitzung des Benutzers ausgewertet wird, um die externe Referenz-ID für den Kontakt zu erhalten. Diese externe Referenz-ID wird verwendet, um den Besucher im XM Directory zu suchen und nachzuverfolgen, ob er Ihr Intercept gesehen hat.
   • App: In der App, in der Sie das Intercept starten, müssen Sie ein Update an Ihrem Mobile-App-SDK vornehmen, um die Referenz-ID abzurufen. Siehe API-Dokumentation.

Segmente für Intercept Targeting einrichten

Sobald Sie Segmente in XM Directory erstellt haben, können Sie sie in Qualtrics an vielen Stellen verwenden, an denen Mailinglisten und Beispiele möglich sind, einschließlich mit Website/App Insights. Die Kombination aus XM Directory und Website / App Insights ermöglicht es Ihnen, die Anzeige von Website- und App-Intercepts auf bestimmte Segmente von Benutzern auszurichten sowie segment- und reisespezifische Erkenntnisse zu erhalten.

1. Anlegen einer Intercept auf einem bestehenden oder neuen Website-/App-Feedback-Projekt.
   Tipp: Wenn Sie nicht ein eigenständiges Intercept erstellen, sondern während des gesamten Prozesses Hilfe benötigen, können Sie unsere geführte Einrichtung für Website-/App-Feedback-Projekte verwenden. Wenn Sie die geführte Einrichtung verwenden, werden Sie aufgefordert, ein Creative hinzuzufügen, Ihre Umfrage zu verbinden und Ihr Intercept zu konfigurieren. Weitere Informationen über die geführte Einrichtung finden Sie unter Wählen Sie, wie Sie Feedback sammeln möchten.
2. Navigieren Sie zu den Intercept-Optionen.
   
   Tipp: Die Schritte sind auf mobilen App-Intercepts gleich, aber Sie werden weniger Intercept-Optionen sehen.
3. AktivierenMit XM Directory verknüpfen“, indem Sie das Ankreuzfeld markieren.
4. Bestätigen Sie das ausgewählte Verzeichnis, das auf der Seite Einstellungen festgelegt wird.
5. Kehren Sie zum Intercept-Editor zurück, und fügen Sie eine Zielgruppenlogik hinzu, die Ihr XM-Directory-Segment enthält.
   Beispiel: XM Directory Segment Is High-Value-Users.
   Tipp: Auf Website-Intercepts können Sie das Intercept mit dem Bookmarklet sowohl mit Kontakten im Segment als auch mit Kontakten, die nicht im Segment sind, testen. Während der Tests müssen Sie die Einstellung der externen Referenz-ID in Ihrem Browser nachahmen, damit Qualtrics den Kontakt identifizieren kann.
6. Die nächsten Schritte unterscheiden sich je nachdem, ob Sie diese Funktion auf einer Website oder einer mobilen App implementieren.
   • Website: Geben Sie auf Ihrer Website, auf der Sie das Intercept starten, den JavaScript-Ausdruck an, der in der angemeldeten Sitzung des Benutzers ausgewertet wird, um die externe Referenz-ID für den Kontakt zu erhalten. Diese externe Referenz-ID wird verwendet, um den Besucher im XM Directory zu suchen und nachzuverfolgen, ob er Ihr Intercept gesehen hat. Weitere Informationen zum JavaScript-Ausdruck finden Sie im obigen Abschnitt.
   • App: In der App, in der Sie das Intercept starten, müssen Sie ein Update an Ihrem Mobile-App-SDK vornehmen, um die Referenz-ID abzurufen. Siehe API-Dokumentation.

Testen der XM Directory-Integration mit Website-Intercepts

Bevor Sie Ihr Intercept auf Ihrer Website starten, sollten Sie es testen, um sicherzustellen, dass die Kontakthäufigkeit, das Segment-Targeting oder die Kontakterstellung korrekt implementiert wurde.

In Ihrer tatsächlichen Bereitstellung ist die Externe Referenz-ID Ihres Website-Besuchers im Kontext der protokollierten Sitzung über einen JavaScript-Ausdruck oder ein Cookie verfügbar.

Mit den folgenden Schritten können Sie ein End-to-End-Szenario mit Testdaten und Web-Browser-Behelfslösungen durchführen.

Kontakthäufigkeit testen

1. Legen Sie in Ihrem XM Directory einen neuen Kontakt an, und geben Sie eine eindeutige Referenz-ID für diesen Kontakt an.
   Beispiel: Wir verwenden aaa123 als Beispielreferenz-ID. Wenn Sie die ID-Nummer in diesen Schritten sehen, ersetzen Sie sie durch die von Ihnen angegebene Referenz-ID.
2. Führen Sie die Schritte im Abschnitt Segmente für Intercept Targeting einrichten aus, um ein Intercept so zu konfigurieren, dass es dem Segment-Targeting folgt.
3. Gehe zu Intercept testen.
   
4. Ziehen Sie das Lesezeichen in die Lesezeichenleiste Ihres Browsers.
5. Navigieren Sie zu einer Webseite, die Sie zum Testen verwenden möchten.
6. Rufen Sie die Entwicklerkonsole auf. Abhängig von Ihrem Webbrowser erreichen Sie ihn unterschiedlich:
   • Google Chrome: Wählen Sie in der Menüleiste von Chrome View → Developer → Developer Tools. Navigieren Sie im daraufhin angezeigten Fenster zur MDM Console.
   • Apple Safari: Stellen Sie sicher, dass das Menü „Entwickeln“ für Safari aktiviert ist. Wählen Sie dazu in der Menüleiste Einstellungen → Erweitert → Entwicklermenü anzeigen. Klicken Sie im Safari-Menü auf Entwickeln, und wählen Sie Webinspektor anzeigen. Navigieren Sie im daraufhin angezeigten Fenster zur MDM Console.
   • Mozilla Firefox: Klicken Sie auf das Menüsymbol und wählen Sie dann Web Developer. Wählen Sie im Menü Web Developer die Konsole
   • Microsoft Edge: Wählen Sie in der Menüleiste Tools → Developer → Developer Tools. Navigieren Sie in dem sich öffnenden Fenster zur Konsole.
   • Internet Explorer: Klicken Sie auf das Zahnradsymbol, und wählen Sie Entwicklertools. Navigieren Sie in dem sich öffnenden Fenster zur Konsole.
7. Geben Sie im Menü Console diesen Ausdruck ein, und drücken Sie die Eingabetaste:
   UserID="aaa123".
   
   Tipp: aaa123 ist unser Beispielwert für die Referenz-ID und sollte durch den Wert ersetzt werden, den Sie dem Kontakt in Schritt 1 zugeordnet haben.
8. Fügen Sie das JavaScript-Snippet unten ein, um die JavaScript-Variable externalReference als JavaScript-Ausdruck einzurichten.
   

   if(typeof QSI === "undefined") {
        QSI = {};
        QSI.config = {
            externalReference: UserID
        };
    }

9. Drücken Sie die Eingabetaste.
10. Klicken Sie auf das Bookmarklet. Sie sehen, dass das Segment-Targeting entsprechend berücksichtigt wird, um zu ermitteln, ob das Intercept angezeigt werden soll oder nicht.
    Tipp: Aus Sicherheitsgründen enthält die Ziellogiklinie, die das Segment enthält, nur die Segment-ID. Um eine Segment-ID mit einem Segmentnamen abzugleichen, navigieren Sie zu XM Directory, und bearbeiten Sie Ihr Segment. Die URL hat die Segment-ID, die in der folgenden Beispiel-URL fett angezeigt wird: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k

Um diese Schritte für weitere Tests zu wiederholen, gehen Sie zwischen den Tests wie folgt vor:

1. Aktualisieren Sie jedes Mal Ihren Browser.
2. Richten Sie den JavaScript-Ausdruck in Ihrer Konsole ein.
3. Führen Sie Ihr Bookmarklet erneut aus.
4. Navigieren Sie zu XM Directory, und prüfen Sie, ob der Kontakt mit den Eingabewerten angelegt wurde.

ERSTELLUNG VON KONTAKTEN

1. Öffnen Sie ein vorhandenes Website-/App-Feedback-Projekt.
2. Navigieren Sie zu den Einstellungen.
   
3. Aktivieren Sie Link with XM Directory.
4. Wählen Sie ein Verzeichnis aus der Dropdown-Liste aus.
5. Aktivieren Sie das Kontrollkästchen neben Wenn der Kontakt nicht in Ihrem Verzeichnis vorhanden ist, fügen Sie ihn automatisch hinzu.
6. Klicken Sie auf Änderungen übernehmen.
7. Folgen Sie den Anweisungen auf der Registerkarte Bereitstellung, um den Implementierungscode-Snippet zu kopieren.
8. Wechseln Sie zu einer Webseite, die Sie zum Testen verwenden möchten.
9. Rufen Sie die Entwicklerkonsole auf. Abhängig von Ihrem Webbrowser gelangen Sie unterschiedlich dorthin:
   • Google Chrome: Wählen Sie in der Menüleiste von Chrome View → Developer → Developer Tools. Navigieren Sie im daraufhin angezeigten Fenster zur MDM Console.
   • Apple Safari: Stellen Sie sicher, dass das Menü „Entwickeln“ für Safari aktiviert ist. Wählen Sie dazu in der Menüleiste Einstellungen → Erweitert → Entwicklermenü anzeigen. Klicken Sie im Safari-Menü auf Entwickeln, und wählen Sie Webinspektor anzeigen. Navigieren Sie im daraufhin angezeigten Fenster zur MDM Console.
   • Mozilla Firefox: Klicken Sie auf das Menüsymbol und wählen Sie dann Web Developer. Wählen Sie im Menü Web Developer die Konsole
   • Microsoft Edge: Wählen Sie in der Menüleiste Tools → Developer → Developer Tools. Navigieren Sie in dem sich öffnenden Fenster zur Konsole.
   • Internet Explorer: Klicken Sie auf das Zahnradsymbol, und wählen Sie Entwicklertools. Navigieren Sie in dem sich öffnenden Fenster zur Konsole.
10. Geben Sie im Menü Console diesen Ausdruck mit Beispiel-XM-Directory-Kontaktwerten ein, und drücken Sie die Eingabetaste.

    QSI = {config: {externalReference:"test123", contactEmbeddedData: {"Location":"Seattle"}, Sprache:"English", firstName:"Jane", lastName:"Smith"}}

    

    Tipp: Die Werte in diesem Ausdruck sind Beispiele für Kontaktwerte, die dem XM-Directory-Profil des Testkontakts hinzugefügt werden. Sie können diese Werte beliebig ändern.
    Achtung: Wir unterstützen keine E-Mail-Adressen als Profilattribute, um hochsichere Web-Intercepts zu erhalten. Sie können E-Mail-Adressen manuell über das Verzeichnis oder über Datei-Uploads und SFTP-Automatisierungen hinzufügen.
11. Klicken Sie auf das Lesezeichen, und Sie sehen, dass das Intercept angezeigt wird.
    Tipp: Das Intercept muss NICHT angezeigt werden, damit die Kontakterstellung funktioniert. Sie muss lediglich auf der Seite ausgewertet werden.
    Tipp: Andere XM-Directory-Funktionen wie Segment-Targeting oder Kontakthäufigkeitsregeln funktionieren nicht im Rahmen derselben Seitenlast wie die, in der das Kontaktprofil angelegt wurde. Sobald der Kontakt jedoch angelegt wurde, werten alle nachfolgenden Intercepts die Kontakthäufigkeit und Segmentzielregeln aus.
12. Fügen Sie den Deployment-Code-Snippet in die Console ein, und drücken Sie die Eingabetaste.
13. Navigieren Sie zu dem XM Directory, das in der Dropdown-Liste von Schritt 3 angegeben ist, und stellen Sie sicher, dass der Kontakt mit den in Schritt 9 eingegebenen Werten angelegt wurde.

Tipps zur Fehlerbehebung

Ein neuer Benutzer wurde zu Segmenten hinzugefügt, sieht jedoch kein Intercept, das auf sein Segment ausgerichtet war.

Segmente werden täglich im XM Directory neu aufgebaut. Daher besteht die Möglichkeit, dass der neue Benutzer noch nicht als Mitglied des Segments berücksichtigt wurde.

Das Intercept-Debugger-Fenster zeigt keine Segmentnamen an.

Aus Sicherheitsgründen wird der Segmentname im Debugger-Fenster für keine Ziellogik mit Segmenten angezeigt. Die Segment-ID wird angezeigt. Um dem Segmentnamen eine Segment-ID zuzuordnen, bearbeiten Sie Ihr Segment in XM Directory, und sehen Sie sich die URL an. Die URL enthält die Segment-ID, die in der folgenden Beispiel-URL hervorgehoben ist: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34kAlternately

. Sie können direkt ein Intercept öffnen und die Targeting-Logik untersuchen, um zu sehen, welche Segmente angestrebt werden.

Das Intercept wird für erstmalige Benutzer langsam angezeigt.

Aus Performancegründen wird die Segmentmitgliedschaft vorübergehend im Speicher gespeichert und nur nach Bedarf aktualisiert. Wenn sich ein Benutzer noch nicht in unserem temporären Speicher befindet, kann die anfängliche Anzeige des Intercepts dieses Benutzers etwas länger dauern.