-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
記事テンプレート
APIに関するよくある質問について
クアルトリクスは、お客様がリアルタイムで実用的なデータを収集できるよう、様々な製品を提供しています。これらの製品には、アンケート調査プラットフォーム、ウェブサイト/モバイルからのフィードバック、XM DIRECTORY、クアルトリクス360などがあります。Qualtrics API機能を購入すると、ライセンスに含まれるすべての製品でAPIを使用できるようになります。
- アンケート調査プラットフォームと XM DIRECTORY のAPI ドキュメントです。
- ウェブサイト/モバイルからのフィードバック用APIドキュメント。
アンケートプラットフォーム
- パラメータはすべて正しいのですが、”Invalid request. パラメータがないか無効です。なぜこのようなことが起きているのか？
-
例
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"}'.クアルトリクスのAPIパラメータは大文字と小文字を区別します。この例では、パラメータは “format “であるべきなのに、”Format “と呼ばれている。これを更新すると、APIリクエストを正常に実行できるようになります。
- 未加工データをダウンロードしてExcelで開きたいのですが。どのAPIリクエストを使用すればよいですか？
- レスポンス・エクスポートの作成リクエストを使用してエクスポート・プロセスを開始し、レスポンスのエクスポート・ファイル形式を CSV に指定します。次に、進行中の回答を取得要求を使用してファイルの準備ができたかどうかを確認し、続いて進行中の回答を取得ファイル要求を使用して CSV ファイルをダウンロードする必要があります。
- 連絡先インポートを使用する場合、クアルトリクスに連絡先リストを投稿または送信するには、どのような方法がありますか？
- 連絡先リストのアップロードには2つのオプションがあります：
- 連絡先のContent-Typeをmultipart/form-dataに設定し、JSONファイルとしてアップロードすることができます。
- Content-Typeをapplication/jsonに設定し、連絡先をJSON配列としてリクエストボディに投稿することができます。
- 組織へのリクエスト数に制限はありますか？また、一度にいくつのAPIリクエストを同時に行うことができますか？
-
制限の詳細については、このAPIのページを参照してください。
- アンケートのインポートを使用しており、アンケートを TXT ファイルとして保存しています。リクエストは成功しましたが、新しくインポートしたアンケートに私の質問が表示されません。なぜこのようなことが起きているのか？
- クアルトリクスにアンケート調査をインポートするために必要なフォーマットに従っていることを確認する必要があります。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 日の日付範囲内にアンケートを開始したアンケート参加者の記録された回答 (送信済みまたは不完全な回答) がダウンロードされます。
Qtip: アンケートの回答が記録されるのは、参加者がアンケート調査の送信ボタンをクリックするか、アンケートの送信ボタンをクリックした後です。 不完全なアンケート回答 期限は守られた。
ウェブサイト／モバイルからのフィードバック
ウェブサイト/モバイルからのフィードバックに関するお問い合わせは、ウェブサイト/モバイルからのフィードバックサポートチームまでご連絡ください。
XM Directory
- XM DIRECTORY を使用していますが、アンケート調査プラットフォーム API も使用できますか?
- そうだ。XM Directory には、Survey Platform API からのリクエストに代わる API リクエストがいくつかありますが、ほとんどの場合、Survey Platform API のすべてのリクエストを使用することができます。アンケート調査の連絡先リクエストは、変更される可能性がある唯一のものです。v3ドキュメントでは、XM DIRECTORYユーザー（およびその逆）がサポートされていないAPIリクエストには、その旨が表示されます。
- XM DIRECTORY API は、アンケート調査プラットフォーム API だけではアクセスできない追加機能を提供してくれますか?
- XM DIRECTORY APIでは、XM Directory特有のリクエストをいくつか提供しています。getBouncedContacts(API v2.4)を使用すると、ディレクトリ内(または特定のメーリングリスト内)でメールがバウンスしたことのある連絡先をすべて検索することができます。連絡先リストリクエストは、ディレクトリ全体のサブセットをエクスポートするために使用できます。getIncentiveRecipientsリクエストは、ポイント報酬や懸賞応募など、特定のインセンティブを獲得したディレクトリ内の連絡先のリストをダウンロードすることができます。これらのリクエストやその他のリクエストはXM DIRECTORY APIで利用可能です。
- 連絡先IDと受信者IDの違いは何ですか？
- 各XM DIRECTORY APIリクエストは通常、連絡先のContact IDを要求します。このIDは “CID_”で始まり、ユニークな英数字の文字列が続く。連絡先IDは、ディレクトリ内の連絡先固有のIDです。APIリクエストの中には、連絡先の受信者IDを要求するものがあります。このIDは “CGC_”で始まり、ユニークな英数字の文字列が続く。受信者IDはメーリングリスト内の連絡先固有のIDです。
連絡先IDと受信者IDの違いを理解するには、各連絡先がディレクトリに存在するのは一度だけであることを覚えておくことが重要です。そのため、1人の連絡先がディレクトリに1度登録されただけで、複数のメーリングリストに登録されている可能性もあります。この連絡先が3つのメーリングリストのメンバーだった場合、連絡先IDが1つ、受信者IDが3つ、それぞれのリストに1つずつあることになります。
Qualtrics 360
クアルトリクス360に関するお問い合わせは、クアルトリクス360サポートチームまでご連絡ください。