-
Customer Experience -
Employee Experience -
Brand Experience -
Product Experience -
Core XM -
Design XM
Integration mit Qualtrics Social Connect
Was finden Sie hier?
Informationen zur Integration mit Qualtrics Social Connect
Durch die Integration mit Qualtrics Social Connect können Sie Ihr gesamtes digitales Kundenfeedback an einem Ort konsolidieren und analysieren. Anschließend können Sie Ihre Daten mit einer beliebigen Qualtrics-Analysemethode analysieren, einschließlich Text iQ in einem CX-Dashboard.
Schritt 1: Berechtigungsheader anlegen
In diesem Abschnitt wird erläutert, wie Sie den Berechtigungskopf für die Integration anlegen. Diese benötigen Sie, um die Integration mit Qualtrics Social Connect einzurichten.
- Navigieren Sie zu Kontoeinstellungen.
- Navigieren Sie zum Abschnitt Qualtrics-IDs Ihres Kontos, und kopieren Sie Ihr API-Token. Wenn Sie bereits über ein API-Token verfügen, generieren Sie kein neues.
- Notieren Sie sich Ihren Qualtrics-Benutzernamen. In der Regel ist dies die E-Mail-Adresse, die Sie für die Anmeldung bei Qualtrics verwenden. Wenn Sie Ihren Qualtrics-Benutzernamen nicht kennen, wenden Sie sich an Ihren Administrator.
- Erstellen Sie unter Verwendung Ihres Qualtrics-Benutzernamens eine Anmeldezeichenfolge im folgenden Format:
<Ihr Qualtrics-Benutzername>:<Ihr Qualtrics-API-Token>.Tipp: Wenn Sie SSO verwenden, um sich bei Qualtrics anzumelden, stellen Sie sicher, dass Sie die Komponente # Ihres Benutzernamens einschließen.Beispiel: Eine Beispiel-Credential-Zeichenfolge ist:
barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki - Kodieren Sie die Credential-Zeichenfolge mit base64-Kodierung. Sie können dazu jeden Base64-Encoder online verwenden.
Beispiel: Meine base64-kodierte Credential-Zeichenfolge lautet:
YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k= - Bauen Sie den Berechtigungskopf im folgenden Format auf: Basic <base64-kodierte Credentials>. Notieren Sie sich den Bereich zwischen „Basic“ und den Anmeldeinformationen.
Beispiel: Mein letzter Autorisierungskopf ist:
Basis YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=
Sie benötigen diese Berechtigungsanmeldedaten im nächsten Abschnitt. Kopieren Sie es an einer leicht zugänglichen Stelle nach unten.
Schritt 2: Erstellen einer Automatisierung in Qualtrics Social Connect
Dieser Abschnitt beschreibt die Erstkonfiguration, die Sie in Qualtrics Social Connect abschließen müssen, um die Integration einzurichten. Um mit der Einrichtung zu beginnen, müssen Sie zunächst einen Workflow in Qualtrics erstellen.
- Navigieren Sie in Qualtrics zu Workflows.
- Klicken Sie auf Workflow erstellen und dann auf Gestartet durch ein Ereignis.
- Wählen Sie das JSON-Ereignis aus.
- Klicken Sie auf URL kopieren, um den Ereignisendpunkt zu kopieren. Sie benötigen diesen Ereignisendpunkt, um die Einrichtung in Qualtrics Social Connect abzuschließen. Sichern Sie es an einer Stelle, an der Sie später darauf zugreifen können.
- Melden Sie sich in einer neuen Browserregisterkarte bei Qualtrics Social Connect an.
Tipp: Qualtrics Social Connect verwendet separate Anmeldeinformationen aus Ihrem Qualtrics-Konto. Wenden Sie sich an den Support unter support@engagor.com, wenn Sie Fragen zum Zugriff auf Qualtrics Social Connect haben.
- Navigieren Sie zu Kontoeinstellungen.
- Wählen Sie auf der Registerkarte Übersicht die Option Automatisierungsrezepte.
- Klicken Sie im Abschnitt Bei neuer Erwähnung/Fall auf Automatisierungsrezept hinzufügen.
- Geben Sie Ihrem Automatisierungsrezept einen Namen.
- Wählen Sie ein oder mehrere zu überwachende Themen aus.
- Konfigurieren Sie die Filterregeln für die Erwähnungen, die Sie überwachen möchten.
- Wählen Sie für die Automatisierungsaktion Webhook auslösen.
- Geben Sie Ihrem Webhook einen Namen und eine Beschreibung. Dies sind nur interne Bezeichner für Ihre eigene Organisation.
- Stellen Sie sicher, dass das HTTP-Verb auf POST gesetzt ist.
- Fügen Sie im Feld URL den Ereignisendpunkt ein, den Sie in Schritt 4 kopiert haben.
- Wählen Sie im Abschnitt Anforderungstext aus, welche Variablen aus Ihren Erwähnungen Sie in Qualtrics importieren möchten. Details zu den einzelnen Variablen finden Sie auf dieser Qualtrics Connect-Support-Seite.
- Stellen Sie sicher, dass der Content-Type-Header application/json ist.
- Fügen Sie im Feld Authorization Header den Berechtigungsheader ein, den Sie zuvor angelegt haben.
- Klicken Sie auf Hinzufügen, um die Einrichtung abzuschließen.
Um die Verbindung zu testen, generieren Sie eine neue Erwähnung (die Art und Weise, wie die Erwähnung generiert wird, hängt von Ihrer Quelle ab, z.B. Anlegen eines neuen Tweets oder Hinterlassen eines Kommentars). Alternativ können Sie auf den nächsten Beitrag warten, wenn er natürlich geschieht. Nachdem die neue Erwähnung generiert wurde, öffnen Sie das JSON-Ereignis in Ihrem Qualtrics-Workflow, und sehen Sie sich die JSON-Eigenschaften an, die vom Ereignis erfasst wurden:
Schritt 3: Qualtrics-Datenset erstellen
Um die Daten in Qualtrics zu speichern, müssen Sie ein Qualtrics-Datenset erstellen. Sie können ein Qualtrics-Datenset erstellen, indem Sie die Datenset-API direkt über die Befehlszeile aufrufen.
- Öffnen Sie einen Texteditor, und erstellen Sie den API-Befehl. Das allgemeine Format ist wie folgt:
curl -X POST https://brandID.qualtrics.com/API/v3/datasets -H "Content-Type: application/json" -H "X-API-TOKEN: Your Qualtrics API Token" -d '{ "name": "Choose a name for your dataset", "primaryKey": "Choose ID column name", "createProject": true, "fields": [ { "name": "Same ID column name as upper", "type": "string' ]" ] - Im oben genannten API-Befehl müssen Sie die folgenden Werte ersetzen:
- brandID: Ihre Qualtrics-Organisations-ID.
- Ihr Qualtrics-API-Token: Ihr API-Token.
- Wählen Sie einen Namen für Ihr Datenset: Geben Sie einen Namen für das Datenset ein.
- Wählen Sie ID Spaltenname: Geben Sie den Feldnamen an, der den Identifikationsschlüssel Ihres Projekts enthalten soll. Wir empfehlen die Verwendung von „id“.
- Öffnen Sie Terminal auf Ihrem Computer, und fügen Sie den Befehl ein. Drücken Sie die Eingabetaste, um den Befehl auszuführen.
- Kopieren Sie die Datenset-ID aus dem Ergebnis. Diese werden Sie später benötigen. Das Ergebnis des API-Aufrufs hat das folgende Format:
{"result":{"name":"","primaryKey":" ","datasetId":"datasestId":"ID des Datensets, das Sie kopieren müssen","fields":[ ]},"meta":{"requestId":" ","httpStatus" 200}:"httpStatus"} - Sobald Sie Ihr Datenset erstellt haben, ist es auf der Seite Qualtrics-Projekte als importiertes Datenprojekt verfügbar. Klicken Sie auf Ihr Projekt, um es zu öffnen.
- Nachdem Sie Ihr importiertes Datenprojekt geöffnet haben, können Sie den Feldeditor auf der Registerkarte Daten und Analyse verwenden, um die Felder hinzuzufügen, die Sie aus Social Connect importieren möchten. Weitere Informationen zu den verfügbaren Feldern finden Sie unter Gemeinsame Social-Connect-Felder. Wenn Sie Ihre Felder hinzufügen, empfehlen wir, sie als offene Textart in Ihrem Datenset zu sichern.
Schritt 4: Workflow abschließen
Nachdem Sie nun eine Verbindung mit Qualtrics Social Connect hergestellt und Ihr Datenset erstellt haben, ist es an der Zeit, Daten aus Qualtrics Social Connect Ihrem Datenset zuzuordnen.
- Öffnen Sie den zuvor angelegten Workflow.
- Click the plus sign (+) and select Task.
- Wählen Sie die Aufgabe WebService.
- Wählen Sie Nicht authentifizierter Webdienst.
- Click Next.
- Wählen Sie POST als Anfragetyp.
- Geben Sie die URL im folgenden Format ein:
https://brandID.qualtrics.com/API/v3/datasets/DatasetID/dataWobei brandID Ihre Qualtrics-Marken-ID und DatasetID die zuvor kopierte Datensatz-ID ist.
- Fügen Sie im Abschnitt Header X-API-TOKEN als Schlüssel hinzu, und geben Sie Ihr API-Token als Wert ein.
- Wählen Sie im Abschnitt Körper die Option JSON-Schlüssel-Wert-Paare, und beginnen Sie mit der Zuordnung Ihrer Felder. Geben Sie für den Schlüssel den Feldnamen ein. Verwenden Sie für den Wert dynamischen Text, um das Feld auszuwählen, das direkt aus dem JSON-Ereignis stammt. Der Abschnitt Gemeinsame Social-Connect-Felder enthält den dynamischen Textcode für nicht transformierte Daten aus Social Connect.
Achtung: Wenn Sie eine Code-Aufgabe zum Bereinigen Ihrer Daten hinzugefügt haben, müssen Sie stattdessen das Piped-Text-Menü {a} verwenden, um die Ausgabe aus der Code-Aufgabe auszuwählen. - Wenn Sie fertig sind, klicken Sie auf Speichern.
Schritt 5: Qualtrics Social Connect-Daten analysieren
In diesem Abschnitt wird erläutert, wie Sie Ihre Qualtrics-Social-Connect-Daten in CX-Dashboards und Text iQ analysieren.
Anzeigen von Social-Connect-Daten in CX-Dashboards
- Legen Sie ein neues Dashboard in einem CX-Dashboard-Projekt an.
- Klicken Sie auf Quelle hinzufügen, bewegen Sie den Mauszeiger über Externe Datenquellen, und wählen Sie dann das Projekt aus, das Ihre Social-Connect-Daten enthält.
- Passen Sie die Feldtypen für Ihre importierten Felder an. Weitere Informationen zum vorgeschlagenen Feldtyp für jedes Datensetfeld finden Sie unter Gemeinsame Social-Connect-Felder.
- Sichern Sie anschließend Ihre Änderungen.
Das Bearbeiten Ihres Dashboards entspricht dem Bearbeiten eines beliebigen CX-Dashboards. Weitere Informationen finden Sie auf den folgenden Supportseiten:
- Erste Schritte mit CX-Dashboards
- Schritt 1: Projekt anlegen und Dashboard hinzufügen
- Schritt 2: Dashboard-Datenquelle zuordnen
- Schritt 3: Dashboard Design planen
- Schritt 4: Dashboard erstellen
- Schritt 5: Zusätzliche Dashboard-Anpassung
- Schritt 6: Benutzer teilen und verwalten
Text iQ verwenden
Wir empfehlen, den Text iQ in Ihrem CX-Dashboard zu verwenden. Dadurch wird sichergestellt, dass sich alle Ihre Daten an einem Ort befinden und Ihre Text-iQ-Felder automatisch Ihrem Dashboard zugeordnet werden, wenn Sie sie über das Dashboard analysieren. Wenn Sie bereit sind, zu beginnen, klicken Sie auf die Schaltfläche In Text iQ analysieren auf Ihrem Dashboard.
Die meisten Erwähnungsfelder sind für die Textanalyse nicht nützlich (z. B. Autor, Quelle, ID usw.). Wenn Sie die Daten auswählen, die in Text iQ importiert werden sollen, stellen Sie sicher, dass Sie das Feld für den Nachrichteninhalt auswählen.
Die Verwendung von Text iQ für Social-Connect-Daten funktioniert genauso wie das Analysieren von Umfrageantworttexten in Qualtrics. Weitere Informationen finden Sie auf den folgenden Supportseiten:
XM Discover Enrichments importieren
In diesem Abschnitt wird erläutert, wie Sie XM-Discover-Anreicherungen in Ihr Datenset importieren. Die Integration mit Qualtrics Social Connect ist zwar nicht zwingend erforderlich, doch XM Discover Enrichments hilft Ihnen dabei, Ihre Erwähnungen in Echtzeit zu analysieren, indem Sie sie basierend auf den Inhalten der Erwähnung mit Tags versehen.
- Navigieren Sie in Social Connect zu Tags.
- Klicken Sie auf Add XM Discover Enrichment.
- Wählen Sie die Themen aus, für die Sie Anreicherungen hinzufügen möchten.
- Click Next.
- Wählen Sie die Kategoriemodelle aus, die Sie verwenden möchten.
Tipp: Es gibt ein Limit von 2 Kategorien pro Thema. Wenn Sie mehr benötigen, wenden Sie sich an das Social-Connect-Team unter support@engagor.com. - Wählen Sie für Echtzeitanreicherung die Option Ja.
Achtung: Wenn Sie die Echtzeitanreicherung nicht aktivieren, werden die XM-Discover-Anreicherungen mit einer Verzögerung von 7 oder mehr Minuten verarbeitet, nachdem die Erwähnung in Social Connect angelegt wurde. Daher sind die entsprechenden Tags nicht in Ihrem Qualtrics-Workflow verfügbar.
- Klicken Sie auf Speichern.
Kehren Sie zu Ihrem Workflow in Qualtrics zurück. Sie müssen Ihrem Workflow eine Code-Aufgabe hinzufügen, um Ihre Tag-Felder zu bereinigen. Diese Felder werden beim Export aus Social Connect in Klammern eingeschlossen, sodass Sie das erste und letzte Zeichen aus der exportierten Zeichenfolge entfernen müssen. Ein Beispiel dafür finden Sie auf dieser externen Seite.
Stellen Sie sicher, dass Sie Ihre Felder in Ihrem Qualtrics-Workflow zuordnen, um die XM-Discover-Anreicherungen in Ihrem Qualtrics-Datenset zu speichern. Diese werden als Tag-Feld gespeichert.
Da XM Discover Enrichments als kommagetrennte Liste exportiert wird, müssen Sie das Feldtrennzeichen in Ihrem Dashboard mithilfe des Umkodierungseditors angeben. Stellen Sie sicher, dass Sie Komma als Trennzeichen auswählen. Sie können Ihre Felder auch mit dem Umkodierungseditor umbenennen, um sie für die Anzeige im Dashboard benutzerfreundlicher zu gestalten.
Gemeinsame Social-Connect-Felder
Dieser Abschnitt enthält eine Tabelle der häufig verwendeten Felder aus Social Connect, ihren Piped-Text-Code zum Erstellen Ihrer Zuordnung, den Feldtyp, den Sie als in Qualtrics speichern sollten, und alle speziellen Hinweise zum Feld.
| Dataset-Feldname | Dynamischer Textpfad (für Workflow-Zuordnung) | Dashboard-Feldtyp | Beschreibung & Besondere Hinweise |
| id | ~{aed://id} | Textwert | Qualtrics Social Connect-spezifischer Identifikator für diese Erwähnung (eindeutig pro Thema). |
| Eindeutige ID | ~{aed://unique_id} | Textwert | Qualtrics Social Connect-spezifischer Identifikator für diese Erwähnung. |
| authorName | ~{aed://author.name} | Textwert | Benutzername oder Handle des Urhebers der Erwähnung. |
| authorFullname | ~{aed://author.fullname} | Textwert | Vollständiger Name des Verfassers der Erwähnung. |
| authorId | ~{aed://author.id} | Textwert | Servicespezifische ID des Autors (z.B. Twitter-UID) |
| originalAuthorName | ~{aed://original_author.name} | Textwert | Benutzername oder Handle des ursprünglichen Urhebers der Erwähnung. (Falls es sich um einen Retweet, Repin, … handelt) |
| originalAuthorFullname | ~{aed://original_author.fullname} | Textwert | Vollständiger Name des ursprünglichen Urhebers der Erwähnung. |
| originalAuthorId | ~{aed://original_author.id} | Textwert | Servicespezifische ID des ursprünglichen Autors (z.B. Twitter-UID). |
| messageTitle | ~{aed://message.title} | Freier Text | |
| messageContent | ~{aed://message.content} | Freier Text | Der Inhalt liegt im HTML-Format vor. Sie können eine Code-Aufgabe verwenden, um HTML oder Emojis zu entfernen. |
| messageLanguage | ~{aed://message.language} | Textfeld | Sprachcode nach ISO 639-1 der Sprache, in der diese Meldung vorliegt. |
| messageSentiment | ~{aed://message.sentiment} | Textfeld | Beliebige von positiv, negativ, neutral oder nicht gesetzt. |
| Meldungsart | ~{aed://message.type} | Textfeld | Art der Meldung.
Mögliche Werte: “Beitrag”, “Privatemessage”, “Video”, “Einchecken”, “Foto”, “Text”, “Zitat”, “Link”, “Chat”, “Audio”, “E-Mail”, “Überprüfung”, “Applaus”, “Gefällt mir”, “Retweet”, “Geteilt”, “Repin”, “Audio”, “Relife”-Fall, “Anstellungskommentar”, “Anstellungskommentar”, “Antwort”. |
| sourceCategory | ~{aed://source.category} | Textfeld | Kategorie, unter der diese Erwähnung klassifiziert werden kann.
Mögliche Werte: “Sozial”, “Soziale Videos”, “Soziale Fotos”, “Mikroblogs”, “Foren”, “Blogs”, “Podcasts”, “Kommentare”, “Neuigkeiten”, “neue_akademische”, “neue_Konsumenten”, “news_corporate”, “news_Government”, “news_local”, “news_national”, “news_trade”, “newspress_apps”, “newspress_apps”, “newspreses” |
| sourceService | ~{aed://source.service} | Textfeld | Aus welcher Quelle „Connected Service“ stammt die Erwähnung?
Mögliche Werte: “twitter”, “facebook”, “facebook_ads”, “foursquare_venue”, “googleplus”, “instagram”, “instagram_hashtag”, “instagram_sociomads”, “instagram_ads”, “linkedin_group”, “pinterest”, “rss”, “youtsoube”, “mixsociamo”, “businesssociampleo” |
| Quelltyp | ~{aed://source.type} | Textfeld | Aus welcher Quelle stammt die Erwähnung? (Interner Name für die Filterung.)
Mögliche Werte: “SearchProviderFacebook”, “SearchProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderTwitter”, “SearchProviderGoogle”, “SearchProviderSearchaGooglePlus”, “SearchProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProvider”, SearchProviderSearchaSearchaSucharamAds, SearchProviderFourSquare, “SearchProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderProviderSearchProviderProviderProviderSearchaSearchaSearchaSearchaApp”, “SearchProviderInstedAptags”, “SearchProviderLinkedViss”, “SearchProviderProviderProviderProviderProviderProviderProviderProviderProvider”, “SearchProviderInstardInligenOn” |
| sourceId | ~{aed://source.id} | Textwert | Identifikation dieser Nachricht zu dem Service, aus dem sie stammt. (Beispiel: die Tweet-ID für eine Twitter-Nachricht.) |
| sourceUrl | ~{aed://source.url} | Textwert | Die URL der Nachricht auf dem Service, aus dem sie stammt. (Z.B. der Link zum Kommentar auf Facebook selbst.) |
| locationContinent | ~{aed://location.kontinent} | Textfeld | Kontinentcode. |
| locationCountry | ~{aed://location.country} | Textfeld | ISO-3166-1-Ländercode. |
| locationCity | ~{aed://location.city} | Textwert | Vollständiger Name der Stadt. |
| locationRegion | ~{aed://location.region} | Textwert | |
| Label | ~{aed://tags} | Mehrfachantwort-Textfeld | Array aus Zeichenfolgen; (Smart-)Tags wurden dieser Erwähnung hinzugefügt. |
| topicId | ~{aed://topic.id} | Textwert | |
| TopicName | ~{aed://topic.name} | Textwert | |
| Status | ~{aed://status} | Textfeld | Der Status entspricht der Stufe im Workflow, in der sich eine Erwähnung/ein Fall gerade befindet.
Mögliche Werte: “done”, “pending”, “new”. |
| Permalink | ~{aed://permalink} | Textwert | Qualtrics Social Connect-spezifische URL für diese Erwähnung. |
| dateAdded | ~{aed://date.added} | Textwert | UNIX-Zeitstempel (in UTC) des Zeitpunkts, an dem der Beitrag von Qualtrics Social Connect indiziert wurde.
Wenn Sie dieses Feld verwenden, möchten Sie eine Code-Aufgabe verwenden, um das Datum in ein benutzerfreundlicheres Format umzuwandeln. Alternativ können Sie das Standardaufzeichnungsdatum verwenden, das erstellt wird, wenn der Beitrag in Qualtrics importiert wird, da Datum und Uhrzeit ungefähr gleich sein werden. |
| datePublished | ~{aed://date.publish} | Textwert | UNIX-Zeitstempel (in UTC) des Zeitpunkts, an dem der Beitrag veröffentlicht wurde.
Vermutlich möchten Sie stattdessen dynamischen Text für Code-Aufgaben mit formatiertem Datum verwenden. |
| Priorität | ~{aed://Priority} | Textfeld |