-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
デジタルインタラクションデータ書式
デジタルインタラクションデータ書式について
XM Discoverを使用すると、CSV、Excel、JSONを介してデジタルインタラクション（会話）をアップロードできます。デジタルインタラクションにより、会話の参加者が識別され、各メッセージが参加者に帰属します。
通常、デジタルインタラクションには、顧客と会社のエンティティ間の会話 (たとえば、顧客と Web サイトのチャットボットの間のテキスト記録、顧客とライブサポート担当者間のチャット記録) を表す多数の構造化データフィールドと非構造化データフィールドが含まれます。構造化項目には、組織の高度な日付、数値、またはテキストデータ (ブランド名、参加者名、製品名など) を含めることができます。非構造化フィールドには、メモ、コメント、およびその他の自由記述フィールドが含まれます。
デジタルインタラクションは、以下の形式でアップロードすることができます。
- CSV
- XLS または XLSX (Microsoft Excel)
- JSON
デジタルインタラクションの CSV および Excel 書式設定
このセクションでは、CSV ファイルおよび Excel ファイルの個別フィードバックの書式設定について説明します。両方のファイルタイプの書式設定と要件は同じです。
CSV ファイルおよび Excel ファイルでは、デジタルインタラクションは複数の行を使用して定義されます。動作は以下のとおりです。
- 各行には、参加者データおよびタイムスタンプとともに、対話の個別ダイアログ行が含まれます。
- 同じメッセージのやり取り ID を共有することで、別々の行が 1 つの会話にまとめられます。
- 会話全体のフィールド値 ([ドキュメント日付] やカスタム属性など) は、会話の最初の行から取得されます。
- カラムヘッダーは、以下の表のフィールドと正確に一致する必要があります。
以下の表は、デジタル・インタラクションのフィールドを説明したものである。
| カラムヘッダー | 説明 |
| conversationId
(必須) |
メッセージのやり取り全体の一意の ID。同じ ID を持つ各行は、1 つの会話内で個別の行として処理されます。
このフィールドを natural_id 属性にマッピングして、ドキュメントの自然な ID として使用できます。 |
| conversationTimestamp
(必須) |
会話全体の日時。通常、会話が始まるのはこの時だ。秒精度の ISO 8601 書式を使用します。
この項目を document_date 属性にマッピングして、伝票日付として使用することができます。 |
| participantId
(必須) |
参加者の ID。会話に参加するユニークな参加者は、それぞれ異なるIDを持っていなければならない。
複数の会話で同じ参加者IDを持つことはできますが（たとえば、同じエージェントが多くのインタラクションにまたがる）、1つの会話内で同じ参加者IDを持つことはできません。 |
| participantType
(必須) |
参加者のタイプ。使用可能な値:
これらの値は、レポートおよび参加者ビジュアル化のために CB 参加者タイプ属性に渡されます。 指定しない場合、CB 参加者タイプにはレポート可能な値がありません。 |
| is_bot
(オプション) |
参加者がチャットボットであるか個人であるかを示すブール型フィールド。
これらの値は、レポートおよび参加者ビジュアル化のために CB 参加者の種類属性に渡されます。 指定しない場合、CB 参加者の種類にはレポート可能な値がありません。 |
| text
(必須) |
メッセージのテキスト。
注意: すべてのテキストエレメントの合計が 100,000 文字を超えることはできません。その場合、会話はスキップされる。
|
| timestamp
(必須) |
メッセージの日付と時刻。秒精度の ISO 8601 書式を使用します。 |
| カスタムフィールド
(オプション) |
複数の項目を指定して、構造化属性をカンバセーションに追加することができます。 |
デジタルインタラクションの JSON 書式設定
最上位オブジェクト
以下の表では、文書ノードの最上位オブジェクトについて説明します。
| 要素 | 説明 |
| conversationId | メッセージのやり取り全体の一意の ID。
このフィールドを natural_id 属性にマッピングして、ドキュメントの自然な ID として使用できます。 |
| conversationTimestamp | 会話全体の日時。通常、会話が始まるのはこの時だ。秒精度の ISO 8601 書式を使用します。
この項目を document_date 属性にマッピングして、伝票日付として使用することができます。 |
| コンテンツ | 対話のコンテンツを含むオブジェクト。以下のネストされたオブジェクトが含まれます。
|
| カスタムフィールド (属性) | 複数のキーと値のペアを指定して、構造化属性をカンバセーションに追加することができます。 |
コンテンツオブジェクト
以下の表は、コンテンツオブジェクト内にネストされているオブジェクトを示しています。
| 要素 | 説明 |
| 参加者 | 対話の参加者に関する情報を提供するオブジェクトの配列。以下のフィールドが含まれます。
|
| conversationContent | 対話の行を含むオブジェクトの配列。以下のフィールドが含まれます。
|
参加者オブジェクト
以下の表では、participants オブジェクト内にネストされているフィールドについて説明します。
| 要素 | 説明 |
| participantId
(必須) |
参加者の ID。会話に参加するユニークな参加者は、それぞれ異なるIDを持っていなければならない。
複数の会話で同じ参加者IDを持つことはできますが（たとえば、同じエージェントが多くのインタラクションにまたがる）、1つの会話内で同じ参加者IDを持つことはできません。 |
| participantType
(必須) |
参加者のタイプ。使用可能な値:
これらの値は、レポートおよび参加者ビジュアル化のために CB 参加者タイプ属性に渡されます。 指定しない場合、CB 参加者タイプにはレポート可能な値がありません。 |
| is_bot
(オプション) |
参加者がチャットボットであるか個人であるかを示すブール型フィールド。
これらの値は、レポートおよび参加者ビジュアル化のために CB 参加者の種類属性に渡されます。 指定しない場合、CB 参加者の種類にはレポート可能な値がありません。 |
conversationContent Object
以下の表では、conversationContent オブジェクト内にネストされているフィールドについて説明します。
| 要素 | 説明 |
| participantId
(必須) |
話している参加者の ID。participants 配列で指定された ID のいずれかと一致する必要があります。 |
| text
(必須) |
音声の字幕です。
注意: すべてのテキストエレメントの合計が 100,000 文字を超えることはできません。その場合、会話はスキップされる。
|
| timestamp
(必須) |
メッセージの日付と時刻。秒精度の ISO 8601 書式を使用します。 |
| id
(必須) |
メッセージの一意の ID。 |
JSON の例
ここでは、エージェントとクライアント間のコールトランスクリプトの例を示します。
[
{
"conversationId": "37852",
"conversationTimestamp": "2020-07-30T12:42:15.000Z",
"participants": [
" "par
ticipantId": "1",
" "participantType": "AGENT antType": "AGENT"
"AGENT"、
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785201"
},
{
"participantId": "2",
"text": "こんにちは、今日開いていますか?"、
"timestamp": "2020-07-30T12:42:15.000Z",
"id" "id": "3785202"
},
"participantId": "1",
"text": "We're open from 17:00 to 23:00",
"timestamp": "2020-30T12:42:42",
"3785202"
},
使用できる名前",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785205"
}
]
,
"city": "Boston",
"source": "Facebook"
}