-
Customer Experience -
Employee Experience -
Brand Experience -
Core XM -
Design XM
一般的な API の質問
一般的な API の質問について
クアルトリクスには、お客様が実用的なデータをリアルタイムで収集できるさまざまな製品があります。これらの製品には、アンケートプラットフォーム、ウェブサイト／アプリのフィードバック、XM Directory、Qualtrics 360などがあります。Qualtrics API機能を購入すると、ライセンスに含まれるすべての製品でAPIを使用できるようになります。
アンケートプラットフォーム
- 正しいパラメータはすべて揃っていますが、「無効な要求」というエラーメッセージが表示されます。パラメータ要求がないか、無効です。」なぜこんなことが起きているのか。
-
たとえば、
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"}'Qualtrics APIパラメータでは大文字と小文字が区別されます。この例では、パラメータが “format” である必要がある場合、”Format” と呼ばれます。これを更新すると、API 要求を正常に実行できるようになります。
- 未加工のデータをダウンロードして Excelで開きたいと思いますどの API 要求を使用すればよいですか。
- [回答のエクスポートの作成] 要求を使用してエクスポートプロセスを開始し、回答エクスポートファイル形式を CSV に指定します。次に、Get Response Export Progress 要求を使用してファイルの準備ができているかどうかを確認し、次に Get Response Export File 要求を使用して CSV ファイルをダウンロードする必要があります。
- ［連絡先のインポートを作成］を使用する場合、連絡先リストをクアルトリクスに投稿または送信するさまざまな方法は何ですか？
- 連絡先リストのアップロードには、2つのオプションがあります。
- Content-Type を multipart/form-data に設定し、連絡先を JSON ファイルとしてアップロードできます。
- Content-Type を application/json に設定し、要求本文で JSON 配列としてコンタクトを投稿できます。
- 組織に対して行うことができる依頼の数に制限されていますか。同時に実行できる API 要求はいくつありますか。
-
制限の詳細については、この API ページを参照してください。
- ［アンケートをインポート］リクエストを使用しています自分のアンケートをTXTファイルとして保存しましたリクエストは成功しましたが、新しくインポートされたアンケートに質問が表示されません。なぜこんなことが起きているのか。
- Qualtricsにアンケートをインポートするために必要な形式に従っていることを確認する必要があります。TXT形式の詳細については、「標準形式でのTXTファイルの準備」および「詳細形式でのTXTファイルの準備」を参照してください。ファイルが正しくフォーマットされると、要求は正常に実行されます。
- パラメータ startDate および endDate を含む Create Response Export 要求を使用しています。しかし、ダウンロードしたデータを確認すると、予想される応答の日付範囲が表示されません。
- startDate パラメータと endDate パラメータを使用する鍵は、作成する条件を評価するために使用される日付値 (つまり、設定した startDate および設定した endDate を評価するために参照される日付) を理解することです。これら 2 つのパラメータは、参加者がアンケートを開始した日付を使用します。この値は [開始日] と呼ばれ、[データと分析] タブおよびダウンロードされたデータに表示されます。startDate パラメータを 2017-01-01 に設定し、endDate パラメータを 2017-01-02 に設定すると、2017 年 1 月 1 日から 2017 年 1 月 2 日の日付範囲内に調査を開始した調査参加者に対して記録 (提出または不完全) された回答がダウンロードされます。
ヒント：参加者がアンケート内の［送信］ボタンをクリックするか、 不完全なアンケート回答 の時間枠が満たされています。
ウェブサイト／モバイルからのフィードバック
ウェブサイト／モバイルからのフィードバックに関する質問については、ウェブサイト／モバイルからのフィードバックのサポートチームに連絡してください。
XM Directory
- XM Directoryを使用しているアンケートプラットフォームAPIも使用できますか？
- はい、もちろんです。XM Directoryには、アンケートプラットフォームAPIで行われたリクエストを置き換えるAPIリクエストがいくつかありますが、ほとんどの場合、すべてのアンケートプラットフォームのAPIリクエストを引き続き使用できます。変更される可能性があるのは、アンケートプラットフォーム連絡先のリクエストのみです。v3ドキュメントでは、XM DirectoryユーザーにはサポートされていないAPI要求（またはその逆）に通知があります。
- XM Directory APIでは、アンケートプラットフォームAPIのみでアクセスできないどのような追加機能が提供されますか？
- XM Directory APIでは、XM Directoryに固有のいくつかの一意のリクエストが提供されます。getBouncedContacts (API v2.4) を使用すると、自分のディレクトリ (または特定のメーリングリスト) で、これまでにメールバウンスが発生したことがあるすべてのコンタクトを検索することができます。リストディレクトリの連絡先リクエストを使用して、ディレクトリ全体のサブセットをエクスポートできます。getIncentiveRecipients 申請では、特定のインセンティブ (ポイント特典や懸賞エントリなど) を獲得したディレクトリ内のすべての連絡先の一覧をダウンロードできます。これらのリクエストなどは、XM DirectoryAPIで使用できます。
- コンタクト ID と受信者 ID の違いは何ですか。
- 通常、XM DirectoryAPI要求ごとに連絡先の連絡先IDが求められます。この ID は “CID_” で始まり、その後に一意の英数字文字列が続きます。コンタクト ID は、ディレクトリ内のコンタクトの一意の ID です。一部の API 要求では、コンタクトの受信者 ID が求められます。この ID は “CGC_” で始まり、その後に一意の英数字文字列が続きます。［受信者ID］は、メーリングリスト内の連絡先の一意のIDです。
コンタクト ID と受信者 ID の違いを理解するには、各コンタクトがディレクトリに一度だけ存在することに注意してください。ディレクトリには1つの連絡先が一度ありますが、複数のメーリングリストのメンバーである可能性もあります。この連絡先が 3 つのメーリングリストのメンバーであった場合、連絡先は 1 つの連絡先 ID と 3 つの受信者 ID (リストごとに 1 つ) を持ちます。
Qualtrics 360
クアルトリクス360の質問については、クアルトリクス360サポートチームにお問い合わせください。