アクションの個別のインポート

スキーマとデータセットの作成 を完了して Actions データセットを作成したら、1 つ以上の新しいアクションをデータセットに個別にインポートできます。アクションを個別インポートすると、カタログの拡大に合わせて Actions データセットを小さなバッチインポートで最新の状態に保つことができます。一度に最大 10 のアクションをインポートできます。新しいアクションが大量にある場合は、最初にデータを一括でインポートしてから、必要に応じてアクションデータを個別にインポートすることをお勧めします。「データセットのインポートジョブを使用して Amazon Personalize にバルクデータをインポートする」を参照してください。

Amazon Personalize コンソール、 AWS Command Line Interface (AWS CLI）、または AWS SDKs アクションをインポートする 。Actions データセットに既に存在するアクションと同じ actionId でアクションをインポートすると、Amazon Personalize はそのアクションを新しいアクションに置き換えます。

新しいレコードがレコメンデーションにどのように影響するかについては、「トレーニング後のデータセットのデータの更新」を参照してください。

アクションの個別インポート (コンソール)

一度に最大 10 個のアクションを Actions データセットにインポートできます。このセクションでは、Actions データセットが既に作成されていることを前提としています。データセットの作成については、「スキーマとデータセットの作成」を参照してください。

アクションを個別にインポートするには (コンソール)

1. https://console.aws.amazon.com/personalize/自宅の Amazon Personalize コンソールを開き、アカウントにサインインします。

2. [データセットグループ] ページで、追加する Actions データセットを含むデータセットグループを選択します。

3. ナビゲーションペインで、[データセット] を選択します。

4. [データセット] ページで、Actions データセットを選択します。

5. データセットの詳細のページの右上で、[Modify dataset] (データセットを変更) を選択し、[Create record] (レコードを作成) を選択します。

6. アクションレコードの作成ページ (レコード入力 ) に、アクションの詳細を JSON形式で入力します。アクションのフィールドの名前と値は、Actions データセットを作成したときに使用したスキーマと一致する必要があります。Amazon Personalize は、このスキーマのフィールド名とデータ型を含むJSONテンプレートを提供します。

7. [Create record(s)] (レコードを作成) を選択します。[レスポンス] では、インポートの結果が一覧表示され、成功または失敗のメッセージが表示されます。

アクションを個別にインポートする (AWS CLI)

PutActions API オペレーションを使用して、1 つ以上のアクションを Actions データセットに追加します。一度に最大 10 個のアクションをインポートできます。このセクションでは、Actions データセットが既に作成されていることを前提としています。データセットの作成については、「スキーマとデータセットの作成」を参照してください。

次のput-actionsコマンドを使用して、 で 1 つ以上のアクションを追加します。 AWS CLI。 をデータセットの Amazon リソースネーム (ARN) dataset arnに、 をアクションの ID actionId に置き換えます。同じ actionId を持つアクションが既に Actions データセットにある場合、Amazon Personalize はそれを新しいものに置き換えます。

properties の場合、Actions データセットの各フィールドについて、propertyName を、スキーマのフィールド名 (キャメルケース) に置き換えます。例えば、ACTION_EXPIRATION_TIMESTAMP は actionExpirationTimestamp、CREATION_TIMESTAMP は になりますcreationTimestamp。property data をプロパティのデータに置き換えます。

aws personalize-events put-actions \
  --dataset-arn dataset arn \
  --actions '[{
      "actionId": "actionId", 
      "properties": "{\"propertyName\": "\property data\"}" 
    }, 
    {
      "actionId": "actionId", 
      "properties": "{\"propertyName\": "\property data\"}" 
    }]'

アクションを個別にインポートする (AWS SDKs)

PutActions オペレーションを使用して、1 つ以上のアクションを Actions データセットに追加します。1 回の PutActions 呼び出しで最大 10 のアクションをインポートできます。同じ actionId を持つアクションが既に Actions データセットにある場合、Amazon Personalize はそれを新しいものに置き換えます。このセクションでは、Actions データセットが既に作成されていることを前提としています。データセットの作成については、「スキーマとデータセットの作成」を参照してください。

次のコードは、1 つ以上のアクションを Actions データセットに追加する方法を示しています。アクションごとに、actionId を指定します。同じ actionId を持つアクションが既に Actions データセットにある場合、Amazon Personalize はそれを新しいものに置き換えます。properties の場合、Actions データセットの各追加フィールドについて、propertyName を、スキーマのフィールド名 (キャメルケース) に置き換えます。例えば、ACTION_EXPIRATION_TIMESTAMP は actionExpirationTimestamp、CREATION_TIMESTAMP は になりますcreationTimestamp。property data をプロパティのデータに置き換えます。

import boto3

personalize_events = boto3.client(service_name='personalize-events')

personalize_events.put_actions(
    datasetArn = 'dataset arn',
    actions = [{
      'actionId': 'actionId',
      'properties': "{\"propertyName\": \"property value\"}"   
      },
      {
      'actionId': 'actionId',
      'properties': "{\"propertyName\": \"property value\"}"   
      }]
)