個別フィードバックデータ形式

個別フィードバックのデータ形式について

XM Discoverでは、個別フィードバック形式は、データを1行、つまり「フラット」オブジェクトとして提示するドキュメントに使用されます。各文書には複数の逐語訳フィールドが含まれることがありますが、通常は1人の作成者によるものです（アンケートに複数の自由形式の質問が含まれる場合など）。

通常、個々のフィードバックドキュメントには、顧客からの1つの回答（例えば、アンケート回答やオンラインレビュー）を表す構造化データフィールドと非構造化データフィールドが多数含まれます。構造化フィールドには、日付、数字、または高度に組織化されたテキストデータ（ブランド名、都市名、ホテル名など）を含めることができます。構造化されていないフィールドには、メモ、コメント、または自由形式の質問に対する回答が含まれます。

個別のフィードバックは、以下の形式でアップロードできます：

• CSV
• XLS または XLSx (Microsoft Excel)
• JSON

CSVとExcelフォーマットによる個別フィードバック

このセクションでは、CSVファイルとExcelファイルの個別フィードバックの書式設定について説明します。どちらのファイルタイプも書式と条件は同じです。

• 行のセットアップ： スプレッドシートの最初の行に列名が含まれていることを確認する。これらの名前は、属性名や逐語的な型として使用される。それ以降の行はそれぞれ別の文書として扱われる。一つのファイルには最大100,000行まで入れることができる。

  

  注意: エントリーの間に空の行を含めないでください。

• カラム名：XM Discoverがカラム名を属性名に変換する際、サポートされていない文字を削除したり、長いカラム名を切り詰めたりすることで、サポートされているフォーマットに合うように自動的に調整します。以下のガイダンスに従ってください：
  • キー名には英字（A-Z、a-z）、数字（0-9）、アンダースコア（_）、ダッシュ（-）、角括弧[]、空白文字のみを含める。
  • 理想的なキー名の長さは21文字以下である。これより長い名前は自動的に切り捨てられるため、キー名は99文字を超えないようにしてください。
• ファイルサイズの上限以下のファイルサイズ制限があります：
  • 最大行数：100,000行
  • 最大列数：属性付き100列、逐語フィードバック付き20列。

    

    Qtip:これはプロジェクトの成長を考慮したソフトな制限です。

• 最大フィールド長：フィールド値には以下の制限が適用される：
  • テキスト属性：900文字値がこの制限を超えると、自動的に切り捨てられる。
  • 多値属性：4,000文字。値がこの制限を超えると、自動的に切り捨てられる。
  • バーベイタムフィールド： 512,000文字値がこの制限を超えた場合、そのレコードは拒否される。
• 必須項目です：以下のフィールドをファイルに入力することをお勧めします：
  • 日付フィールド：データに日付フィールドがあることは、レポートや分析において非常に重要です。推奨される日付形式はYYYY-MM-DDThh:mm:ssZです。

    

    Qtip:ファイルに日付欄がない場合、「特定の文書名を設定する」の説明に従って日付を生成することができます。

  • 一意ID: 各行に一意な値を持つカラムがある場合、それをドキュメントのNatural IDとして使用できます。このフィールドはオプションですが、複製文書を管理できるので、強くお勧めします。

    

    Qtip:ファイルに一意なID列がない場合は、「自然なIDを自動的に生成する」の説明に従って、IDを自動的に生成することができます。

JSONフォーマットによる個別フィードバック

このセクションでは、個々のフィードバックに必要なJSONフォーマットについて説明します。

• キー名：XM Discoverがキー名を属性名や逐語タイプに変換する際、サポートされているフォーマットに合わせて自動的に調整されます。キーネームは以下のガイドラインに従うこと：
  • キー名には英字（A-Z、a-z）、数字（0-9）、アンダースコア（_）、ダッシュ（-）、角括弧[]、空白文字のみを含める。
  • 理想的なキー名の長さは21文字以下である。これより長い名前は切り捨てられるため、キー名は99文字以内とする。
• オブジェクト：JSONファイルには、単一のオブジェクトまたは複数のオブジェクトを含めることができます。

  

  注意: 1つのJSONファイルには100,000オブジェクトまでという制限があります。

• フィールドの最大長：属性によって値の長さの上限は異なる：
  • テキスト属性：最大900文字。値が制限を超えると、自動的に切り捨てられる。
  • 多値属性：最大4,000文字。値が制限を超えると、自動的に切り捨てられる。
  • 逐語フィールド：最大512,000文字。値が制限を超えた場合、そのレコードは拒否される。
• 必須項目です：以下のフィールドをファイルに入力することをお勧めします：
  • 日付フィールド：データに日付フィールドがあることは、レポートや分析において非常に重要です。推奨される日付形式はYYYY-MM-DDThh:mm:ssZです。

    

    Qtip:ファイルに日付欄がない場合、「特定の文書名を設定する」の説明に従って日付を生成することができます。

  • 一意ID: 各行に一意な値を持つカラムがある場合、それをドキュメントのNatural IDとして使用できます。このフィールドはオプションですが、複製文書を管理できるため、強くお勧めします。

    

    Qtip:ファイルに一意なID列がない場合は、「自然なIDを自動的に生成する」の説明に従って、IDを自動的に生成することができます。

例

[ { "ID"："1001", "source"："HotelSurveys", "CITY"："New York City", "HOTEL"："Sheraton New York Hotel and Towers", "AUTHOR"："Richard", "REVIEW"："ここでミーティングを主催し、とても素晴らしいエクスペリエンスを味わった。

非常にお勧めします",

"GENDER"："m",

"loyalty level"：「Gold",

"AGE"：51,

"check-in date"："2019-01-01t12:00:00z",

"スコア"：9

}

].