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

アイテムインタラクションデータセットスキーマの要件 (カスタム)

アイテムインタラクションデータセットは、ユーザーとアイテム間のインタラクションからの履歴データとリアルタイムデータをカタログに保存します。Amazon Personalize が使用できるインタラクションデータの種類については、「アイテムインタラクションデータ」を参照してください。

各インタラクションに提供するデータは、スキーマと一致する必要があります。スキーマによっては、インタラクションメタデータに空/null 値を含めることができます。少なくとも、各インタラクションについて以下を入力する必要があります。

ユースケースとデータに応じて、さらにフィールドを追加することができます。フィールドが必須または予約済みとして記載されておらず、データ型が スキーマのデータ型 に記載されている限り、フィールド名とデータ型は自由に設定できます。

アイテムインタラクションデータセットに追加できるオプションのメタデータフィールドの最大合計数は、データ内の個別のイベントタイプの合計数と合わせて 10 です。このカウントに含まれるメタデータフィールドはTYPE、スキーマに追加するカスタムメタデータフィールドとともに EVENT_、EVENT_VALUE フィールドです。などの予約済みフィールドを除くメタデータフィールドの最大数は 5 IMPRESSIONです。カテゴリ値には、最大 1000 文字を使用できます。1000 を超えるカテゴリ値とのインタラクションがある場合、データセットのインポートジョブは失敗します。

アイテムインタラクションデータセットの最小要件と最大データ制限の詳細については、「Service Quotas」を参照してください。

インタラクションスキーマの例 (カスタム)

次の例は、アイテムインタラクションデータセットのスキーマを示しています。USER_ID、ITEM_ID、TIMESTAMP の各フィールドは必須です。EVENT_TYPE、EVENT_VALUE、IMPRESSION フィールドは Amazon Personalize によって認識されるオプションの予約済みキーワードです。EVENT_TYPE は文字列型でなければならず、カテゴリにすることはできません。 LOCATIONおよび DEVICEはオプションのコンテキストメタデータフィールドです。スキーマ要件については、「カスタムデータセットとスキーマの要件」を参照してください。

{

  "type": "record",
  "name": "Interactions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "ITEM_ID",
          "type": "string"
      },
      {
          "name": "EVENT_TYPE",
          "type": "string"
      },
      {
          "name": "EVENT_VALUE",
          "type": [
             "float",
             "null"
          ]
      },
      {
          "name": "LOCATION",
          "type": "string",
          "categorical": true
      },
      {
          "name": "DEVICE",
          "type": [
              "string",
              "null"
          ],
          "categorical": true
      },
      {
          "name": "TIMESTAMP",
          "type": "long"
      },
      {
          "name": "IMPRESSION",
          "type": "string"
      }
  ],
  "version": "1.0"
}

このスキーマでは、CSVファイル内の履歴データの最初の数行は次のようになります。EVENT_VALUE の一部の値は null であることに注意してください。

USER_ID,ITEM_ID,EVENT_TYPE,EVENT_VALUE,LOCATION,DEVICE,TIMESTAMP,IMPRESSION
35,73,click,,Ohio,Tablet,1586731606,73|70|17|95|96|92|55|45|16|97|56|54|33|94|36|10|5|43|19|13|51|90|65|59|38
54,35,watch,0.75,Indiana,Cellphone,1586735164,35|82|78|57|20|63|1|90|76|75|49|71|26|24|25|6|37|85|40|98|32|13|11|54|48
9,33,click,,Oregon,Cellphone,1586735158,68|33|62|6|15|57|45|24|78|89|90|40|26|91|66|31|47|17|99|29|27|41|77|75|14
23,10,watch,0.25,California,Tablet,1586735697,92|89|36|10|39|77|4|27|79|18|83|16|28|68|78|40|50|3|99|7|87|49|12|57|53
27,11,watch,0.55,Indiana,Tablet,1586735763,11|7|39|95|71|1|6|40|41|28|99|53|68|76|0|65|69|36|22|42|34|67|24|20|66
...
...