zum Hauptinhalt springen
Skip to article
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

Allgemeine API-Fragen

Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

Informationen zu allgemeinen API-Fragen

Qualtrics verfügt über eine Vielzahl verschiedener Produkte, mit denen unsere Kunden handlungsrelevante Daten in Echtzeit sammeln können. Zu diesen Produkten gehören die Umfrageplattform, 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 richtigen Parameter, erhalte aber immer wieder die Fehlermeldung “Ungültige Anforderung. Fehlender oder ungültiger Parameter Request.” Warum passiert das?

Beispiel: 

curl -X POST \  https://yourdatacenterid.qualtrics.com/API/v3/responseexports \  
 -H 'content-type: application/json' \  H 'x-api-token: 12345678901234567890' \  
 -d '{"surveyId":"SV_1234567890","Format":"json"}'

Bei Qualtrics-API-Parametern wird zwischen Groß- und Kleinschreibung unterschieden. In diesem Beispiel heißt Ihr Parameter “Format”, wenn er “Format” lauten sollte. Aktualisieren Sie dies, damit Sie Ihre API-Anforderung erfolgreich ausführen können.

Ich möchte meine Rohdaten herunterladen, um sie in Excel zu öffnen. Welchen API-Request sollte ich verwenden?
Sie möchten die Anforderung zum Erstellen des Antwortexports verwenden, um den Exportprozess zu starten und anzugeben, dass das Dateiformat des Antwortexports CSV sein soll. Anschließend müssen Sie die Anforderung zum Abrufen des Antwortexportfortschritts verwenden, um zu prüfen, ob die Datei bereit ist, gefolgt von der Anforderung zum Abrufen der Antwortexportdatei, um Ihre CSV-Datei herunterzuladen.
Welche verschiedenen Methoden gibt es, um Kontakte zu erstellen oder meine Kontaktliste an Qualtrics zu senden?
Es gibt zwei Möglichkeiten, Ihre Kontaktliste hochzuladen:

  1. Sie können den Content-Type auf multipart/form-data setzen und Ihre Kontakte als JSON-Datei hochladen.
  2. Sie können den Content-Type auf application/json setzen und die Kontakte als JSON-Array im Request-Body posten.
Bin ich auf die Anzahl der Anforderungen beschränkt, die ich für mein Unternehmen stellen kann? Und wie viele gleichzeitige API-Anforderungen kann ich gleichzeitig ausführen?
Weitere Informationen zu Limits finden Sie auf dieser API-Seite.
Ich verwende die Anfrage „Umfrage importieren“ und habe meine Umfrage als TXT-Datei gesichert. Die Anfrage ist erfolgreich, aber meine Fragen werden nicht in meiner neu importierten Umfrage angezeigt. Warum passiert das?
Sie müssen sicherstellen, dass Sie das erforderliche Format für den Import von Umfragen in Qualtrics einhalten. Weitere Informationen zur TXT-Formatierung finden Sie unter TXT-Datei im einfachen Format vorbereiten und TXT-Datei im erweiterten Format vorbereiten. Sobald Ihre Datei korrekt formatiert ist, wird die Anforderung erfolgreich ausgeführt.
Ich verwende die Anfrage zum Anlegen des Antwortexports mit den Parametern startDate und endDate. Wenn ich mir die heruntergeladenen Daten anschaue, sehe ich jedoch nicht den voraussichtlichen Datumsbereich der Antworten.
Der Schlüssel zur Verwendung der Parameter startDate und endDate besteht darin, zu verstehen, welcher Datumswert verwendet wird, um die Bedingung auszuwerten, die Sie anlegen (d.h., welche Daten betrachtet werden, um das von Ihnen festgelegte startDate und das festgelegte endDate auszuwerten). Diese beiden Parameter verwenden das Datum, an dem der Teilnehmer die Umfrage gestartet hat. Dieser Wert, das Startdatum genannt, befindet sich auf der Registerkarte Daten und Analyse und in den heruntergeladenen Daten. Wenn Sie also Ihren Parameter startDate auf den 01.01.2017 und Ihren Parameter endDate auf den 02.01.2017 setzen, laden Sie Antworten herunter, die für Umfrageteilnehmer, die ihre Umfrage im Zeitraum vom 1. Januar 2017 bis zum 2. Januar 2017 gestartet haben, erfasst (eingereicht oder unvollständig) wurden.

