翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Items データセットの要件 (ECOMMERCE ドメイン)
<a name="ECOMMERCE-items-dataset"></a>

 *Items データセット*には、ECOMMERCE アイテムに関するメタデータが保存されます。これには、各アイテムについての料金、カテゴリ、製品の説明などの情報が含まれる場合があります。Amazon Personalize にインポートできるアイテムデータの種類の詳細については、「[アイテムメタデータ](items-datasets.md)」を参照してください。フォーマット要件や使用可能なフィールドデータ型など、Amazon Personalize スキーマの一般的な要件については、「[Amazon Personalize スキーマのスキーマ JSON ファイルの作成](how-it-works-dataset-schema.md)」を参照してください。これらの要件は、ドメインに関係なくすべてのスキーマに適用されます。

 製品データセットは、すべての Eコマースのユースケースで必須ではありません。アイテムデータがある場合は、最も関連性の高いレコメンデーションを取得するために当該データを作成することをお勧めします。Items データセットを作成する場合、スキーマには次のフィールドが含まれている必要があります。
+ ITEM\_ID
+ 料金 (`float`)
+ CATEGORY\_L1 (カテゴリ別 `string`)

 スキーマには、次の予約済みキーワードを含めることもできます。カテゴリフィールドでは、ユースケースに基づいて独自の値の範囲を定義できます。
+ CATEGORY\_L2 (カテゴリ別 `string`、`null`)
+ CATEGORY\_L3 (カテゴリ別 `string`、`null`)
+ PRODUCT\_DESCRIPTION (テキスト `string`、`null`)
+ CREATION\_TIMESTAMP (`float`)
+ AGE\_GROUP (カテゴリ別 `string`、`null`): 商品が対象とする年齢グループ。値は、新生児、幼児、子供、成人の場合があります。
+ 成人 (カテゴリ別 `null`): `string` 品目がアルコールなどの成人のみを対象としているかどうか。値は「はい」または「いいえ」の場合があります。
+ GENDER (カテゴリ別 `string`、`null`): 商品が対象とする性別。値は、男性、女性、男女兼用です。

 最良のレコメンデーションを取得するには、これらのフィールドをデータと同じ数だけスキーマに保持することをお勧めします。インポートするデータは、スキーマと一致している必要があります。インポートするデータは、スキーマと一致している必要があります。メタデータ列の最大数は 100 です。ユースケースとデータに応じて、さらにフィールドを追加することができます。フィールドが必須または予約済みとして記載されておらず、データ型が [スキーマのデータ型](how-it-works-dataset-schema.md#personalize-datatypes) に記載されている限り、フィールド名とデータ型は自由に設定できます。

 複数のサブカテゴリがあるアイテムには、予約済みキーワード CATEGORY\_L2 および CATEGORY\_L3 を使用します。詳細については、「[カテゴリ別データを使用する](#ECOMMERCE-items-categorical-data)」を参照してください。テキストおよびカテゴリのメタデータについては、「[非構造化テキストメタデータ](items-datasets.md#text-data)」を参照してください。ECOMMERCE ドメインの Items データセットのデフォルトスキーマの例については、「[デフォルトのアイテムスキーマ (ECOMMERCE ドメイン)](#ECOMMERCE-items-dataset-schema)」を参照してください。

## カテゴリ別データを使用する
<a name="ECOMMERCE-items-categorical-data"></a>

 カテゴリデータを使用するには、タイプ `string` のフィールドを追加し、スキーマでフィールドのカテゴリ属性を `true` に設定します。その後、カテゴリデータをバルク CSV ファイルと個別アイテムインポートに含めます。ユースケースに基づいて独自の値の範囲を定義できます。カテゴリ値には、最大 1,000 文字を使用できます。1,000 文字を超えるカテゴリ値を持つアイテムがある場合、データセットのインポートジョブは失敗します。

 複数のカテゴリを持つアイテムについては、バーティカルバー「\|」を使用して各値を区切ります。例えば、CATEGORY\_L1 フィールドについては、アイテムのデータは `Electronics|Productivity|Mouse` である場合があります。複数のレベルのカテゴリデータがあり、一部のアイテムで階層内の各レベル用に複数のカテゴリがあるアイテムがある場合は、各レベル用にフィールドを追加し、フィールド名の後にレベルインジケータ CATEGORY\_L1、CATEGORY\_L2、CATEGORY\_L3 を追加します。これにより、アイテムが複数のマルチレベルカテゴリに属している場合でも、サブカテゴリに基づいてレコメンデーションをフィルタリングできます。例えば、あるアイテムにはカテゴリレベルごとに次のデータが含まれている場合があります。
+ CATEGORY\_L1: 電子機器\|生産性
+ CATEGORY\_L2: 生産性\|コンピューター
+ CATEGORY\_L3: マウス

この例では、アイテムは エレクトロニクス > 生産性 > マウスの階層 *と* 生産性 > コンピュータ > マウスの階層 にあります。L3 まで使用することをお勧めしますが、必要であればそれ以上のレベルを使用することもできます。フィルターの作成と使用については、「[レコメンデーションとユーザーセグメントのフィルタリング](filter.md)」を参照してください。

## デフォルトのアイテムスキーマ (ECOMMERCE ドメイン)
<a name="ECOMMERCE-items-dataset-schema"></a>

 必須フィールドのみを含む ECOMMERCE ドメインの Items データセットのデフォルトスキーマを次に示します。

```
{
  "type": "record",
  "name": "Items",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ITEM_ID",
      "type": "string"
    },
    {
      "name": "PRICE",
      "type": "float"
    },
    {
      "name": "CATEGORY_L1",
      "type": [
        "string"
      ],
      "categorical": true
    }
  ],
  "version": "1.0"
}
```