Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Getting a personalized ranking (custom resources)

Focus mode
Getting a personalized ranking (custom resources) - Amazon Personalize

A personalized ranking is a list of recommended items that are re-ranked for a specific user. To get personalized rankings, call the GetPersonalizedRanking API operation or get recommendations from a campaign in the console.

Note

The solution backing the campaign must have been created using a recipe of type PERSONALIZED_RANKING. For more information, see Choosing a recipe.

How personalized ranking scoring works

Like the scores returned by the GetRecommendations operation for solutions created with the User-Personalization-v2 and User-Personalization recipes, GetPersonalizedRanking scores sum to 1, but only the input items receive scores and recommendation scores tend to be higher. If an item wasn't present during the latest training, it receives a score of 0.

Mathematically, the scoring function for GetPersonalizedRanking is identical to GetRecommendations, except that it only considers the input items. This means that scores closer to 1 become more likely, as there are fewer other choices to divide up the score:

Depicts the formula used to calculate scores for each item in a ranking.

Personalized-Ranking sample notebook

For a sample Jupyter notebook that shows how to use the Personalized-Ranking recipe see Personalize Ranking Example.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.