翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# トレーニング用のアクションインタラクションデータの準備
[Next-Best-Action](native-recipe-next-best-action.md) カスタムレシピを使用する場合、Amazon Personalize はアクションインタラクションデータを使用してユーザーの関心を特定し、最も可能性の高いアクションを予測します。*アクションインタラクション*は [Actions データセット](actions-datasets.md)内のユーザーとアクションが関与するインタラクションです。例えば、Actions データセットに*登録*アクションがあり、ユーザーがこのアクションを実行した場合、ユーザーの ID、アクションの ID、タイムスタンプを記録し、イベントタイプとして `TAKEN` を記録します。
アクションインタラクションを Amazon Personalize の *Action インタラクションデータセット*にインポートします。アクションインタラクションイベントは、データセットインポートジョブで一括してインポートすることも、[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)
## アクションインタラクションデータの要件
アクションインタラクションデータには最小要件はありません。質の高いアクション推奨のために、このデータをインポートすることをお勧めします。アクションインタラクションデータがない場合は、[PutActionInteractions](API_UBS_PutActionInteractions.md) API オペレーションを使用して空のアクションインタラクションデータセットを作成し、顧客のアクションとのインタラクションを記録できます。
アクションインタラクションデータには、少なくとも次の列が必要です。ユースケースとデータに応じて、さらにカスタム列を追加することができます。
+ USER\_ID — アイテムを操作したユーザーの一意の識別子。すべてのイベントには USER\_ID が必要です。最大長が 256 文字の `string` である必要があります。
+ ACTION\_ID — ユーザーが操作したアイテムの一意の識別子。すべてのイベントにはアイテム ID が必要です。最大長が 256 文字の `string` である必要があります。
+ TIMESTAMP — イベントが発生した時刻 (Unix エポック時間形式、秒単位)。すべてのアクションインタラクションには TIMESTAMP が必要です。詳細については、「[タイムスタンプのデータ](interactions-datasets.md#timestamp-data)」を参照してください。
+ EVENT\_TYPE — アクションが実行されたか、実行されなかったか、または表示されたか。すべてのアクションインタラクションにはイベントタイプが必要です。詳細については、「[イベントタイプデータ](#action-interaction-event-type-data)」を参照してください。
アクションインタラクションデータをインポートするまで、Amazon Personalize はパーソナライズなしのアクションを推奨し、傾向スコアは 0.0 となります。アクションに次のものがあると、アクションにはスコアが表示されます。
+ TAKEN イベントタイプと少なくとも 50 回のアクションインタラクション。
+ NOT\_TAKEN または VIEWED イベントタイプと少なくとも 50 回のアクションインタラクション。
これらのアクションインタラクションは、最新のソリューションバージョントレーニングに存在し、アクションインタラクションデータセットの最新のインタラクションタイムスタンプから 6 週間以内に発生する必要があります。
## イベントタイプデータ
Amazon Personalize では、イベントタイプデータのパターンを使用して、ユーザーが実行する可能性が最も高いアクションを特定できます。例えば、お客様が E メール購読アクション (NOT\_TAKEN イベントタイプで示される) を頻繁に無視する場合、Amazon Personalize は、このタイプのアクションを少なくするようにレコメンデーションを調整することがあります。
アクションインタラクションイベントには、以下のイベントタイプのみを使用できます。Amazon Personalize はこれらのイベントを使用してユーザーについて学習し、次に推奨するアクションを計算します。
+ 実行済み - ユーザーが推奨されるアクションを実行したときの実行済みイベントを記録します。**
+ 未実行 - ユーザーが閲覧後にアクションを実行しないという意図的な選択をした場合に、未実行イベントを記録します。**例えば、ユーザーに対してアクションを表示したときに、ユーザーが*いいえ*を選択した場合です。未実行イベントは、お客様がそのアクションに興味がないことを示している可能性があります。**
+ 閲覧済み - ユーザーがアクションを実行するかしないかの選択をする前にアクションを示したときに、閲覧済みイベントを記録します。**Amazon Personalize は、閲覧イベントを使用してユーザーの関心を学習します。**例えば、ユーザーが表示されたアクションを実行しなかった場合、このユーザーは今後、このアクションに興味を持たなくなる可能性があります。
## アクションインタラクションデータの例
アクションインタラクションデータを含む 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"
}
```