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

# 準備用於訓練的動作互動資料
<a name="action-interactions-datasets"></a>

 如果您使用 [Next-Best-Action](native-recipe-next-best-action.md) 自訂配方，Amazon Personalize 會使用動作互動資料來識別使用者的興趣，並預測他們最可能採取的動作。*動作互動*是涉及使用者和動作[資料集中動作](actions-datasets.md)的互動。例如，如果您的動作資料集中有*註冊*動作，而使用者採取此動作，則您會記錄使用者的 ID、動作的 ID、時間戳記，以及事件類型的記錄 `TAKEN`。

您可以將動作互動匯入 Amazon Personalize *動作互動資料集*。您可以使用資料集匯入任務大量匯入動作互動事件，也可以使用 [PutActionInteractions](API_UBS_PutActionInteractions.md) API 操作即時串流這些事件。您無法在網域資料集群組中建立下一個最佳動作資源，包括動作和動作互動資料集。

您的大量動作互動資料必須位於 CSV 檔案中。檔案中的每一列都應該代表使用者與動作之間的唯一互動。完成資料準備後，您就可以建立結構描述 JSON 檔案。此檔案會告知 Amazon Personalize 您資料的結構。如需詳細資訊，請參閱[為 Amazon Personalize 結構描述建立結構描述 JSON 檔案](how-it-works-dataset-schema.md)。

 下列各節提供如何為 Amazon Personalize 準備動作互動資料的詳細資訊。如需所有資料類型的大量資料格式準則，請參閱[大量資料格式準則](preparing-training-data.md#general-formatting-guidelines)。

**Topics**
+ [動作互動資料需求](#action-interaction-requirements)
+ [事件類型資料](#action-interaction-event-type-data)
+ [動作互動資料範例](#action-interactions-data-schema-example)

## 動作互動資料需求
<a name="action-interaction-requirements"></a>

動作互動資料沒有最低需求。我們建議您將其匯入以取得品質動作建議。如果您沒有動作互動資料，您可以建立空的動作互動資料集，並使用 [PutActionInteractions](API_UBS_PutActionInteractions.md) API 操作記錄客戶與動作的互動。

您的動作互動資料必須至少有下列資料欄。您可以根據您的使用案例和資料，自由新增其他自訂資料欄。
+ USER\$1ID – 與項目互動之使用者的唯一識別符。每個事件都必須有 USER\$1ID。它必須是長度`string`上限為 256 個字元的 。
+ ACTION\$1ID – 使用者互動項目的唯一識別符。每個事件都必須有項目 ID。它必須是長度`string`上限為 256 個字元的 。
+  TIMESTAMP – 事件發生的時間 （以秒為單位的 Unix epoch 時間格式）。每個動作互動都必須有 TIMESTAMP。如需詳細資訊，請參閱[時間戳記資料](interactions-datasets.md#timestamp-data)。
+ EVENT\$1TYPE – 已採取、未採取或檢視動作。每個動作互動都必須有 事件類型。如需詳細資訊，請參閱[事件類型資料](#action-interaction-event-type-data)。

 在您匯入動作互動資料之前，Amazon Personalize 會在 中建議動作，無需個人化，且傾向分數為 0.0。在動作具有下列項目之後，動作就會有分數：
+  與 TakeN 事件類型至少 50 個動作互動。
+  至少 50 個與 NOT\$1TAKEN 或 VIEWED 事件類型的動作互動。

這些動作互動必須存在於最新的解決方案版本訓練中，且必須在動作互動資料集中最新互動時間戳記的 6 週內發生。

## 事件類型資料
<a name="action-interaction-event-type-data"></a>

 Amazon Personalize 可以在事件類型資料中使用模式，以識別使用者最有可能採取的動作。例如，如果客戶經常忽略電子郵件訂閱動作 （以 NOT\$1TAKEN 事件類型表示），Amazon Personalize 可能會調整建議來提供較少這類動作。

 您只能將下列事件類型用於動作互動事件。Amazon Personalize 使用這些事件來了解您的使用者，並計算接下來要建議的動作。
+ 採取 – **記錄使用者採取建議動作時所採取的事件。
+ 未採取 – 當您的使用者刻意選擇在檢視後不採取動作時，記錄*未採取*的事件。例如，如果他們在向他們顯示動作時選擇*否*。*未採取*的事件可能表示客戶對 動作不感興趣。
+ 已檢視 – 當您在使用者選擇採取或不採取動作之前向他們顯示動作時，記錄*已檢視*的事件。Amazon Personalize 使用*檢視*事件來了解使用者的興趣。例如，如果使用者檢視動作但未採取動作，則該使用者未來可能不會對此動作感興趣。

## 動作互動資料範例
<a name="action-interactions-data-schema-example"></a>

CSV 檔案的前幾行包含動作互動資料和所有必要的資料欄，可能如下所示。

```
USER_ID,ACTION_ID,EVENT_TYPE,TIMESTAMP
35,73,Viewed,1586731606
54,35,Not taken,1586731609
9,33,Viewed,1586735158
23,10,Taken,1586735697
27,11,Taken,1586735763
...
...
```

完成資料準備後，您就可以建立結構描述 JSON 檔案。此檔案會告知 Amazon Personalize 您資料的結構。如需詳細資訊，請參閱[為 Amazon Personalize 結構描述建立結構描述 JSON 檔案](how-it-works-dataset-schema.md)。這是上述範例資料結構描述 JSON 檔案的外觀。

```
{

  "type": "record",
  "name": "ActionInteractions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "ACTION_ID",
          "type": "string"
      },
      {
          "name": "EVENT_TYPE",
          "type": "string"
      },
      {
          "name": "TIMESTAMP",
          "type": "long"
      }
  ],
  "version": "1.0"
}
```