本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 項目資料集需求 (ECOMMERCE 網域）
<a name="ECOMMERCE-items-dataset"></a>

 *項目資料集*會儲存 ECOMMERCE 項目的相關中繼資料。這可能包括每個項目的價格、類別和產品描述等資訊。如需可匯入 Amazon Personalize 的項目資料類型詳細資訊，請參閱 [項目中繼資料](items-datasets.md)。如需有關一般 Amazon Personalize 結構描述要求的資訊，例如格式化要求和可用的欄位資料類型，請參閱 [為 Amazon Personalize 結構描述建立結構描述 JSON 檔案](how-it-works-dataset-schema.md)。這些要求適用於所有結構描述，無論網域為何。

 對於所有 ECOMMERCE 使用案例，項目資料集都是選用的。如果您有項目資料，建議您建立一個，以取得最相關的建議。如果您建立項目資料集，您的結構描述必須包含下列欄位：
+ ITEM\$1ID
+ 價格 (`float`)
+ CATEGORY\$1L1 （類別 `string`)

 您的結構描述也可以包含下列預留關鍵字。對於分類欄位，您可以根據您的使用案例定義自己的值範圍。
+ CATEGORY\$1L2 （類別 `string`、`null`)
+ CATEGORY\$1L3 （類別 `string`、`null`)
+ PRODUCT\$1DESCRIPTION （文字 `string`、`null`)
+ CREATION\$1TIMESTAMP (`float`)
+ AGE\$1GROUP （類別 `string`、)`null`：項目的年齡群組。值可能是嬰兒、嬰兒、兒童和成人。
+ ADULT （類別 `string`、)`null`：項目是否僅限於成人，例如酒精。值可能是是或否。
+ GENDER （類別 `string`、)`null`：項目的性別。值可以是男性、女性和中性。

 若要取得最佳建議，我們建議您在結構描述中保留這些欄位的數量與資料相同。您匯入的資料必須符合您的結構描述。您匯入的資料必須符合您的結構描述。中繼資料資料欄的數量上限為 100。您可以根據您的使用案例和資料，自由新增其他欄位。只要欄位未列為必要或預留，且資料類型列於 中[結構描述資料類型](how-it-works-dataset-schema.md#personalize-datatypes)，欄位名稱和資料類型將由您決定。

 針對具有多個多層類別的項目，使用預留關鍵字 CATEGORY\$1L2 和 CATEGORY\$1L3。如需詳細資訊，請參閱[使用分類資料](#ECOMMERCE-items-categorical-data)。如需文字和分類中繼資料的資訊，請參閱 [非結構化文字中繼資料](items-datasets.md#text-data)。如需 ECOMMERCE 網域項目資料集的預設結構描述範例，請參閱 [預設項目結構描述 (ECOMMERCE 網域）](#ECOMMERCE-items-dataset-schema)。

## 使用分類資料
<a name="ECOMMERCE-items-categorical-data"></a>

 若要使用分類資料，請在結構描述`true`中新增 類型的欄位，`string`並將欄位的分類屬性設定為 。然後在大量 CSV 檔案和個別項目匯入中包含分類資料。您可以根據您的使用案例定義自己的值範圍。分類值最多可有 1000 個字元。如果您有類別值超過 1000 個字元的項目，您的資料集匯入任務將會失敗。

 對於具有多個類別的項目，請使用垂直長條 '\$1' 分隔每個值。例如，對於 CATEGORY\$1L1 欄位，項目的資料可能是 `Electronics|Productivity|Mouse`。如果您有多個層級的分類資料，而且有些項目在階層中的每個層級都有多個類別，請為每個層級新增一個欄位，並在每個欄位名稱後面附加一個層級指標：CATEGORY\$1L1、CATEGORY\$1L2、CATEGORY\$1L3。這可讓您根據子類別篩選建議，即使項目屬於多個多層級類別。例如，項目可能具有每個類別層級的下列資料：
+ CATEGORY\$1L1：電子 \$1 生產力
+ CATEGORY\$1L2：生產力\$1電腦
+ CATEGORY\$1L3：滑鼠

在此範例中，項目位於電子 > 生產力 > 滑鼠階層*和*生產力 > 電腦 > 滑鼠階層中。我們建議最多只使用 L3，但如有必要，您可以使用更多關卡。如需建立和使用篩選條件的資訊，請參閱 [篩選建議和使用者客群](filter.md)。

## 預設項目結構描述 (ECOMMERCE 網域）
<a name="ECOMMERCE-items-dataset-schema"></a>

 以下是 ECOMMERCE 網域項目資料集的預設結構描述，其中只有必要欄位。

```
{
  "type": "record",
  "name": "Items",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ITEM_ID",
      "type": "string"
    },
    {
      "name": "PRICE",
      "type": "float"
    },
    {
      "name": "CATEGORY_L1",
      "type": [
        "string"
      ],
      "categorical": true
    }
  ],
  "version": "1.0"
}
```