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

# アイテムインタラクションデータセットスキーマの要件 (カスタム)
<a name="interactions-dataset-requirements"></a>

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

 各インタラクションに提供するデータは、スキーマと一致する必要があります。スキーマによっては、インタラクションメタデータに空/null 値を含めることができます。少なくとも、各インタラクションについて以下を入力する必要があります。
+ ユーザー ID
+ アイテム ID
+ タイムスタンプ (Unix エポック時間形式)

ユースケースとデータに応じて、さらにフィールドを追加することができます。フィールドが必須または予約済みとして記載されておらず、データ型が [スキーマのデータ型](how-it-works-dataset-schema.md#personalize-datatypes) に記載されている限り、フィールド名とデータ型は自由に設定できます。

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

アイテムインタラクションデータセットの最小要件と最大データ制限の詳細については、「[サービスクォータ](limits.md#limits-table)」を参照してください。

## インタラクションスキーマの例 (カスタム)
<a name="schema-examples-interactions"></a>

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

```
{

  "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\$1VALUE の一部の値が 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
...
...
```