Konfigurieren eines XM-Discover-Link-Jobs

Informationen zum XM Discover Link Connector

Sie können den XM Discover Link Connector verwenden, um XM-Daten über einen REST-API-Endpunkt in XM Discover zu übertragen, während Sie alle Funktionen des Connectors-Frameworks nutzen, z.B. Feldzuordnung, Transformationen, Filter, Jobüberwachung usw.

Mit dem XM Discover Link Connector können Sie Daten in Ihrem gewünschten Tempo aufnehmen, während andere Konnektoren die Daten gemäß einem Zeitplan abrufen.

Unterstützte Datenformate

Der XM Discover Link Connector unterstützt das Laden der folgenden Datentypen:

• Individuelles Feedback
• Digitale Interaktionen
• Abrufprotokolle

Alle Dokumente werden im JSON-Format bereitgestellt, das vom Datentyp abhängt.

Weitere Informationen zu Datenformaten, die von XM Discover unterstützt werden, finden Sie unter. Übersicht über XM-Discover-Datenformate.

So funktioniert der XM Discover Link Connector:

1. Der erste Schritt bei der Verwendung des XM-Discover-Link-Konnektors besteht darin, einen Verarbeitungsjob zu konfigurieren und Parameter und Zuordnungen für zukünftige API-Aufrufe einzurichten. Weitere Informationen finden Sie unter. Erstellen eines XM-Discover-Link-Jobs.
2. Sobald ein Verarbeitungsjob konfiguriert wurde, können Sie API-Aufrufe über den richtigen Verarbeitungsjob ausführen, indem Sie seine ID referenzieren. Alle erforderlichen API-Endpunktinformationen werden in der Zusammenfassung des Verarbeitungsauftrags bereitgestellt. Weitere Informationen finden Sie unter. API-Endpunktinformationen.

Verbindung einrichten

Bevor Sie anfangen

Bevor Sie einen XM Discover Link-Job konfigurieren, empfehlen wir, eine Beispieldatei mit Kundendaten im JSON-Format mit einem der folgenden Datentypen vorzubereiten:

1. Individuelles Feedback: Details siehe Individuelles Feedback im JSON-Format.
2. Digitale Interaktionen: Weitere Informationen finden Sie unter Digitale Interaktionen im JSON-Format.
3. Anrufprotokolle: Details siehe Transkripte im JSON-Format aufrufen.

So richten Sie die Verbindung ein:

1. Melden Sie sich bei Connectors an.
2. Klicken Sie oben rechts auf der Seite Jobs auf die Schaltfläche Neuer Job.
3. Wechseln Sie auf der Seite Connectors zum Abschnitt SELECT A SOURCE.
4. Klicken Sie auf die Schaltfläche XM Discover Link.

Anlegen eines eingehenden XM-Discover-Link-Connector-Jobs

Nachdem Sie die Verbindung eingerichtet haben, führen Sie die folgenden Schritte aus, um einen eingehenden XM-Discover-Link-Connector-Job anzulegen und die Daten zu konfigurieren, die an XM Discover gesendet werden sollen.

• Schritt 1: Jobnamen angeben
• Schritt 2: Projekt und Beschreibung angeben
• Schritt 3: Berechtigungsmodus
• Schritt 4: Beispieldatei auswählen
• Schritt 5: Gewünschte Felder XM Discover zuordnen
• Schritt 6: Datensubstitution und Redaktion (optional)
• Schritt 7: Filter angeben (optional)
• Schritt 8: Zusätzliche Optionen für Job einrichten
• Schritt 9: Alle Jobeinstellungen bestätigen

Schritt 1: Jobnamen angeben

Geben Sie oben auf der Seite im Feld Jobname einen erkennbaren Jobnamen ein.

Schritt 2: Projekt und Beschreibung angeben

1. Wählen Sie auf der Seite Projekt und Beschreibung angeben aus dem Dropdown-Menü Projekte das Projekt aus, in das Daten geladen werden sollen.
   Tipp: Sie haben die Möglichkeit, im Feld Stellenbeschreibung eine Notiz zum Job einzugeben. Die Stellenbeschreibung, die Sie im Feld „Stellenbeschreibung“ eingeben, ist nur in der Liste Konnektoren verfügbar und wird nicht als Teil der Daten für eine Stelle hochgeladen.
2. Klicken Sie auf Weiter.

Schritt 3: Berechtigungsmodus

Wählen Sie auf der Seite Berechtigungsmodus den Berechtigungsmodus aus, den Sie für die API-Aufrufe verwenden möchten:

