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

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

 *項目互動資料集*會儲存 ECOMMERCE 目錄中使用者和項目之間互動的歷史和即時資料。如需可存放在互動資料集之資料類型的詳細資訊，請參閱 [項目互動資料](interactions-datasets.md)。如需有關一般 Amazon Personalize 結構描述要求的資訊，例如格式化要求和可用的欄位資料類型，請參閱 [為 Amazon Personalize 結構描述建立結構描述 JSON 檔案](how-it-works-dataset-schema.md)。這些要求適用於所有結構描述，無論網域為何。

 您必須至少建立項目互動資料集，而且您的結構描述必須具有下列欄位：
+ USER\$1ID (`string`)
+ ITEM\$1ID (`string`)
+ TIMESTAMP (`long`)
+ EVENT\$1TYPE (`string` 和 取決於[使用案例](domain-use-cases.md)`Purchase`和`View`事件類型）

 您的結構描述也可以包含下列預留關鍵字：
+ EVENT\$1VALUE (`float`、`null`)
+ 印象 (`string`、`null`)
+ RECOMMENDATION\$1ID (`string`、`null`)

 您匯入的資料必須符合您的結構描述。您可以根據您的使用案例和資料，自由新增其他欄位。只要欄位未列為必要或預留，且資料類型列於 中[結構描述資料類型](how-it-works-dataset-schema.md#personalize-datatypes)，欄位名稱和資料類型將由您決定。如需 ECOMMERCE 網域項目互動資料集的預設結構描述範例，請參閱 [預設互動結構描述 (ECOMMERCE 網域）](#ECOMMERCE-interactions-schema)。

 如果您有事件的值資料，可選擇性地新增預留關鍵字 EVENT\$1VALUE。如果您想要包含明確和隱含的印模資料，可選擇性地新增預留關鍵字 IMPRESSION。如需記錄印模資料的詳細資訊，請參閱 [印象資料](interactions-datasets.md#interactions-impressions-data)。

 您可以新增至項目互動資料集的選用中繼資料欄位總數上限，結合項目互動資料中*不同*事件類型的總數為 10。此計數中包含的中繼資料欄位為 EVENT\$1TYPE、EVENT\$1VALUE 欄位，以及您新增至結構描述的任何自訂中繼資料欄位。排除預留欄位的中繼資料欄位數目上限為 5 個，例如 IMPRESSION。分類值最多可有 1000 個字元。如果您與超過 1000 個類別值的互動，您的資料集匯入任務將會失敗。

如需 ECOMMERCE 網域項目互動資料集最低需求和最高資料限制的詳細資訊，請參閱 [Service Quotas](limits.md#limits-table)。

## 預設互動結構描述 (ECOMMERCE 網域）
<a name="ECOMMERCE-interactions-schema"></a>

 以下是項目互動資料集的預設 ECOMMERCE 網域結構描述。

```
{

  "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": "TIMESTAMP",
          "type": "long"
      }
  ],
  "version": "1.0"
}
```