-
Customer Experience -
Employee Experience -
Brand Experience -
Core XM -
Design XM
Integration mit Qualtrics Social Connect
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: Berechtigungskopf anlegen
In diesem Abschnitt wird beschrieben, 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 verwenden Sie diese E-Mail-Adresse, um sich bei Qualtrics anzumelden. Wenn Sie Ihren Qualtrics-Benutzernamen nicht kennen, wenden Sie sich an Ihren Administrator.
- Erstellen Sie mithilfe Ihres Qualtrics-Benutzernamens eine Zeichenfolge für Anmeldeinformationen 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 angeben.Beispiel: Eine Beispielzeichenfolge für Anmeldeinformationen ist:
barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki - Kodieren Sie die Credential-Zeichenfolge mit base64-Kodierung. Hierfür können Sie jeden Base64-Encoder online verwenden.
Beispiel: Meine base64-kodierte Credential-Zeichenfolge ist:
YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k= - Erstellen Sie den Berechtigungs-Header im folgenden Format: Basic <Base64-kodierte Anmeldeinformationen>. Beachten Sie das Leerzeichen zwischen „Basic“ und den Credentials.
Beispiel: Mein letzter Autorisierungskopf ist:
Basic YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=
Sie benötigen diese Berechtigungsanmeldedaten im nächsten Abschnitt. Kopieren Sie es irgendwo herunter, wo leicht darauf zugegriffen werden kann.
Schritt 2: Automatisierung in Qualtrics Social Connect erstellen
In diesem Abschnitt wird die Erstkonfiguration beschrieben, 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 Durch ein Ereignis gestartet.
- Wählen Sie die Registerkarte JSON-Ereignis.
- Klicken Sie auf URL kopieren, um den Ereignisendpunkt zu kopieren. Sie benötigen diesen Ereignisendpunkt, um die Einrichtung in Qualtrics Social Connect abzuschließen. Speichern Sie sie an einer Stelle, an der Sie später darauf zugreifen können.
- Melden Sie sich auf einer neuen Browserregisterkarte bei Qualtrics Social Connect an.
Tipp: Qualtrics Social Connect verwendet separate Anmeldeinformationen als Ihr Qualtrics-Konto. Wenden Sie sich an das Social-Connect-Supportteam, 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 Fallaktualisierung auf Automatisierungsrezept hinzufügen.
- Geben Sie Ihrem Automatisierungsrezept einen Namen.
- Stellen Sie sicher, dass Erwähnung im Abschnitt Auslöser ausgewählt ist, und wählen Sie im Dropdown-Menü die Option Wurde angelegt aus.
- Klicken Sie auf das Pluszeichen (+), um ein oder mehrere zu überwachende Themen auszuwählen.
- Konfigurieren Sie im Abschnitt Filter die Filterregeln für die Erwähnungen, die Sie überwachen möchten.
- Wählen Sie im Abschnitt Aktion die Option Webhook auslösen aus dem Dropdown-Menü aus.
- Fügen Sie im Feld URL den Ereignisendpunkt ein, den Sie in Schritt 4 kopiert haben.
- Fügen Sie im Feld Berechtigungskopf den zuvor angelegten Berechtigungskopf ein.
- Wenn Sie einen API-Aufruf zum Abrufen von Tags verwenden, aktivieren Sie die Option Verzögerung. Es wird empfohlen, eine Mindestverzögerung von 10 Minuten festzulegen, um sicherzustellen, dass die Tags die Zeit hatten, an die Erwähnungen angehängt zu werden.
- 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 es natürlich passiert. Sobald 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: Erstellen des Qualtrics-Datensets
Um die Daten in Qualtrics zu speichern, müssen Sie ein Qualtrics-Datenset anlegen. Sie können ein Qualtrics-Datenset anlegen, indem Sie die Datenset-API direkt über die Befehlszeile aufrufen.
- Öffnen Sie einen Texteditor, und erstellen Sie den API-Befehl. Das allgemeine Format lautet wie folgt:
curl -X POST https://brandID.qualtrics.com/API/v3/datasets -H "Content-Type: application/json" -H "X-API-TOKEN: Ihr Qualtrics-API-Token" -d '{ "name": "Wählen Sie einen Namen für Ihr Datenset", "primaryKey": "Spaltenname ID auswählen", "createProject": wahr, "Felder": [ { "name": "Gleicher ID-Spaltenname wie oben", "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.
- Spaltenname ID auswählen: Geben Sie den Feldnamen an, der den Identifikationsschlüssel Ihres Projekts enthalten soll. Wir empfehlen die Verwendung von „uniqueId“.
- Ö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 Dataset-ID aus dem Ergebnis. Diese benötigen Sie später. Das Ergebnis des API-Aufrufs hat das folgende Format:
{"result":{"name":"","primaryKey":" ]},"meta":{"requestId":" ","http} Status"}:"200" - Nachdem Sie Ihr Datenset angelegt 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 über Social Connect importieren möchten. Weitere Informationen zu den Ihnen zur Verfügung stehenden Feldern finden Sie unter Allgemeine Social-Connect-Felder. Wenn Sie Ihre Felder hinzufügen, empfehlen wir, sie als Freitextart in Ihrem Datenset zu sichern.
Schritt 4: Workflow abschließen
Nachdem Sie nun eine Verbindung zu Qualtrics Social Connect hergestellt und Ihr Datenset angelegt haben, ist es an der Zeit, Daten aus Qualtrics Social Connect Ihrem Datenset zuzuordnen.
- Öffnen Sie den zuvor angelegten Workflow.
- Klicken Sie auf das Pluszeichen (+), und wählen Sie Aufgabe.
- Wählen Sie die Registerkarte Web-Service Aufgabe.
- Wählen Sie Authentifizierter Web-Service.
- Klicken Sie auf Weiter.
- Klicken Sie auf Benutzerkonto hinzufügen.
- Geben Sie Ihrem Konto einen Namen. Dies ist für Ihre eigenen organisatorischen Zwecke vorgesehen.
- Wählen Sie OAuth als Verbindungstyp.
- Wählen Sie Client-Credentials für die Erteilungsart.
- Geben Sie Ihre Client-ID und Ihren geheimen Client-Schlüssel ein. Weitere Informationen zum Anlegen finden Sie unter API OAuth.
- Fügen Sie die folgende URL in den Tokenendpunkt ein: https://BrandID.DatacenterID.qualtrics.com/oauth2/token
- Ersetzen Sie den oben fettgedruckten Text durch die entsprechenden IDs:
- BrandID: Ihre Qualtrics-Organisations-ID.
- DatacenterID: Ihre Qualtrics-Rechenzentrums-ID.
- Klicken Sie auf Konto verbinden.
- Wählen Sie Ihr neu hinzugefügtes Konto aus.
- Klicken Sie auf Weiter.
- Wählen Sie POST als Anforderungsart aus.
- Geben Sie die URL im folgenden Format ein:
https://brandID.qualtrics.com/API/v3/datasets/DatasetID/dataDabei ist brandID Ihre Qualtrics-Marken-ID und DatasetID die Dataset-ID, die Sie zuvor kopiert haben.
- Fügen Sie im Abschnitt Kopfzeilen die Berechtigung als Schlüssel hinzu.
- Geben Sie als Wert Träger ein, und fügen Sie ein nachgestelltes Leerzeichen hinzu.
- Klicken Sie auf das Symbol für dynamischen Text {a}, und wählen Sie Ihr QSC-Konto aus.
- Wählen Sie in der Sektion Körper JSON-Schlüssel-Wert-Paare aus, und beginnen Sie mit der Zuordnung Ihrer Felder. Geben Sie als 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 Allgemeine Social-Connect-Felder enthält den dynamischen Textcode für nicht transformierte Daten aus Social Connect.
- Wenn Sie fertig sind, klicken Sie auf Speichern.
Schritt 5: Daten aus Qualtrics Social Connect 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 Datensatzfeld finden Sie unter Allgemeine Social-Connect-Felder.
- Sichern Sie Ihre Änderungen, wenn Sie fertig sind.
Die Bearbeitung Ihres Dashboards entspricht der Bearbeitung 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 Ihnen, 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 fertig sind, klicken Sie auf Ihrem Dashboard auf die Schaltfläche In Text iQ analysieren.
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 Nachrichteninhaltsfeld auswählen.
Die Verwendung von Text iQ für Social-Connect-Daten funktioniert genauso wie die Analyse des Umfrageantworttextes in Qualtrics. Weitere Informationen finden Sie auf den folgenden Supportseiten:
XM Encover Enrichments importieren
In diesem Abschnitt wird beschrieben, wie XM Anreicherungen in Ihr Datenset importiert wird. Obwohl die Integration in Qualtrics Social Connect nicht obligatorisch ist, helfen XM Discover Enrichments Ihnen dabei, Ihre Erwähnungen in Echtzeit zu analysieren, indem Sie sie basierend auf den Inhalten der Erwähnung kennzeichnen.
- Navigieren Sie in Social Connect zu Tags.
- Klicken Sie auf XM hinzufügen Anreicherung erkunden.
- Wählen Sie die Themen aus, für die Sie Anreicherungen hinzufügen möchten.
- Klicken Sie auf Weiter.
- 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, indem Sie sich bei Ihrem Qualtrics Social-Connect-Konto anmelden, auf das Profilsymbol klicken und Support kontaktieren auswählen.
. - Wählen Sie für Echtzeitanreicherung die Option Ja aus.
Achtung: Wenn Sie die Echtzeitanreicherung nicht aktivieren, werden XM-Discover-Anreicherungen mit einer Verzögerung von 7 oder mehr Minuten verarbeitet, nachdem die Erwähnung in Social Connect erstellt wurde. Daher sind die entsprechenden Tags in Ihrem Qualtrics-Workflow nicht verfügbar.
- Klicken Sie auf Speichern.
Kehren Sie zu Ihrem Workflow in Qualtrics zurück. Stellen Sie sicher, dass Sie Ihre Felder in Ihrem Qualtrics-Workflow zuordnen, um XM-Discover-Anreicherungen Ihrem Qualtrics-Datenset zu speichern. Diese werden als Tag-Feld gespeichert.
Da XM Discover Enrichments als kommagetrennte Liste exportiert werden, 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 machen.
Allgemeine Social-Connect-Felder
Dieser Abschnitt enthält eine Tabelle der häufig verwendeten Felder aus Social Connect, ihren dynamischen Textcode zum Erstellen Ihrer Zuordnung, den Feldtyp, den Sie als in Qualtrics speichern sollten, sowie alle speziellen Hinweise zu dem Feld.
| Feldname Datenset | Pfad für dynamischen Text (für Workflow-Zuordnung) | Dashboard-Feldtyp | Beschreibung und besondere Hinweise |
| id | ~{aed://id} | Textwert | Spezifische Kennung für Qualtrics Social Connect für diese Erwähnung (eindeutig pro Thema). |
| Eindeutige ID | ~{aed://unique_id} | Textwert | Spezifische Kennung für Qualtrics Social Connect für diese Erwähnung. |
| authorName | ~{aed://author.name} | Textwert | Benutzername oder Handle des Autors der Erwähnung. |
| authorFullname | ~{aed://author.fullname} | Textwert | Vollständiger Name des Verfassers der Erwähnung. |
| Berechtigungs-ID | ~{aed://author.id} | Textwert | Servicespezifische ID des Autors (z.B. Twitter-UID) |
| originalAuthorName | ~{aed://original_author.name} | Textwert | Benutzername oder Handle des ursprünglichen Autors der Erwähnung. (Falls es sich um einen Retweet, Repin, … handelt) |
| originalAuthorFullname | ~{aed://original_author.fullname} | Textwert | Vollständiger Name des ursprünglichen Verfassers 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 | ISO-639-1-Sprachcode der Sprache, in der sich diese Meldung befindet. |
| messageSentiment | ~{aed://message.sentiment} | Textfeld | Jede(r) von positiv, negativ, neutral oder nicht festgelegt. |
| messageType | ~{aed://message.type} | Textfeld | Art der Meldung.
Mögliche Werte: “post”, “privatemessage”, “video”, “checkin”, “bild”, “text”, “quote”, “link”, “chat”, “audio”, “email”, “review”, “applause”, “like”, “retweet”, “shared”, “repin”, “user_favorit”, “reblog”, “reblog”, “weet”, “retweet”, “shared”, “repin”, “user_favorite”, “reblog”, “weet”, “bindung”, “shared”, “repin”, “user_favoritiv”, “reblog”, “reblog”, “weet”, “engagement”, “shared”, “repin”, “user_favoritiv”, “reblog”, “reblog”, “inaktiviert”, “geteilte”, “repin”, “postcase”, “reblog” |
| sourceCategory | ~{aed://source.category} | Textfeld | Kategorie, unter der diese Erwähnung klassifiziert werden kann.
Mögliche Werte: „sozial“, „social_videos“, „social_photos“, „mikroblogs“, „forums“, „blogs“, „podcasts“, „comments“, „news_local“, „news_ist“, „news_in“, „wis_und“, „news_company“, „wirs_governance“, „wirs_governance“, „newsshops“. |
| sourceService | ~{aed://source.service} | Textfeld | Aus welcher Quelle „verbundener Service“ die Erwähnung stammt.
Mögliche Werte: “twitter”, “facebook”, “facebook_ads”, “foursquare_venue”, “googleplus”, “instagrame_cloud”, “instagram_cloud”, “businessgedid” “insting_cloud”, “savam_ads”, “companamin_group”, “pinterest”, “rss”, “youtthube”, “mixtuse”, “telegram_group” |
| Quelltyp | ~{aed://source.type} | Textfeld | Aus welcher Quelle stammt die Erwähnung? (Interner Name zum Filtern.)
Mögliche Werte: “SearchProviderFacebook”, “SearchProviderFacebookAds”, “SearchProviderProviderProviderProviderProviderApps”, “SearchProviderProviderProviderGoogle”, “SearchProviderProviderGooglePlus”, “SearchProviderSearchaSearchSearchSearchSearchi” “SearchomSearchSearchamAds”, “SearchProviderLinkedHashtags”, “ProviderProviderProviderProviderProviderProviderSolutions”, “SearchProviderWeanch”, “SearchInstSearchSearchSearchamAds”, “SearchProviderLinkedHashTags”, “ProviderProviderProviderProviderProviderProviderGroups”, “SearchProviderWarever-Suche”, “SearchInstameSearchSearchamAds”, “SearchProviderListeCloud”. |
| Quell-ID | ~{aed://source.id} | Textwert | Identifikation dieser Nachricht auf dem Service, aus dem sie stammt. (z.B. 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 | Kontinentencode. |
| 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 Strings; (Smart-)Tags, die dieser Erwähnung hinzugefügt wurden. |
| topicId | ~{aed://topic.id} | Textwert | |
| topicName | ~{aed://topic.name} | Textwert | |
| Status | ~{aed://status} | Textfeld | 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 | Spezifische URL von Qualtrics Social Connect. |
| 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 Codeaufgabe verwenden, um das Datum in ein benutzerfreundlicheres Format umzuwandeln. Alternativ können Sie das standardmäßige Aufzeichnungsdatum verwenden, das erstellt wird, wenn der Beitrag in Qualtrics importiert wird, da das Datum und die Uhrzeit ungefähr identisch sind. |
| datePublished | ~{aed://date.publish} | Textwert | UNIX-Zeitstempel (in UTC) der Veröffentlichung des Beitrags.
Wahrscheinlich möchten Sie stattdessen den dynamischen Text der Codeaufgabe mit formatiertem Datum verwenden. |
| Priorität | ~{aed://Priority} | Textfeld | |
| Label | Mehrfachantwort-Textfeld | Array aus Strings; (Smart-)Tags, die dieser Erwähnung hinzugefügt wurden. Smart-Tag-Daten werden nicht über Webhooks gesendet. Es befindet sich nicht in der Payload des Erwähnungsobjekts. Sie können nur über einen API-Aufruf abgerufen werden. |