-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
記事テンプレート
デジタル・インタラクションズのデータ形式について
XM Discoverでは、CSV、Excel、JSON経由でデジタル・インタラクション（会話など）をアップロードできます。デジタル・インタラクションは会話の参加者を特定し、各メッセージを参加者に属性付けする。
通常、デジタルインタラクションには、顧客と貴社のエンティティ間の会話を表す構造化および非構造化データフィールドが多数含まれます（例えば、顧客と貴社のウェブサイト上のチャットボット間のテキストトランスクリプト、または顧客とライブサポート担当者間のチャットトランスクリプト）。構造化フィールドには、日付、数字、または高度に組織化されたテキストデータ（ブランド名、参加者名、製品名など）を含めることができる。非構造化フィールドには、メモ、コメント、その他自由記述のテキストフィールドが含まれます。
以下のフォーマットでデジタル・インタラクションをアップロードできます：
- CSV
- XLS または XLSx (Microsoft Excel)
- JSON
デジタル交流のためのCSVとExcelフォーマット
このセクションでは、CSVファイルとExcelファイルの個別フィードバックの書式設定について説明します。どちらのファイルタイプも書式と条件は同じです。
CSVやExcelファイルでは、デジタル・インタラクションは複数の行を使って定義される。ITの仕組みはこうだ：
- 各行には、参加者データとタイムスタンプとともに、会話中の個々の行が含まれます。
- 同じ会話に帰属する別々の行は、同じ会話IDによって識別される。
- 会話全体のフィールド値（ドキュメント日付やカスタム属性など）は、会話の最初の行から取得されます。
- カラムヘッダーは、以下の表のフィールドと正確に一致する必要があります。
ファイルを作成したら、conversationIdでソートして、あるインタラクションのすべての行をグループ化します。次に、conversationTimestampでファイルをソートし、会話が時系列になるようにする。
デジタル・インタラクション分野
| カラムヘッダー | 説明 |
| conversationId
(必須) |
会話全体のユニークなID。同じIDを持つ各行は、1つの会話内で別々の行として扱われる。
このフィールドをnatural_id属性にマップすると、ドキュメントの Natural ID として使用できます。 |
| 会話タイムスタンプ
(必須) |
会話全体の日時。通常、会話が始まるのはこの時だ。秒単位の精度でISO 8601フォーマットを使用する。
このフィールドをdocument_date属性にマッピングして、Document Dateとして使用することができます。 |
| 参加者ID
(必須) |
参加者のID。会話における一意の参加者は、それぞれ異なるIDを持たなければならない。
複数の会話で同じ参加者IDを持つことはできますが（たとえば、同じエージェントが何度もやりとりする場合など）、1つの会話内で同じ参加者IDを持つことはできません。 |
| 参加者タイプ
(必須) |
参加者のタイプ。可能な値：
これらの値は、レポートおよび参加者の図表のために、CB参加者タイプ属性に渡される。 未指定の場合、CB参加者タイプはレポート可能な値を持ちません。 |
| is_bot
(オプション) |
参加者がチャットボットか人かを示すブール値フィールド。
これらの値は、レポートと参加者の図表のために、CB Kind of Participant属性に渡される。 未指定の場合、参加者の種類は報告されない。 |
| text
(必須) |
メッセージの本文。
注意すべてのテキスト要素の合計が100,000文字を超えることはできません。その場合、会話はスキップされる。
|
| タイムスタンプ
(必須) |
メッセージの日付と時刻。秒単位の精度でISO 8601フォーマットを使用する。 |
| カスタムフィールド
(オプション) |
会話に構造化属性を追加するために、複数のフィールドを提供することができます。 |
デジタル・インタラクションのためのJSONフォーマット
トップレベル・オブジェクト
次の表は、ドキュメント・ノードのトップレベル・オブジェクトについて説明したものです。
| 要素 | 説明 |
| 会話ID | 会話全体のユニークなID。
このフィールドをnatural_id属性にマップすると、ドキュメントの Natural ID として使用できます。 |
| 会話タイムスタンプ | 会話全体の日時。通常、会話が始まるのはこの時だ。秒単位の精度でISO 8601フォーマットを使用する。
このフィールドをdocument_date属性にマッピングして、Document Dateとして使用することができます。 |
| 内容 | 会話の内容を含むオブジェクト。これらのネストされたオブジェクトを含む：
|
| カスタムフィールド（属性） | 会話に構造化属性を追加するために、複数のキーと値のペアを提供することができます。 |
コンテンツオブジェクト
次の表は、コンテンツ・オブジェクトの内部に入れ子になっているオブジェクトについて説明したものである。
| 要素 | 説明 |
| 参加者 | 会話の参加者に関する情報を提供するオブジェクトの配列。これらのフィールドを含む：
|
| 会話内容 | 会話の行を含むオブジェクトの配列。これらのフィールドを含む：
|
参加者 オブジェクト
以下の表は、参加者オブジェクトの中に入れ子になっているフィールドを説明している。
| 要素 | 説明 |
| 参加者ID
(必須) |
参加者のID。会話における一意の参加者は、それぞれ異なるIDを持たなければならない。
複数の会話で同じ参加者IDを持つことはできますが（たとえば、同じエージェントが何度もやりとりする場合など）、1つの会話内で同じ参加者IDを持つことはできません。 |
| 参加者タイプ
(必須) |
参加者のタイプ。可能な値：
これらの値は、レポートおよび参加者の図表のために、CB参加者タイプ属性に渡される。 未指定の場合、CB参加者タイプはレポート可能な値を持ちません。 |
| is_bot
(オプション) |
参加者がチャットボットか人かを示すブール値フィールド。
これらの値は、レポートと参加者の図表のために、CB Kind of Participant属性に渡される。 未指定の場合、参加者の種類は報告されない。 |
会話内容オブジェクト
以下の表は、conversationContentオブジェクトの中にネストされたフィールドを説明する。
| 要素 | 説明 |
| 参加者ID
(必須) |
発言している参加者のID。参加者配列で指定されたIDのいずれかと一致しなければならない。 |
| text
(必須) |
スピーチ原稿。
注意すべてのテキスト要素の合計が100,000文字を超えることはできません。その場合、会話はスキップされる。
|
| タイムスタンプ
(必須) |
メッセージの日付と時刻。秒単位の精度でISO 8601フォーマットを使用する。 |
| id
(必須) |
メッセージのユニークID。 |
JSONの例
[ { "conversationId"："37852", "conversationTimestamp"："2020-07-30T12:42:15.000Z", "content"：{ "参加者"：[ { "participantId"："1", "participantType"："AGENT", "is_bot": true }, { "participantId"："2", "participantType"："CLIENT", "is_bot": false } ], "conversationContent"：[ { "participantId"："1", "text"："Hello, how may I help you?", "timestamp"："2020-07-30T12:42:15.000Z", "id"："3785201" }, { "participantId"："2", "text"："Hi, are you open today?", "timestamp"："2020-07-30T12:42:15.000Z", "id"："3785202" }, { "participantId"："1", "text"："We're open from 17:00 till 23:00.", "timestamp"："2020-07-30T12:42:15.000Z", "id"："3785203" }, { "participantId"："2", "text"："I'd like to make a reservation.", "timestamp"："2020-07-30T12:42:15.000Z", "id"："3785204" }, { "participantId"："1", "text"："Absolutely！
どんな名前を使えばいいですか？",
"timestamp"："2020-07-30T12:42:15.000Z",
"id"："3785205"
}
]
},
"city"："Boston",
"source"："Facebook"
}
].