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

# リアルタイムのアイテムインタラクションイベントの記録
<a name="recording-item-interaction-events"></a>

 アイテムインタラクションイベントは、ユーザーとカタログ内のアイテムとのやり取りです。**例えば、ユーザーが靴を購入したり、映画を見たりする場合です。

お客様におすすめの商品を見せながら、商品とのやり取りをリアルタイムで記録します。これにより、インタラクションデータが蓄積され、データが最新の状態に保たれます。また、Amazon Personalize にユーザーの現在の関心を伝えることができるため、レコメンデーションの関連性が高まります。

 [PutEvents](API_UBS_PutEvents.md) API オペレーションを使用してアイテムインタラクションイベントを記録します。Amazon Personalize は、イベントデータをデータセットグループの*アイテムインタラクションデータセット*に追加します。まったく同じタイムスタンプとプロパティを持つ 2 つのイベントを記録した場合、Amazon Personalize はどちらかのイベントのみを保持します。 AWS SDKs、 AWS Amplify、または AWS Command Line Interface () を使用して、アイテムインタラクションイベントを記録できますAWS CLI。

Apache Kafka を使用している場合は、Amazon Personalize 用 Kafka コネクタを使用して、Amazon Personalize にアイテムインタラクションをリアルタイムでストリーミングできます。**詳細については、*personalize-kafka-connector* の Github リポジトリにある「[Amazon Personalize 用 Kafka コネクタ](https://github.com/aws/personalize-kafka-connector/blob/main/README.md)」を参照してください。

 AWS Amplify には、ウェブクライアントアプリケーションからのアイテムインタラクションイベントを記録するための JavaScript ライブラリと、サーバーコードでイベントを記録するためのライブラリが含まれています。詳細については、[Amplify のドキュメント](https://docs.amplify.aws/)を参照してください。

**Topics**
+ [アイテムインタラクションイベントの記録とモデルのトレーニングに関する要件](#recording-events-requirements)
+ [アイテムインタラクションイベントトラッカーの作成](event-get-tracker.md)
+ [1 つのアイテムインタラクションイベントの記録](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 件ある。これらのインタラクションは、一括インポート、ストリーミングイベント、あるいはその両方からのものである。
+ それぞれに 2 回以上のアイテムインタラクションを伴う 25 個以上のユニークユーザー ID。

質の高いレコメンデーションを行うには、1,000 人以上のユーザーからのアイテムインタラクションが少なくとも 50,000 件あり、それぞれ 2 回以上のアイテムインタラクションがあることが推奨されます。