• API-Schlüssel: Verwenden Sie API-Token, die von XM Discover generiert wurden. Weitere Informationen zu API-Token finden Sie unter. API-Token.
• OAUTH 2.0: Client-ID und geheimen Client-Schlüssel verwenden, die vom XM-Discover-Authentifizierungsdienst bereitgestellt werden. Wenden Sie sich an Ihren Qualtrics Customer Success Manager, um diese Methode anzufordern.

Schritt 4: Beispieldatei auswählen

1. Wählen Sie auf der Seite Beispieldatei auswählen unter Datenformat auswählen den Typ der Daten aus, die von diesem Job verarbeitet werden sollen:
   • Chat: Verarbeiten Sie digitale Interaktionen mit mehreren Linien des Dialogs zwischen zwei oder mehr Teilnehmern. Digitale Interaktionen müssen einem vordefinierten Format folgen. Sie können eine Vorlage herunterladen, nachdem Sie das Datenformat ausgewählt haben.
   • Call: Laden Sie Anrufprotokolle mit mehreren Zeilen des Dialogs zwischen zwei oder mehr Teilnehmern hoch. Anrufprotokolle müssen einem vordefinierten Format folgen. Sie können eine Vorlage herunterladen, nachdem Sie das Datenformat ausgewählt haben.
   • Feedback: Prozessdokumente, die als einzeilige oder “flache” Objekte dargestellt werden.
2. Wählen Sie aus der Dropdown-Liste Vorlage eine Vorlage aus, die Sie verwenden möchten.
   Tipp: Die verfügbaren Vorlagenoptionen unterscheiden sich je nach ausgewähltem Datenformat.

   Datenformat	Vorlagenoptionen
   Chat	Chat (Standard): Wird für Daten zu digitalen Standardinteraktionen verwendet. Amazon Connect: Verwendung für digitale Interaktionen speziell für Amazon Connect Chat.
   Anruf	Anruf (Standard): Für Standarddaten von Anrufprotokollen verwenden. Verint: Verwendung für Verint-spezifische Anrufprotokolle Tipp: Weitere Informationen zum Exportdateiformat von Verint Interaction Analytics finden Sie in der Verint-Dokumentation.
   Feedback	Keine (Standard): Wenden Sie keine Vorlagen an. Dynamics 365: Verwendung für Microsoft Dynamics-Daten.

3. Geben Sie im Feld JSON-Pfad den JSON-Pfad zu einer Teilmenge von JSON an, die Dokumentknoten enthält.
   Tipp: Lassen Sie das Feld leer, wenn sich die Dokumente auf Stammknotenebene befinden.
4. Klicken Sie auf die Schaltfläche Klicken Sie, um eine Datei für den Upload auszuwählen, und zeigen Sie auf die Beispieldatei, oder legen Sie Ihre Datei auf dem grauen Grafikbereich ab.
5. Warten Sie, bis XM Discover die Beispieldatei hochlädt und zeigt die Vorschau unten an.
   Tipp: Wenn anstelle der Vorschau eine Fehlermeldung und der Inhalt der Rohdatei angezeigt werden, kann ein Problem mit den ausgewählten Datenformatoptionen auftreten. Informationen zu Fehlermeldungen bei fehlgeschlagener Validierung von Beispieldateien finden Sie unter. Beispieldateifehler.
6. Stellen Sie sicher, dass die Daten korrekt sind.
7. Klicken Sie auf Weiter.

Schritt 5: Gewünschte Felder XM Discover zuordnen

