Items データセットの要件 (ECOMMERCE ドメイン）

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

Items データセットは、すべてのECOMMERCEユースケースでオプションです。アイテムデータがある場合は、最も関連性の高いレコメンデーションを取得するために当該データを作成することをお勧めします。Items データセットを作成する場合、スキーマには次のフィールドが含まれている必要があります。

• ITEM_ID

• PRICE (float)

• CATEGORY_L1 (カテゴリ string）

スキーマには、次の予約済みキーワードを含めることもできます。カテゴリフィールドでは、ユースケースに基づいて独自の値の範囲を定義できます。

• CATEGORY_L2 (カテゴリ別 string、null）

• CATEGORY_L3 (カテゴリ別 string、null）

• PRODUCT_DESCRIPTION (テキスト string、null）

• CREATION_TIMESTAMP (float)

• AGE_GROUP (カテゴリ別 string、null): 項目が対象である経過時間グループ。値は、新生児、幼児、子供、成人の場合があります。

• ADULT (カテゴリ別 string、null): アルコールなどの成人のみに制限されているかどうか。値は「はい」または「いいえ」の場合があります。

• GENDER (カテゴリ別 string、null): 項目の対象となる性別。値は、男性、女性、男女兼用です。

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

複数のマルチレベルカテゴリを持つ項目には、予約キーワード CATEGORY_L2 と CATEGORY_L3 を使用します。詳細については、「カテゴリ別データを使用する」を参照してください。テキストおよびカテゴリのメタデータについては、「非構造化テキストメタデータ」を参照してください。ECOMMERCE ドメインの Items データセットのデフォルトスキーマの例については、「」を参照してくださいデフォルトアイテムスキーマ (ECOMMERCE ドメイン）。

カテゴリ別データを使用する

カテゴリデータを使用するには、タイプ 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 まで使用することをお勧めしますが、必要であればそれ以上のレベルを使用することもできます。フィルターの作成と使用については、「レコメンデーションとユーザーセグメントのフィルタリング」を参照してください。

デフォルトアイテムスキーマ (ECOMMERCE ドメイン）

以下は、必須フィールドのみを持つ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"
}