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

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

製品データセットは、すべての 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 です。ユースケースとデータに応じて、さらにフィールドを追加することができます。フィールドが必須または予約済みとして記載されておらず、データ型が スキーマのデータ型 に記載されている限り、フィールド名とデータ型は自由に設定できます。

複数のサブカテゴリがあるアイテムには、予約済みキーワード 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"
}