1. Wählen Sie auf der Seite Gewünschte Felder XM Discover zuordnen die Registerkarte QUELLZUORDNUNG aus, um Quelldatenfelder mit Datenfeldern in Ihrem XM Discover-Projekt zu verbinden.
2. Konfigurieren Sie im Abschnitt Standardquellzuordnung die Standarddatenfelder, die alle Dokumente in XM Discover gemeinsam nutzen. Die folgende Tabelle bietet einen Überblick über die Standarddatenfeldoptionen für den XM-Discover-Link-Eingangskonnektor.
   

   Feldname	Editierbar?	Beschreibung
   Feedback_Typ	Ja	Mit der Feedbackart können Sie Daten basierend auf ihrem Typ identifizieren. Dies ist hilfreich für das Reporting, wenn Ihr Projekt verschiedene Arten von Daten enthält (z.B. Umfragen und Social-Media-Feedback). Standardmäßig ist der Wert dieses Attributs auf Folgendes gesetzt: „Call“ für Anrufprotokolle „Chat“ für digitale Interaktionen „Feedback“ für individuelles Feedback Verwenden Sie eine benutzerdefinierte Transformation, um einen benutzerdefinierten Wert festzulegen, einen Ausdruck zu definieren oder ihn einem bestimmten Feld zuzuordnen.
   Quelle	Ja	Mithilfe der Quelle können Sie Daten identifizieren, die aus einer bestimmten Quelle abgerufen wurden. Dies kann alles sein, das die Herkunft der Daten beschreibt, z.B. der Name einer Umfrage oder einer mobilen Marketingkampagne. Standardmäßig ist der Wert dieses Attributs auf „XM Discover Link“ gesetzt. Verwenden Sie eine benutzerdefinierte Transformation, um einen benutzerdefinierten Wert festzulegen, einen Ausdruck zu definieren oder ihn einem bestimmten Feld zuzuordnen.
   richVerbatim (für dialogorientierte Daten)	Nein	Für Gesprächsdaten (wie Anruf- und Chat-Interaktionen) verwendet XM Discover ein sprechendes ausführliches Format für das Feld richVerbatim. Dieses Format unterstützt die Aufnahme dialogspezifischer Metadaten, die zum Entsperren der dialogorientierten Visualisierung (Sprecherwechsel, Stille, Gesprächsereignisse usw.) und Anreicherungen (Startzeit, Dauer usw.) erforderlich sind. Dieses wörtliche Feld enthält “Kind”-Felder, um die Seite des Kunden und des Vertreters der Konversation zu verfolgen: clientVerbatim verfolgt die Kundenseite des Gesprächs. agentVerbatim verfolgt die Seite des Vertreters (Agenten) des Gesprächs. unknown verfolgt die unbekannte Seite des Gesprächs. Hinweise zu Gesprächswörtern: Transformationen werden für sprachbasierte wörtliche Felder nicht unterstützt. Derselbe Wortlaut kann nicht für verschiedene Arten von Konversationsdaten verwendet werden. Wenn Sie möchten, dass Ihr Projekt mehrere Arten von Konversationen hostet, verwenden Sie separate Paare von Gesprächsverben pro Konversationstyp.
   clientVerbatim (für dialogorientierte Daten)	Ja	Verfolgt die Kundenseite der Konversation in Anruf- und Chat-Interaktionen. Dieses Feld ist standardmäßig zugeordnet zu: clientVerbatimChat für digitale Interaktionen clientVerbatimCall für Anrufinteraktionen Sie können sie bei Bedarf einem anderen ausführlichen Feld zuordnen.
   agentVerbatim (für dialogorientierte Daten)	Ja	Verfolgt die Seite des Vertreters des Gesprächs in Anruf- und Chat-Interaktionen. Dieses Feld ist standardmäßig zugeordnet zu: agentVerbatimChat für digitale Interaktionen agentVerbatimCall für Anrufinteraktionen Sie können sie bei Bedarf einem anderen ausführlichen Feld zuordnen.
   unknown (für dialogorientierte Daten)	Ja	Verfolgt die unbekannte Seite des Gesprächs in Anruf- und Chat-Interaktionen. Dieses Feld ist standardmäßig zugeordnet zu: unbekanntVerbatimChat für digitale Interaktionen unbekanntVerbatimCall für Anrufinteraktionen Sie können sie bei Bedarf einem anderen ausführlichen Feld zuordnen.
   Belegdatum	Ja	Das Dokumentdatum ist das primäre Datumsfeld, das mit einem Dokument verknüpft ist. Dieses Datum wird in XM-Discover-Berichten, Trends, Warnungen usw. verwendet. Wählen Sie für Belegdatum eine der folgenden Optionen: conversationTimestamp (für Conversational Data): Datum und Uhrzeit der gesamten Konversation. Wenn Quelldaten andere Datumsfelder enthalten, können Sie eines davon als Belegdatum festlegen, indem Sie es aus dem Dropdown-Menü in der Spalte Feldname auswählen. Sie können auch ein bestimmtes Datum festlegen, indem Sie ein benutzerdefiniertes Feld hinzufügen. Weitere Informationen finden Sie unter. Festlegen eines bestimmten Belegdatums.
   natural_id	Ja	Die natürliche ID dient als eindeutige ID eines Belegs und ermöglicht die korrekte Verarbeitung von Dubletten. Wählen Sie für Natürliche ID eine der folgenden Optionen: conversationId (für Conversational-Daten): Eine eindeutige ID für die gesamte Konversation. Wählen Sie in der Spalte Feldname ein beliebiges Text- oder numerisches Feld aus Ihren Daten aus. Generieren Sie automatisch IDs, indem Sie ein benutzerdefiniertes Feld hinzufügen. Weitere Informationen finden Sie unter. Natürliche IDs automatisch generieren.
   Feedback_Provider	Nein	Der Feedbackanbieter unterstützt Sie bei der Identifizierung von Daten, die Sie von einem bestimmten Anbieter erhalten haben. Für XM-Discover-Link-Uploads ist der Wert dieses Attributs auf „XM Discover Link“ gesetzt.
   Jobname	Ja	Mit Jobname können Sie Daten basierend auf dem Namen des Jobs identifizieren, der für den Upload verwendet wurde. Sie können den Wert dieses Attributs im Feld Jobname oben auf der Seite ändern.
   Ladedatum	Nein	Ladedatum gibt an, wann ein Dokument in XM Discover hochgeladen wurde. Dieses Feld wird automatisch gesetzt.

