Allgemeine API

Suite

Customer Experience Employee Experience Strategy & Research

Produkt

Qualtrics

Was finden Sie hier?

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.

API-Dokumentation für alle Produktbereiche

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 \ https://yourdatacenterid.qualtrics.com/API/v3/responseexports \ -H 'content-type: application/json' \ -H 'x-api-token: 12345678901234567890' \ -d '{"surveyId": "SV_1234567890", "Format": "json"}'

Bei den Qualtrics API-Parametern 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?

Standardmäßig gibt es eine markenweite Begrenzung der Anzahl der gleichzeitigen API. Instanz können zusätzliche persönliche Grenzen für einzelne Benutzer festlegen.

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.

XM Directory

Kann ich die API der Umfrage-Plattform verwenden, wenn ich auch das XM Directory verwende?: Ja, absolut. XM Directory verfügt über einige API-Anfragen, die die Umfragen der XM-Plattform-API ersetzen, aber größtenteils können Sie weiterhin alle Umfragen der XM-Plattform-API 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 API, auf die ich mit der API der XM-Plattform keinen Zugriff habe?: Die XM Directory API stellt Ihnen einige spezielle Anfragen 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 Anfragen sind mit der XM Directory API verfügbar.
Was ist der Unterschied zwischen der Kontakt und der Empfänger:in?: Bei jeder XM Directory API-Anfrage wird in der Regel nach der Kontakt-ID des Kontakts 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.

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.

Hat Ihnen das weitergeholfen?

Das von Ihnen eingereichte Feedback, dient lediglich dazu, diese Seite zu verbessern.

Großartig! Vielen Dank für die Rückmeldung!

Vielen Dank für die Rückmeldung!

Allgemeine API

Allgemeine API

Umfrageplattform

XM Directory

Get the latest news on XM events, research, and product launches