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

アイテムデータセットには、カタログ内のアイテムに関するメタデータが格納されます。これには、各アイテムについての料金、ジャンル、利用可否などの情報が含まれる場合があります。Amazon Personalize にインポートできるアイテムデータの種類については、「」を参照してくださいアイテムデータ。フォーマット要件や使用可能なフィールドデータ型など、Amazon Personalize スキーマの一般的な要件については、を参照してくださいデータセットとスキーマ。これらの要件は、ドメインに関係なく、すべてのスキーマに適用されます。

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

• ITEM_ID

• GENRES (カテゴリ string)

• CREATION_TIMESTAMP (Unix エポック時間形式)

スキーマには、次の予約済みキーワードを含めることもできます。

• PRICE (浮動小数点)

• DURATION (浮動小数点)

• GENRE_L2 (カテゴリ string)

• GENRE_L3 (カテゴリ string)

• AVERAGE_RATING (float)

• PRODUCT_DESCRIPTION (textual)

• CONTENT_OWNER (カテゴリstring): 動画を所有している会社。たとえば、HBO、パラマウント、NBC などの値を指定できます。

• CONTENT_CLASSIFICATED (カテゴリstring): コンテンツの評価。たとえば、値が G、PG、PG-13、R、NC-17、および未評価である場合があります。

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

複数のレベルを持つアイテムには、予約済みキーワード G2 および GENE_L2 および GENE_L2 および GENE_L2 および GENE_L2 および GENE_L 詳細については、「カテゴリデータを使用する」を参照してください。テキストおよびカテゴリのメタデータについては、「アイテムデータ」を参照してください。ECOMMERCE ドメインの Items データセットのデフォルトスキーマの例については、「デフォルトのアイテムスキーマ (VIDEO_ON_DEMAND ドメイン)」を参照してください。

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

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

複数のカテゴリを持つアイテムについては、各値をバーティカルバー「|」で区切ります。例えば、GENES フィールドについて、アイテムのデータは次のようになりますAction|Crime|Biopic。複数のレベルのカテゴリデータがあり、各レベル用にフィールドを追加し、各フィールド名の後にレベルインジケータを追加します。各フィールド名の後にレベルインジケータを追加します。各フィールド名の後にレベルインジケータを追加します。これにより、アイテムが複数のレベルカテゴリに属している場合でも、サブカテゴリに基づいてレコメンデーションを絞り込むことができます。たとえば、動画にはカテゴリレベルごとに次のデータが含まれている場合があります。

• ジャンル:アクション|アドベンチャー

• ジャンル_L2: 犯罪|西部劇

• ジャンル_3: バイオピック

この例では、動画はアクション > 犯罪 > バイオピックヒエラルキー、アドベンチャー > ウエスタン > バイオピックヒエラルキーになっています。L3 までしか使用しないことをお勧めしますが、必要に応じてさらに多くのレベルを使用することもできます。フィルターを作成および使用する方法については、「」を参照してくださいレコメンデーションとユーザーセグメントのフィルタリング。

デフォルトのアイテムスキーマ (VIDEO_ON_DEMAND ドメイン)

VIDEO_ON_DEMAND ドメインの Items データセットのデフォルトスキーマを次に示します。

{
  "type": "record",
  "name": "Items",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ITEM_ID",
      "type": "string"
    },
    {
      "name": "GENRES_L1",
      "type": [
        "string"
      ],
      "categorical": true
    },
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    }
  ],
  "version": "1.0"
}