デジタル・インタラクションのデータ形式

スイート
Customer Experience
製品
Qualtrics
このページの内容

デジタル・インタラクションズのデータ形式について

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 として使用できます。
conversationTimestamp

必須

 会話全体の日時。通常、会話が始まるのはこの時だ。秒単位の精度でISO 8601フォーマットを使用する。

このフィールドをdocument_date属性にマッピングして、Document Dateとして使用することができます。
participantId

必須

 参加者のID。会話における一意の参加者は、それぞれ異なるIDを持たなければならない。

複数の会話で同じ参加者IDを持つことはできますが（たとえば、同じエージェントが何度もやりとりする場合など）、1つの会話内で同じ参加者IDを持つことはできません。
participantType

必須

 参加者のタイプ。可能な値：
  • AGENT：企業の担当者またはチャットボットを示す。
  • CLIENT：顧客を示す。
  • TYPE_UNKNOWN：未確認の参加者を示す。

これらの値は、レポートおよび参加者の図表のために、CB参加者タイプ属性に渡される。

未指定の場合、CB参加者タイプはレポート可能な値を持ちません。
is_bot

（任意）

 参加者がチャットボットか人かを示すブール値フィールド。
  • true：チャットボットであることを示す。
  • false：人を示す。

これらの値は、レポートと参加者の図表のために、CB Kind of Participant属性に渡される。

未指定の場合、参加者の種類は報告されない。
text

必須

 メッセージの本文。
注意: すべてのテキスト要素の合計が100,000文字を超えることはできません。その場合、会話はスキップされる。
timestamp

必須

 メッセージの日付と時刻。秒単位の精度でISO 8601フォーマットを使用する。
カスタムフィールド

(オプション)

 会話に構造化属性を追加するために、複数のフィールドを提供することができます。

デジタル・インタラクションのためのJSONフォーマット

このセクションには、デジタルインタラクションのJSONフォーマットの要件が含まれています。

トップレベル・オブジェクト

次の表は、ドキュメント・ノードのトップレベル・オブジェクトについて説明したものです。

要素 説明
conversationId 会話全体のユニークなID。

このフィールドをnatural_id属性にマップすると、ドキュメントの Natural ID として使用できます。
conversationTimestamp 会話全体の日時。通常、会話が始まるのはこの時だ。秒単位の精度でISO 8601フォーマットを使用する。

このフィールドをdocument_date属性にマッピングして、Document Dateとして使用することができます。
内容 会話の内容を含むオブジェクト。これらのネストされたオブジェクトを含む：
  • 参加者
  • 会話内容
  • コンテントセグメントタイプ
カスタムフィールド（属性） 会話に構造化属性を追加するために、複数のキーと値のペアを提供することができます。

コンテンツオブジェクト

次の表は、コンテンツ・オブジェクトの内部に入れ子になっているオブジェクトについて説明したものである。

要素 説明
participants 会話の参加者に関する情報を提供するオブジェクトの配列。これらのフィールドを含む：
  • 参加者ID
  • 参加者タイプ
  • is_bot
conversationContent 会話の行を含むオブジェクトの配列。これらのフィールドを含む：
  • 参加者ID
  • text
  • タイムスタンプ
  • id

参加者 オブジェクト

以下の表は、参加者オブジェクトの中に入れ子になっているフィールドを説明している。

要素 説明
participantId

（必須）

 参加者のID。会話における一意の参加者は、それぞれ異なるIDを持たなければならない。

複数の会話で同じ参加者IDを持つことはできますが（たとえば、同じエージェントが何度もやりとりする場合など）、1つの会話内で同じ参加者IDを持つことはできません。
participantType

必須

 参加者のタイプ。可能な値：
  • AGENT：企業の担当者またはチャットボットを示す。
  • 顧客：顧客を示す。
  • TYPE_UNKNOWN：未確認の参加者を示す。

これらの値は、レポートおよび参加者の図表のために、CB参加者タイプ属性に渡される。

未指定の場合、CB参加者タイプはレポート可能な値を持ちません。
is_bot

（任意）

 参加者がチャットボットか人かを示すブール値フィールド。
  • true：チャットボットであることを示す。
  • false： 人を示す。

これらの値は、レポートと参加者の図表のために、CB Kind of Participant属性に渡される。

未指定の場合、参加者の種類は報告されない。

会話内容オブジェクト

以下の表は、conversationContent オブジェクトの中に入れ子になっているフィールドについて説明したものである。

要素 説明
participantId

必須

 発言している参加者のID。参加者配列で指定されたIDのいずれかと一致しなければならない。
text

必須

 スピーチ原稿。
注意: すべてのテキスト要素の合計が100,000文字を超えることはできません。その場合、会話はスキップされる。
timestamp

必須

 メッセージの日付と時刻。秒単位の精度で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"

}

].

当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。

この記事は役に立ちましたか

いただいたフィードバックはこのページの改善の目的のみに利用します。

素晴らしい！ フィードバックありがとうございます！

フィードバックありがとうございます！