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

# Users データセットの要件 (ECOMMERCE ドメイン)
<a name="ECOMMERCE-users-dataset"></a>

 *Users データセット*には、ユーザーに関するメタデータが保存されます。これには、各ユーザーについての年齢、性別、ロイヤルティメンバーシップなどの情報が含まれる場合があります。Amazon Personalize にインポートできるユーザーデータの種類の詳細については、「[ユーザーメタデータ](users-datasets.md)」を参照してください。フォーマット要件や使用可能なフィールドデータ型など、Amazon Personalize スキーマの一般的な要件については、「[Amazon Personalize スキーマのスキーマ JSON ファイルの作成](how-it-works-dataset-schema.md)」を参照してください。これらの要件は、ドメインに関係なくすべてのスキーマに適用されます。

 Users データセットは、すべての Eコマースのユースケースで必須ではありません。ユーザーデータがある場合は、最も関連性の高いレコメンデーションを取得するために当該データを作成することをお勧めします。Users データセットを作成する場合、スキーマには次のフィールドが含まれている必要があります。
+ USER\$1ID
+ 1 つのメタデータフィールド (カテゴリ `string` または数値)

インポートするデータは、スキーマと一致している必要があります。ユースケースとデータに応じて、さらにフィールドを追加することができます。フィールドが必須または予約済みとして記載されておらず、データ型が [スキーマのデータ型](how-it-works-dataset-schema.md#personalize-datatypes) に記載されている限り、フィールド名とデータ型は自由に設定できます。ECOMMERCE ドメインの Users データセットのデフォルトスキーマの例については、「[デフォルトのユーザースキーマ (ECOMMERCE ドメイン)](#ECOMMERCE-users-dataset-schema)」を参照してください。

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

## カテゴリ別データを使用する
<a name="retail-categorical-users"></a>

 カテゴリデータを使用するには、タイプ `string` のフィールドを追加し、スキーマでフィールドのカテゴリ属性を `true` に設定します。その後、カテゴリデータをバルク CSV ファイルと個別レコードインポートに含めます。複数のカテゴリを持つユーザーについては、バーティカルバー「\$1」を使用して各値を区切ります。例えば、SUBSCRIPTION\$1MODEL フィールドについて、ユーザーのデータは student\$1monthly\$1discount である場合があります。

カテゴリ値には、最大 1,000 文字を使用できます。1,000 文字を超えるカテゴリ値を持つユーザーがいる場合、データセットのインポートジョブは失敗します。

## デフォルトのユーザースキーマ (ECOMMERCE ドメイン)
<a name="ECOMMERCE-users-dataset-schema"></a>

 必須のメタデータフィールドとして CATEGORY フィールドを持つ Users データセットのデフォルトの ECOMMERCE ドメインスキーマを次に示します。

```
{

  "type": "record",
  "name": "Users",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "MEMBERSHIP_STATUS",
          "type": "string",
          "categorical": true
      }
  ],
  "version": "1.0"
}
```