Amazon Personalize Runtime Update: This release adds support for a Reason attribute for predicted items generated by User-Personalization-v2.

Author: AWS

.changes/next-release/feature-AmazonPersonalizeRuntime-15d1692.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "Amazon Personalize Runtime",
+    "contributor": "",
+    "description": "This release adds support for a Reason attribute for predicted items generated by User-Personalization-v2."
+}

services/personalizeruntime/src/main/resources/codegen-resources/service-2.json

@@ -5,6 +5,7 @@
     "endpointPrefix":"personalize-runtime",
     "jsonVersion":"1.1",
     "protocol":"rest-json",
+    "protocols":["rest-json"],
     "serviceFullName":"Amazon Personalize Runtime",
     "serviceId":"Personalize Runtime",
     "signatureVersion":"v4",
@@ -293,7 +294,8 @@
     "Metadata":{
       "type":"map",
       "key":{"shape":"ColumnName"},
-      "value":{"shape":"ColumnValue"}
+      "value":{"shape":"ColumnValue"},
+      "sensitive":true
     },
     "MetadataColumns":{
       "type":"map",
@@ -348,6 +350,10 @@
         "metadata":{
           "shape":"Metadata",
           "documentation":"<p>Metadata about the item from your Items dataset.</p>"
+        },
+        "reason":{
+          "shape":"ReasonList",
+          "documentation":"<p>If you use User-Personalization-v2, a list of reasons for why the item was included in recommendations. Possible reasons include the following:</p> <ul> <li> <p>Promoted item - Indicates the item was included as part of a promotion that you applied in your recommendation request.</p> </li> <li> <p>Exploration - Indicates the item was included with exploration. With exploration, recommendations include items with less interactions data or relevance for the user. For more information about exploration, see <a href=\"https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#about-exploration\">Exploration</a>.</p> </li> <li> <p> Popular item - Indicates the item was included as a placeholder popular item. If you use a filter, depending on how many recommendations the filter removes, Amazon Personalize might add placeholder items to meet the <code>numResults</code> for your recommendation request. These items are popular items, based on interactions data, that satisfy your filter criteria. They don't have a relevance score for the user. </p> </li> </ul>"
         }
       },
       "documentation":"<p>An object that identifies an item.</p> <p>The and APIs return a list of <code>PredictedItem</code>s.</p>"
@@ -379,6 +385,14 @@
       "member":{"shape":"Promotion"},
       "max":1
     },
+    "Reason":{
+      "type":"string",
+      "max":256
+    },
+    "ReasonList":{
+      "type":"list",
+      "member":{"shape":"Reason"}
+    },
     "RecommendationID":{"type":"string"},
     "ResourceNotFoundException":{
       "type":"structure",