3. Konfigurieren Sie im Abschnitt Quellzuordnung die restlichen Datenfelder.
   Tipp: Dieser Abschnitt enthält Zuordnungen für Quellfelder, die Sie über die Beispieldatei angegeben haben. Wenn Sie keine Beispieldatei bereitgestellt haben, müssen Sie Zuordnungen manuell anlegen. Weitere Informationen zur Datenzuordnung finden Sie unter. Datenzuordnung konfigurieren.
4. Klicken Sie auf Weiter.

Schritt 6: Datensubstitution und Redaktion (optional)

1. Auf der Seite Datenersetzung und Redaktion können Sie Ersetzungs- und Redaktionsregeln angeben, um sensible Daten auszublenden oder bestimmte Wörter und Phrasen in Kundenfeedback und -interaktionen automatisch zu ersetzen.
   Tipp: Weitere Informationen zur Substitution und Unkenntlichmachung von Daten finden Sie unter. Datenersetzung und -redundanz.
2. Klicken Sie auf Weiter.

Schritt 7: Filter angeben (optional)

1. Auf der Seite Filter angeben können Sie eine Filterbedingung für den Job definieren, um nur die Daten zu laden, die dem Filter entsprechen.
   Tipp: Weitere Informationen zum Filtern eingehender Daten finden Sie unter. Konnektorfilter.
2. Klicken Sie auf Weiter.

Schritt 8: Zusätzliche Optionen für Job einrichten

1. Wählen Sie auf der Seite Zusätzliche Optionen für Job einrichten aus, wie XM Discover doppelte Dokumente verarbeiten soll, indem Sie im Abschnitt Behandlung neuer und vorhandener Dokumente einen der folgenden Dublettenerkennungsmodi auswählen:
   • Duplikate für vorhandene Belege ablehnen und neue Datensätze für neue Belege anlegen.
   • Strukturierte Attribute für vorhandene Belege aktualisieren und neue Datensätze für neue Belege anlegen.
   • Aktualisieren Sie strukturierte Attribute für vorhandene Belege, und legen Sie keine Datensätze für neue Belege an.
     Achtung: Jedes Dokument muss eine eindeutige natürliche ID haben, damit das System doppelte Dokumente mit identischen natürlichen IDs verarbeiten kann.
     Tipp: Weitere Informationen zu Dublettenerkennungsmodi finden Sie unter. Dublettenerkennung.
2. Klicken Sie auf Weiter.

Schritt 9: Alle Jobeinstellungen bestätigen

1. Auf der Seite Alle Jobeinstellungen bestätigen können Sie eine Zusammenfassung aller Einstellungen für einen Job anzeigen und die Einstellungen bei Bedarf bearbeiten.
2. Klicken Sie auf die Schaltfläche Fertig stellen, um den XM-Discover-Link-Job zu erstellen.
3. Sobald der XM-Discover-Link-Job erstellt wurde, können Sie ihn zum Ausführen von API-Aufrufen verwenden. Weitere Informationen finden Sie unter. API-Endpunktinformationen.

Informationen zum API-Endpunkt abrufen

Nachdem Sie einen XM-Discover-Link-Job konfiguriert haben, müssen Sie die API-Endpunktinformationen abrufen, die erforderlich sind, um mit dem Laden von Daten über diesen Job zu beginnen.

1. Melden Sie sich bei Connectors an.
2. Stellen Sie sicher, dass die Registerkarte JOBS geöffnet ist.
3. Suchen Sie mithilfe von Filtern oder Suchen nach dem entsprechenden XM-Discover-Link-Job.
4. Klappen Sie das Aktionsmenü neben dem Job auf, und wählen Sie Zusammenfassung aus.
5. Klicken Sie oben rechts im Fenster Jobdetails: Jobname auf den Link API-Dokumentation, um die Job-API-Dokumentation zu öffnen. Die folgende Tabelle enthält Details zu den API-Endpunktinformationen, die erforderlich sind, um mit dem Laden von Daten über einen XM-Discover-Link-Job zu beginnen: