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

# Actions データセットスキーマの要件 (カスタム)
<a name="action-dataset-requirements"></a>

アクション**は、顧客に推奨できるエンゲージメントアクティビティです。アクションには、モバイルアプリのインストール、会員プロフィールの記入、ロイヤルティプログラムへの加入、プロモーションメールへの登録などがあります。*Actions データセット*には、アクションに関するデータが保存されます。Amazon Personalize にインポートできるアクションデータの種類については、「[アクションメタデータ](actions-datasets.md)」を参照してください。

 各アクションについて入力するデータは、Actions データセットのスキーマと一致している必要があります。スキーマによっては、アクションメタデータに空/null 値を含めることができます。

少なくとも、各アイテムについてアクション ID を指定する必要があります (最大長 256 文字)。スキーマには少なくとも 1 つのメタデータフィールドが必要ですが、`null` タイプを追加すると、アクションのこの値は null になる可能性があります。ユースケースとデータに応じて、さらにフィールドを追加できます。フィールドが必須または予約済みとして記載されておらず、データ型が [スキーマのデータ型](how-it-works-dataset-schema.md#personalize-datatypes) に記載されている限り、フィールド名とデータ型は自由に設定できます。

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

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

## Actions データセットのスキーマの例 (カスタム)
<a name="schema-examples-actions"></a>

次の例は、Actions スキーマを構築する方法を示しています。`ACTION_ID` フィールドは必須です。`MEMBERSHIP_LEVEL` フィールドはカテゴリ別文字列フィールドです。`VALUE`、`CREATION_TIMESTAMP`、および `REPEAT_FREQUENCY` フィールドは、必要なタイプの予約キーワードです。最大 10 列を追加できます。スキーマ要件については、「[カスタムデータセットとスキーマの要件](custom-datasets-and-schemas.md#dataset-requirements)」を参照してください。

```
{
  "type": "record",
  "name": "Actions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ACTION_ID",
      "type": "string"
    },
    {
      "name": "VALUE",
      "type": [
        "null",
        "long"
      ]
    },
    
    {
      "name": "MEMBERSHIP_LEVEL",
      "type": [
        "null",
        "string"
      ],
      "categorical": true
    },
    
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    },
    {
      "name": "REPEAT_FREQUENCY",
      "type": [
        "long",
        "null"
      ]
    }
  ],
  "version": "1.0"
}
```

このスキーマでは、CSV ファイルの履歴データの最初の数行は次のようになる場合があります。

```
ACTION_ID,VALUE,MEMBERSHIP_LEVEL,CREATION_TIMESTAMP,REPEAT_FREQUENCY
1,10,Deluxe|Premium,1510003267,7
2,5,Basic,1580003267,7
3,5,Preview,1590003267,3
4,10,Deluxe|Platinum,1560003267,4
...
...
```