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

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

XM Discoverでは、データを単一行または「フラット」オブジェクトとして表示するドキュメントに個別のフィードバック形式が使用されます。各ドキュメントには複数の入力フィールドを含めることができますが、通常は 1 人の作成者のものです（アンケートに複数の自由記述の質問が含まれる場合など）。

通常、個別のフィードバック文書には、顧客からの単一の回答 (調査回答やオンラインレビューなど) を表す多数の構造化データフィールドおよび非構造化データフィールドが含まれます。構造化項目には、日付、番号、または高度な組織 (ブランド、市区町村、ホテルの名称など) のテキストデータを含めることができます。構造化されていないフィールドには、自由記述の質問に対するメモ、コメント、または回答が含まれます。

以下の形式を使用して、個別のフィードバックをアップロードすることができます。

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

個別フィードバック用の CSV および Excel の書式設定

このセクションでは、CSV ファイルおよび Excel ファイルの個別フィードバックの書式設定について説明します。両方のファイルタイプの書式設定と要件は同じです。

• 行設定: スプレッドシートの最初の行に列名が含まれていることを確認します。これらの名称は、属性名および直接タイプとして使用されます。後続の各行は、個別の伝票として処理されます。1 つのファイルには最大 100,000 行を含めることができます。
  注意: エントリ間に空白行を含めないでください。
• 列名：XM Discoverによって列名が属性名に変換されると、サポートされていない文字を削除して長い列名を切り詰めることで、列名がサポートされている形式に合わせて自動的に調整されます。以下のガイダンスに従ってください。
  • キー名に使用できるのは、英字 (A-Z、a-z)、数字 (0-9)、アンダースコア (_)、ダッシュ (-)、角括弧 []、および空白のみです。
  • キー名の理想的な長さは 21 文字以下です。より長い名前は自動的に切り捨てられるため、キー名は 99 文字以内にする必要があります。
• 最大ファイルサイズ制限: 次のファイルサイズ制限が設定されています:
  • 最大行数: 100,000 行
  • 最大列数: 100 列 (属性あり) および 20 列 (逐語的なフィードバック)。
    ヒント：これはプロジェクトの成長を可能にするソフトな制限です。
• 最大項目長: 項目値には以下の制限が適用されます。
  • テキスト属性: 900 文字値がこの制限を超えると、自動的に切り捨てられます。
  • 複数値属性: 4,000 文字。値がこの制限を超えると、自動的に切り捨てられます。
  • 用語項目: 512,000 文字。値がこの制限を超えると、レコードは拒否されます。
• 必須フィールド: ファイルでは次のフィールドが推奨されます:
  • 日付項目: データに日付項目を含めることは、レポートや分析に不可欠です。推奨される日付書式は YYYY-MM-DDThh:mm:ssZ です。
    ヒント：ファイルに日付列がない場合は、「特定のドキュメント名を設定する」の指示に従って日付を生成できます。
  • 一意 ID: 各行に一意の値を持つ列がある場合は、その列をドキュメントの Natural ID として使用できます。このフィールドはオプションですが、重複するドキュメントを管理できるため、強くお勧めします。
    ヒント：ファイルに一意のID列がない場合は、「自然IDの自動生成」の指示に従って自動的に生成できます。

個人フィードバックの JSON フォーマット

このセクションでは、個別のフィードバックに関する JSON 形式の要件について説明します。

• キー名：XM Discoverによってキー名が属性名および文字タイプに変換されると、サポートされている形式に合わせてキー名が自動的に調整されます。キー名は以下のガイドラインに従う必要があります。
  • キー名に使用できるのは、英字 (A-Z、a-z)、数字 (0-9)、アンダースコア (_)、ダッシュ (-)、角括弧 []、および空白のみです。
  • キー名の理想的な長さは 21 文字以下です。長い名称は切り捨てられるため、キー名は 99 文字以内にする必要があります。
• オブジェクト: JSON ファイルには、単一のオブジェクトまたは複数のオブジェクトを含めることができます。
  注意: 単一の JSON ファイルでは 100,000 オブジェクトの制限があります。
• 最大項目長: 属性によって値の長さ制限が異なります:
  • テキスト属性: 最大 900 文字値が制限を超えると、自動的に切り捨てられます。
  • 複数値属性: 最大 4,000 文字。値が制限を超えると、自動的に切り捨てられます。
  • バーバイムフィールド: 最大 512,000 文字。値が制限を超えると、レコードは拒否されます。
• 必須フィールド: ファイルでは次のフィールドが推奨されます:
  • 日付項目: データに日付項目を含めることは、レポートや分析に不可欠です。推奨される日付書式は YYYY-MM-DDThh:mm:ssZ です。
    ヒント：ファイルに日付列がない場合は、「特定のドキュメント名を設定する」の指示に従って日付を生成できます。
  • 一意 ID: 各行に一意の値を持つ列がある場合は、その列をドキュメントの Natural ID として使用できます。このフィールドはオプションですが、重複するドキュメントを管理できるため、強くお勧めします。
    ヒント：ファイルに一意のID列がない場合は、「自然IDの自動生成」の指示に従って自動的に生成できます。

例

以下は、個別のフィードバックの JSON ペイロードの例です。

[
{
"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",


“SCORE”: 9