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

# Amazon Personalize でのリアルタイムのアクションレコメンデーション
<a name="get-action-recommendations"></a>

 PERSONALIZED\_ACTIONS レシピを使用すると、キャンペーンからアクションレコメンデーションをリアルタイムで取得できます。Amazon Personalize コンソール、AWS Command Line Interface (AWS CLI)、または AWS SDK を使用して、アクションレコメンデーションを取得できます。

**Topics**
+ [アクションレコメンデーションのスコアの仕組み](#how-action-recommendation-scoring-works)
+ [アクションレコメンデーションの取得 (コンソール)](#get-action-recommendations-console)
+ [アクションレコメンデーションの取得 (AWS CLI)](#get-action-recommendations-cli-example)
+ [アクションレコメンデーションの取得 (AWS SDK)](#get-action-recommendations-sdk-example)

## アクションレコメンデーションのスコアの仕組み
<a name="how-action-recommendation-scoring-works"></a>

Next-Best-Action レシピでは、Amazon Personalize はユーザーがアクションを操作する可能性に基づいてアクションのスコアを生成します。スコアは 0～1.0 です。1.0 に近いほど、ユーザーがアクションを操作する可能性が高くなります。

 アクションインタラクションデータをインポートしていない場合、推奨されたすべてのアクションのスコアは 0.0 になります。Amazon Personalize が探索の一環としてアクションを推奨した場合、そのアイテムのスコアは 0.0 になります。**Amazon Personalize は探索機能を使用して、アクションインタラクションデータなしでアクションを推奨します。探索の詳細については、「[探査](use-case-recipe-features.md#about-exploration)」を参照してください。

## アクションレコメンデーションの取得 (コンソール)
<a name="get-action-recommendations-console"></a>

 Amazon Personalize コンソールでアクションレコメンデーションを取得するには、カスタムキャンペーンの詳細ページでリクエスト情報を指定します。

**アクションレコメンデーションを取得するには**

1. [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) で Amazon Personalize コンソールを開き、アカウントにサインインします。

1. 使用しているキャンペーンを含むデータセットグループを選択します。

1. ナビゲーションペインの **[カスタムリソース]** で、**[キャンペーン]** を選択します。

1. ターゲットとなるキャンペーンを選択します。

1. **[キャンペーン結果をテスト]** で、レコメンデーションリクエストの詳細を入力します。

    ユーザーがログインする前にユーザーのイベントを記録した場合 (匿名ユーザー)、`userId` の代わりにそれらのイベントから `sessionId` を指定することにより、このユーザー向けのレコメンデーションを取得できます。匿名ユーザーのイベントの記録の詳細については、「[匿名ユーザー向けのイベントの記録](recording-events.md#recording-anonymous-user-events)」を参照してください。

1. オプションでフィルターを選択します。詳細については、「[レコメンデーションとユーザーセグメントのフィルタリング](filter.md)」を参照してください。

1. **[レコメンデーションの取得]** を選択します。ユーザーの上位 5 個の推奨アクションを含むテーブルが表示されます。

## アクションレコメンデーションの取得 (AWS CLI)
<a name="get-action-recommendations-cli-example"></a>

次のコードを使用して、キャンペーンからアクションレコメンデーションを取得します。レコメンデーションを取得するユーザーの ID と、キャンペーンの Amazon リソースネーム (ARN) を指定します。

推奨アクションの数を変更するには、`numResults` の値を変更します。デフォルトは、5 つのアクションです。最大値は 100 アクションです。

アクションレコメンデーションをカスタム条件でフィルタリングするには、フィルターを作成して、`get-action-recommendations` 操作に適用できます。詳細については、「[レコメンデーションとユーザーセグメントのフィルタリング](filter.md)」を参照してください。

 ユーザーがログインする前にユーザーのイベントを記録した場合 (匿名ユーザー)、`userId` の代わりにそれらのイベントから `sessionId` を指定することにより、このユーザー向けのレコメンデーションを取得できます。匿名ユーザーのイベントの記録の詳細については、「[匿名ユーザー向けのイベントの記録](recording-events.md#recording-anonymous-user-events)」を参照してください。

```
aws personalize-runtime get-action-recommendations \
--campaign-arn {{campaign arn}} \
--user-id {{User ID}} \
--num-results 10
```

## アクションレコメンデーションの取得 (AWS SDK)
<a name="get-action-recommendations-sdk-example"></a>

次のコードは、キャンペーンからユーザー向けの Amazon Personalizeのレコメンデーションを取得する方法を示しています。レコメンデーションを取得するユーザーの ID と、キャンペーンの Amazon リソースネーム (ARN) を指定します。

推奨アクションの数を変更するには、`numResults` の値を変更します。デフォルトは、5 つのアクションです。最大値は 100 アクションです。

アクションレコメンデーションをカスタム条件でフィルタリングするには、フィルターを作成して [GetActionRecommendations](API_RS_GetActionRecommendations.md) API リクエストに適用できます。詳細については、「[レコメンデーションとユーザーセグメントのフィルタリング](filter.md)」を参照してください。

 ユーザーがログインする前にユーザーのイベントを記録した場合 (匿名ユーザー)、`userId` の代わりにそれらのイベントから `sessionId` を指定することにより、このユーザー向けのレコメンデーションを取得できます。匿名ユーザーのイベントの記録の詳細については、「[匿名ユーザー向けのイベントの記録](recording-events.md#recording-anonymous-user-events)」を参照してください。

```
import boto3

personalizeRt = boto3.client('personalize-runtime')

response = personalizeRt.get_action_recommendations(
    campaignArn = '{{Campaign ARN}}',
    userId = '{{User ID}}',
    numResults = 10
)

print("Recommended actions")
for item in response['actionList']:
    print (item['actionId'])
```