Allgemeine API
Allgemeine API
Qualtrics verfügt über eine Vielzahl verschiedener Produkte, mit denen unsere Kunden aussagekräftige Daten in Echtzeit sammeln können. Zu diesen Produkten gehören die Umfrage, Website-/App-Feedback, XM Directory und Qualtrics 360. Sobald Sie das Qualtrics-API-Merkmal erworben haben, können Sie sie für alle Produkte verwenden, die Teil Ihrer Lizenz sind.
Umfrageplattform
- Ich habe alle korrekten Parameter, aber ich erhalte immer eine Fehlermeldung, die besagt, dass die Anfrage ungültig ist. Fehlender oder ungültiger Parameter Request.” Warum passiert das?
-
Beispiel: curl -X POST qualtrics \ -H 'content-type: application/json ' \ -H 'x-api-token: 12345678901234567890' \ -d '{"surveyId":"SV_1234567890","Format":”json”}' Bei Qualtrics wird zwischen Groß- und Kleinschreibung unterschieden. In diesem Beispiel heißt Ihr Parameter „Format“, wenn er „format“ sein sollte. Aktualisieren Sie diese, damit Sie Ihre API erfolgreich ausführen können.
- Ich möchte meine Rohdaten herunterladen, um sie in Excel zu öffnen. Welche API sollte ich verwenden?
- Sie möchten die Antwortexport anlegen Anforderung, den Exportprozess zu starten, und geben Sie an, dass das Dateiformat für den Antwortexport CSV sein soll. Anschließend müssen Sie die Fortschritt des Antwortexports abrufen Anfrage, um zu prüfen, ob die Datei bereit ist, gefolgt von der Antwortexportdatei abrufen anfordern, um Ihre CSV herunterzuladen.
- Welche verschiedenen Methoden gibt es beim Erstellen von Kontaktimporten, um meine Kontaktliste an Qualtrics zu senden?
- Es gibt zwei Möglichkeiten, Ihre Kontaktliste hochzuladen:
- Sie können den Content-Type auf setzen. multipart/form-data und laden Sie Ihre Kontakte als JSON hoch.
- Sie können den Content-Type auf setzen. application/json und die Kontakte als JSON im Anforderungstext veröffentlichen.
- Bin ich auf die Anzahl der Anfragen beschränkt, die ich für mein Organisation stellen kann? Und wie viele gleichzeitige API kann ich gleichzeitig durchführen?
-
Siehe API für weitere Informationen zu Limits.
- Ich verwende die Anforderung Umfrage importieren“ und habe meine Umfrage als TXT gespeichert. Die Anfrage ist erfolgreich, aber meine Fragen werden in meiner neu importierten Umfrage nicht angezeigt. Warum passiert das?
- Sie müssen sicherstellen, dass Sie das für den Import von Umfragen in Qualtrics erforderliche Format verwenden. mehr erfahren zur TXT finden Sie unter. TXT im einfachen Format vorbereiten und Vorbereiten einer TXT im erweiterten Format. Sobald Ihre Datei korrekt formatiert ist, wird die Anforderung erfolgreich ausgeführt.
- Ich verwende die Anforderung “Antwortexport anlegen” mit den Parametern startDate und endDate. Wenn ich mir die heruntergeladenen Daten anschaue, sehe ich jedoch nicht den erwarteten Datumsbereich der Antworten.
- Der Schlüssel für die Verwendung der Parameter startDate und endDate besteht darin, zu verstehen, welcher Datumswert verwendet wird, um die Bedingung auszuwerten, die Sie anlegen (d.h., welche Datumsangaben zur Auswertung des von Ihnen festgelegten startDate und des von Ihnen festgelegten endDate betrachtet werden). Diese beiden Parameter verwenden das Datum, an dem der Teilnehmer:in die Umfrage gestartet hat. Dieser Wert, der als Startdatum bezeichnet wird, befindet sich auf der Registerkarte Daten & Analyse und in den heruntergeladenen Daten. Wenn Sie also den Parameter startDate auf 01.01.2017 und den Parameter endDate auf 02.01.2017 setzen, laden Sie Antworten herunter, die für Umfrage aufgezeichnet (übermittelt oder unvollständig) wurden, die ihre Umfrage im Datumsbereich vom 1. Januar 2017 bis 2. Januar 2017 gestartet haben.
Tipp: Eine Umfrage wird erst erfasst, wenn der Teilnehmer:in auf die Schaltfläche „Senden“ innerhalb einer Umfrage klickt oder wenn die unvollständige Umfrageantworten Zeitrahmen erfüllt wurde.
Website-/App-Feedback
Für Website-/App-Feedback: Kontakt unser Website-/App-Feedback.
XM Directory
- Kann ich die Umfrage jetzt auch mit XM Directory verwenden?
- Ja, absolut. XM Directory verfügt über einige API, die Anforderungen ersetzen, die über die Umfrage vorgenommen wurden, aber in den meisten Fällen können Sie weiterhin alle Umfrage verwenden. Nur die Anfragen der Umfrage können sich ändern. In der v3-Dokumentation werden API angezeigt, die für XM Directory nicht unterstützt werden (und umgekehrt).
- Welche zusätzlichen Funktionen bietet die XM Directory, auf die ich nur mit der Umfrage keinen Zugriff habe?
- Das XM Directory stellt Ihnen einige eindeutige Anforderungen speziell für XM Directory zur Verfügung. Sie können Folgendes verwenden: getBouncedContacts (API v2.4), um alle Kontakte in Ihrem Verzeichnis (oder in einer bestimmten Mailingliste) zu finden, die jemals eine E-Mail-Zurückweisung hatten. Die Verzeichnis auflisten -Anforderung kann verwendet werden, um eine Teilmenge Ihres gesamten Verzeichnis zu exportieren. Die getIncentiveRecipients Mit request können Sie eine Liste aller Kontakt in Ihrem Verzeichnis herunterladen, die einen bestimmten Anreiz erhalten haben, z.B. einen Punkteprämien- oder Gewinnspieleintrag. Diese und andere Anforderungen sind mit dem XM Directory verfügbar.
- Was ist der Unterschied zwischen der Kontakt und der Empfänger:in?
- Bei jeder XM Directory wird in der Regel nach der Kontakt des Kontakt gefragt. Diese ID beginnt mit „CID_“ und wird von einer eindeutigen alphanumerischen Zeichenfolge gefolgt. Die Kontakt ist die eindeutige ID des Kontakt in Ihrem Verzeichnis. Einige API fragen nach der Empfänger:in des Kontakt. Diese ID beginnt mit “CGC_” und wird von einer eindeutigen alphanumerischen Zeichenfolge gefolgt. Die Empfänger:in ist die eindeutige ID des Kontakt in einer Mailingliste.
Um den Unterschied zwischen der Kontakt und der Empfänger:in zu verstehen, müssen Sie beachten, dass jeder Kontakt nur einmal in Ihrem Verzeichnis vorhanden sein sollte. So konnte ein einzelner Kontakt einmal in Ihrem Verzeichnis gefunden werden, kann aber auch Mitglied mehrerer Mailinglisten sein. Wenn dieser Kontakt Mitglied von drei Mailinglisten wäre, hätte er eine Kontakt und drei Empfänger:in, eine für jede Liste.
Qualtrics 360
Für Qualtrics 360: Kontakt unser Qualtrics 360..