Tipp: Eine Umfrageantwort wird erst aufgezeichnet, wenn der Teilnehmer die Drucktaste zum Absenden in einer Umfrage wählt oder wenn der unvollständige Umfrageantworten Zeitraum wurde eingehalten.

Website-/App-Feedback

Bei Fragen zu Website-/App-Feedback wenden Sie sich an unser Website-/App-Feedback-Supportteam.

XM Directory

Kann ich die Umfrageplattform-API jetzt verwenden, wenn ich auch XM Directory verwende?
Ja, absolut. XM Directory enthält einige API-Anforderungen, die Anforderungen ersetzen, die über die Umfragenplattform-API gestellt wurden. Sie können jedoch größtenteils weiterhin alle API-Anforderungen der Umfrageplattform verwenden. Die Umfrageplattformkontakte -Anfragen sind die einzigen, die sich ändern können. In der v3-Dokumentation werden API-Anforderungen, die für XM-Directory-Benutzer nicht unterstützt werden (und umgekehrt), benachrichtigt.
Welche zusätzlichen Funktionen bietet die XM-Directory-API, auf die ich nur mit der Umfrageplattform-API keinen Zugriff habe?
Das XM Directory API stellt Ihnen einige spezielle XM-Directory-spezifische Requests zur Verfügung. Sie können getBouncedContacts (API v2.4) verwenden, um alle Kontakte in Ihrem Verzeichnis (oder in einer bestimmten Mailingliste) zu finden, die jemals eine E-Mail-Zurückweisung hatten. Mit der Anforderung Verzeichniskontakte auflisten können Sie eine Teilmenge Ihres gesamten Verzeichnisses exportieren. Mit der getIncentiveRecipients-Anforderung können Sie eine Liste aller Kontakte in Ihrem Verzeichnis herunterladen, die einen bestimmten Kaufanreiz erhalten haben, z.B. eine Punkteprämie oder einen Treuepunkteintrag. Diese und andere Anfragen sind mit dem XM Directory API verfügbar.
Was ist der Unterschied zwischen der Kontakt-ID und der Empfänger-ID?
Bei jeder XM-Directory-API-Anforderung wird in der Regel nach der Kontakt-ID des Kontakts gefragt. Diese ID beginnt mit „CID_“, gefolgt von einer eindeutigen alphanumerischen Zeichenfolge. Die Kontakt-ID ist die eindeutige ID des Kontakts in Ihrem Verzeichnis. Einige API-Anforderungen fordern die Empfänger-ID des Kontakts an. Diese ID beginnt mit „CGC_“, gefolgt von einer eindeutigen alphanumerischen Zeichenfolge. Die Empfänger-ID ist die eindeutige ID des Kontakts in einer Mailingliste.

Um den Unterschied zwischen der Kontakt-ID und der Empfänger-ID zu verstehen, ist es wichtig zu beachten, dass jeder Kontakt nur einmal in Ihrem Verzeichnis vorhanden sein sollte. Ein einzelner Kontakt kann also 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-ID und drei Empfänger-IDs, eine für jede Liste.

Qualtrics 360

Wenden Sie sich bei Qualtrics-360-Fragen an unser Qualtrics-360-Supportteam.

Viele Seiten dieses Portals wurden mithilfe maschineller Übersetzung aus dem Englischen übersetzt. Obwohl wir bei Qualtrics die bestmögliche maschinelle Übersetzung ausgewählt haben, um ein möglichst gutes Ergebnis zu bieten, ist maschinelle Übersetzung nie perfekt. Der englische Originaltext gilt als offizielle Version. Abweichungen zwischen dem englischen Originaltext und den maschinellen Übersetzungen sind nicht rechtlich bindend.