GetPersonalizedRanking - Amazon Personalize

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

GetPersonalizedRanking

特定のユーザーに推奨されるアイテムのリストを再ランク付けします。リストの最初のアイテムは、ユーザーが関心を持つ可能性が最も高いアイテムとみなされます。

注記

キャンペーンにデプロイするソリューションが PERSONALIZED_RANKING タイプのレシピを使用して作成済みであることが必要です。

リクエストの構文

POST /personalize-ranking HTTP/1.1 Content-type: application/json { "campaignArn": "string", "context": { "string" : "string" }, "filterArn": "string", "filterValues": { "string" : "string" }, "inputList": [ "string" ], "userId": "string" }

URI リクエストパラメータ

リクエストでは URI パラメータを使用しません。

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

campaignArn

パーソナライズされたランキングの生成に使用するキャンペーンの Amazon リソースネーム (ARN)。

Type: 文字列

長さの制約: 最大長は 256 です。

パターン: arn:([a-z\d-]+):personalize:.*:.*:.+

必須: はい

context

レコメンデーションを取得するときに使用するコンテキストメタデータ。コンテキストメタデータには、ユーザーの現在の場所やデバイスタイプなど、ユーザーのレコメンデーションを取得するときに関連する可能性のあるインタラクション情報が含まれます。

Type: 文字列から文字列へのマッピング

マップエントリ: 最大数は 150 項目です。

キーの長さの制約: 最大長は 150 です。

キーパターン: [A-Za-z\d_]+

値の長さの制約: 最大長は 1,000 です。

必須: いいえ

filterArn

特定のユーザーのレコメンデーションからアイテムを含めたり、アイテムを除外したりするために作成したフィルターの Amazon リソースネーム (ARN)。詳細については、「レコメンデーションのフィルタリング」を参照してください。

Type: 文字列

長さの制約: 最大長は 256 です。

パターン: arn:([a-z\d-]+):personalize:.*:.*:.+

必須: いいえ

filterValues

レコメンデーションをフィルタリングするときに使用する値。フィルター式の各プレースホルダーパラメータについて、(大文字と小文字が一致した状態で) パラメータ名をキーとして指定し、フィルター値を対応する値として指定します。1 つのパラメータの複数の値をコンマで区切ります。

INCLUDE 要素を使用してアイテムを含めるフィルター式について、式で定義されているすべてのパラメータの値を指定する必要があります。EXCLUDE 要素を使用してアイテムを除外する式を含むフィルターについては、filter-values を省略できます。この場合、Amazon Personalize は、レコメンデーションをフィルタリングするために式のその部分を使用しません。

詳細については、「レコメンデーションのフィルタリング」を参照してください。

Type: 文字列から文字列へのマッピング

マップエントリ: 最大数は 25 項目です。

キーの長さの制約: 最大長は 50 です。

キーパターン: [A-Za-z0-9_]+

値の長さの制約: 最大長は 1,000 です。

必須: いいえ

inputList

ランク付けするアイテムのリスト (itemId による)。アイテムがトレーニングデータセットに含まれていなかった場合、そのアイテムは再ランク付けされたリストの最後に追加されます。最大数は 500 です。

Type: 文字列の配列

長さの制約: 最大長は 256 です。

必須: はい

userId

キャンペーンによるパーソナライズされたランキングの提供先とするユーザー。

Type: 文字列

長さの制約: 最大長は 256 です。

必須: はい

レスポンスの構文

HTTP/1.1 200 Content-type: application/json { "personalizedRanking": [ { "itemId": "string", "promotionName": "string", "score": number } ], "recommendationId": "string" }

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

personalizedRanking

アイテムのリスト (ユーザーが関心を持つ可能性が最も高い順)。最大数は 500 です。

Type: 配列PredictedItemオブジェクト

recommendationId

レコメンデーションの ID。

Type: 文字列

エラー

InvalidInputException

フィールドまたはパラメータに有効な値を指定します。

HTTP ステータスコード: 400

ResourceNotFoundException

指定されたリソースは存在しません。

HTTP ステータスコード: 404

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。