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

# Amazon Personalize 中的即時動作建議
<a name="get-action-recommendations"></a>

 如果您使用 PersonalIZED\$1ACTIONS 配方，您可以從行銷活動即時取得動作建議。您可以使用 Amazon Personalize 主控台、 AWS Command Line Interface (AWS CLI) 或 AWS SDKs取得動作建議。

**Topics**
+ [動作建議評分的運作方式](#how-action-recommendation-scoring-works)
+ [取得動作建議 （主控台）](#get-action-recommendations-console)
+ [取得動作建議 (AWS CLI)](#get-action-recommendations-cli-example)
+ [取得動作建議AWS SDKs)](#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. 在**測試行銷活動結果**下，輸入您的建議請求詳細資訊。

    如果您在使用者登入之前為他們記錄事件 （匿名使用者），您可以從這些事件提供 `sessionId` 來取得此使用者的建議，就好像是他們的 一樣`userId`。如需記錄匿名使用者事件的詳細資訊，請參閱 [記錄匿名使用者的事件](recording-events.md#recording-anonymous-user-events)。

1. 選擇性地選擇篩選條件。如需詳細資訊，請參閱[篩選建議和使用者客群](filter.md)。

1. 選擇 **Get recommendations (取得建議)**。顯示包含使用者前 5 個建議動作的資料表。

## 取得動作建議 (AWS CLI)
<a name="get-action-recommendations-cli-example"></a>

使用下列程式碼從行銷活動取得動作建議。指定您要取得建議的使用者 ID，以及行銷活動的 Amazon Resource Name (ARN)。

若要變更建議動作的數量，請變更 的值`numResults`。預設為 5 個動作。上限為 100 個動作。

若要依自訂條件篩選動作建議，您可以建立篩選條件並將其套用至`get-action-recommendations`操作。如需詳細資訊，請參閱[篩選建議和使用者客群](filter.md)。

 如果您在使用者登入之前為他們記錄事件 （匿名使用者），您可以從這些事件提供 `sessionId` 來取得此使用者的建議，就好像是他們的 一樣`userId`。如需記錄匿名使用者事件的詳細資訊，請參閱 [記錄匿名使用者的事件](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 SDKs)
<a name="get-action-recommendations-sdk-example"></a>

下列程式碼說明如何從行銷活動取得使用者的 Amazon Personalize 建議。指定您要取得建議的使用者 ID，以及行銷活動的 Amazon Resource Name (ARN)。

若要變更建議動作的數量，請變更 的值`numResults`。預設為 5 個動作。上限為 100 個動作。

若要依自訂條件篩選動作建議，您可以建立篩選條件並將其套用至 [GetActionRecommendations](API_RS_GetActionRecommendations.md) API 請求。如需詳細資訊，請參閱[篩選建議和使用者客群](filter.md)。

 如果您在使用者登入之前為他們記錄事件 （匿名使用者），您可以從這些事件提供 `sessionId` 來取得此使用者的建議，就好像是他們的 一樣`userId`。如需記錄匿名使用者事件的詳細資訊，請參閱 [記錄匿名使用者的事件](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'])
```