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

# 記錄即時項目互動事件
<a name="recording-item-interaction-events"></a>

 *項目互動事件*是使用者與目錄中項目之間的互動。例如，使用者購買鞋子或觀看電影。

當您顯示客戶項目建議時，記錄即時項目互動事件。這會建置您的互動資料，並保持資料的新鮮度。它告訴 Amazon Personalize 您使用者目前的興趣，這可以改善建議相關性。

 您可以使用 [PutEvents](API_UBS_PutEvents.md) API 操作記錄項目互動事件。Amazon Personalize 會將事件資料附加到資料集群組中的*項目互動*資料集。如果您使用完全相同的時間戳記和相同的屬性記錄兩個事件，Amazon Personalize 只會保留其中一個事件。您可以使用 AWS SDKs、 AWS Amplify 或 AWS Command Line Interface () 記錄項目互動事件AWS CLI。

如果您使用 Apache Kafka，您可以使用 *Amazon Personalize 的 Kafka 連接器*，將項目互動即時串流至 Amazon Personalize。如需詳細資訊，請參閱 *personalize-kafka-connector*[-connector Github 儲存庫中的 Kafka Connector for Amazon Personalize](https://github.com/aws/personalize-kafka-connector/blob/main/README.md)。

 AWS Amplify 包含一個用於記錄 Web 用戶端應用程式項目互動事件的 JavaScript 程式庫，以及一個用於記錄伺服器程式碼中事件的程式庫。如需詳細資訊，請參閱 [Amplify 文件](https://docs.amplify.aws/)。

**Topics**
+ [記錄項目互動事件和訓練模型的需求](#recording-events-requirements)
+ [建立項目互動事件追蹤器](event-get-tracker.md)
+ [記錄單一項目互動事件](putevents-example.md)
+ [使用事件值資料記錄多個項目互動事件](recording-events-example-event-value.md)
+ [使用印模資料記錄項目互動事件](putevents-including-impressions-data.md)
+ [事件指標和屬性報告](event-metrics.md)

## 記錄項目互動事件和訓練模型的需求
<a name="recording-events-requirements"></a>

若要記錄項目互動事件，您需要下列項目：
+ 包含 `Item interactions` 資料集群組，其中資料集可以是空的。如果您完成[入門教學課程](getting-started.md)指南，則可以使用您建立的相同資料集群組和資料集。如需建立資料集群組和資料集的資訊，請參閱 [將訓練資料匯入 Amazon Personalize 資料集](import-data.md)。
+ 事件追蹤器。
+ 呼叫 [PutEvents](API_UBS_PutEvents.md) API 操作。
+  如果您使用 AWS Lambda 函數呼叫 PutEvents 操作，則函數的執行角色必須具有在 `Resource`元素`*`中使用萬用字元執行`personalize:PutEvents`動作的許可。

您可以從空的項目互動資料集開始，並在記錄足夠的資料時，僅使用新的記錄事件來訓練模型。對於所有使用案例 （網域資料集群組） 和配方 （自訂資料集群組），您的互動資料在訓練之前必須具有下列項目：
+ 至少 1000 個項目互動記錄來自與目錄中項目互動的使用者。這些互動可以來自大量匯入、串流事件或兩者。
+ 至少 25 個唯一的使用者 IDs，每個 ID 至少有兩個項目互動。

對於品質建議，我們建議您從至少 1，000 個使用者中至少有 50，000 個項目互動，每個使用者有兩個或更多項目互動。