XM Discoverのデータフォーマット概要
XM Discoverのデータフォーマットについて
XM Discoverは、さまざまなファイルタイプを使用してアップロードできる3つの異なるデータ形式をサポートしています。
以下のコネクターでは、ファイルを介したデータのロードがサポートされています。
- アドホックファイルアップロード受信コネクタ
- ファイル受信コネクタ
- XM Discoverリンク受信コネクタ
ヒント: XM Discover Linkインバウンドコネクターは、データがJSON形式で提示されるAPI呼び出しを介してデータのアップロードを処理します。
個人フィードバック
個別のフィードバック形式は、単一行オブジェクトまたは “フラット” オブジェクトとしてデータを表示するドキュメントに使用されます。各ドキュメントには複数の入力フィールドを含めることができますが、通常は 1 人の作成者のものです(アンケートに複数の自由記述の質問が含まれる場合など)。
以下を使用して、個別のフィードバック文書をアップロードすることができます。
デジタルインタラクション
デジタルインタラクション形式は、チャットなどの会話データを含む文書に使用されます。
デジタルインタラクションは、スピーカー、シーケンス、会話イベントなどの主要な詳細を理解するのに役立つ Qualtrics の会話形式に従う必要があります。同様の会話形式がコール成績証明書に使用されます。
以下を使用して、デジタルインタラクションをアップロードすることができます。
成績証明書の呼出
コール記録書式は、サポートコールなどの会話データを含む文書に使用されます。
コール記録は、スピーカー、シーケンス、会話イベントなどの主要な詳細を理解するのに役立つ Qualtrics の会話形式に従う必要があります。デジタルインタラクションには、同様の対話形式が使用されます。
コール記録は、以下を使用してアップロードすることができます。
サンプルファイルエラー
各種コネクタジョブを使用すると、サンプルファイル (アドホックファイルアップロード、ファイル、XM Discover リンクジョブなど) をアップロードできます。サンプルファイルの設定が間違っている場合は、問題を修正するように求めるエラーメッセージが表示されます。このセクションでは、発生する可能性のあるさまざまなエラーとその修正方法について説明します。
CSV および Excel のエラー
CSV および Excel (XLS、XLSX) サンプルファイルでは、以下のエラーが考えられます。
- ファイルには必須プロパティ “REQUIRED_FIELD” が必要です: 必須フィールドがありません。その接続に必要なフィールドの詳細については、その特定のコネクタに関するドキュメントを参照し、リストされたフィールドがサンプルファイルに含まれていることを確認してください。
- participantId ID の不整合 participantType 値: メッセージのやり取りの各参加者には、1 つの participantType 値のみを定義できます。複数の参加者タイプを持つ参加者のサンプルファイルを確認します。
- 列数がヘッダと一致しません。各列にはヘッダが必要であり、各行の列数は等しい必要があります。
- 列 COLUMN_NAME の行 ROW_NUMBER は、日時書式 ISO 8601 YYYY-MM-DDThh:mm:ss.sZ と一致する必要があります。日付には、秒精度の ISO 8601 書式を使用してください。
JSON エラー
JSON ファイルでは、以下のエラーが考えられます。
- JSON_DATA_PATH でのエラー: は日時書式 ISO 8601 YYYY-MM-DDThh:mm:ss.sZ の文字列である必要があります。日付には、秒精度の ISO 8601 書式を使用してください。
- JSON_DATA_PATH のエラー: AGENT、CLIENT、または TYPE_UNKNOWN の値の文字列である必要があります: 指定されたパスの participantType が無効です。以下の値のみを使用する必要があります。
- AGENT は、会社の担当者またはチャットボットを示します。
- CLIENT はカスタマを示します。
- TYPE_UNKNOWN は、識別されない関与者を示します。
- JSON_DATA_PATH でのエラー: DATA_TYPE である必要があります: 項目値が不適切なデータ型です。データ型がコネクタのデータマッピングの内容と一致していることを確認します。
- JSON_DATA_PATH のエラー: プロパティ REQUIRED_FIELD が必要です: 必須フィールドがありません。その接続に必要なフィールドの詳細については、その特定のコネクタに関するドキュメントを参照し、リストされたフィールドがサンプルファイルに含まれていることを確認してください。
- JSON_DATA_PATH のエラー: 参加者 ID の参加者が参加者内に見つかりません: 参加者 ID は参加者の一覧で提供された ID の 1 つと一致する必要があります。リストされている ID がサンプルファイルに含まれていることを確認してください。