Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
GetPersonalizedRanking
Cambia el orden de una lista de elementos recomendados para un usuario determinado. Se considera que el primer elemento de la lista es el que puede ser el más interesante para el usuario.
nota
La solución relacionada con la campaña se debe haber creado utilizando una receta del tipo PERSONALIZED_RANKING.
Sintaxis de la solicitud
POST /personalize-ranking HTTP/1.1
Content-type: application/json
{
"campaignArn": "string",
"context": {
"string" : "string"
},
"filterArn": "string",
"filterValues": {
"string" : "string"
},
"inputList": [ "string" ],
"metadataColumns": {
"string" : [ "string" ]
},
"userId": "string"
}Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- campaignArn
-
El nombre de recurso de Amazon (ARN) de la campaña que se va a utilizar para generar la clasificación personalizada.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatorio: sí
- context
-
Los metadatos contextuales que se utilizarán para obtener recomendaciones. Los metadatos contextuales incluyen cualquier información de interacción que pueda ser relevante a la hora de obtener las recomendaciones de un usuario, como la ubicación actual del usuario o el tipo de dispositivo.
Tipo: mapa de cadena a cadena
Entradas de mapa: número máximo de 150 elementos.
Limitaciones de longitud de clave: longitud máxima de 150 caracteres.
Patrón de clave:
[A-Za-z\d_]+Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.
Obligatorio: no
- filterArn
-
El nombre de recurso de Amazon (ARN) de un filtro que ha creado para incluir o excluir elementos de las recomendaciones para un usuario determinado. Para obtener más información, consulte Filtrado de recomendaciones.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatorio: no
- filterValues
-
Los valores que se van a utilizar al filtrar las recomendaciones. Para cada parámetro de marcador de posición de la expresión de filtro, proporcione el nombre del parámetro (respetando mayúsculas y minúsculas) como clave y los valores del filtro como valor correspondiente. Separe los valores múltiples de un parámetro con una coma.
En el caso de las expresiones de filtro que utilizan un elemento
INCLUDEpara incluir elementos, debe proporcionar valores para todos los parámetros definidos en la expresión. En el caso de los filtros con expresiones que utilizan un objetoEXCLUDEpara excluir elementos, puede omitir la expresiónfilter-values. En este caso, Amazon Personalize no utiliza esa parte de la expresión para filtrar recomendaciones.Para obtener más información, consulte Filtrado de recomendaciones.
Tipo: mapa de cadena a cadena
Entradas de mapa: número máximo de 25 elementos.
Limitaciones de longitud de clave: longitud máxima de 50 caracteres.
Patrón de clave:
[A-Za-z0-9_]+Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.
Obligatorio: no
- inputList
-
Una lista de elementos (por
itemId) para clasificar. Si un elemento no estaba incluido en el conjunto de datos de entrenamiento, se añade al final de la lista reclasificada. Si incluye metadatos en las recomendaciones, el máximo es 50. De lo contrario, el máximo es 500.Tipo: matriz de cadenas
Limitaciones de longitud: longitud máxima de 256 caracteres.
Obligatorio: sí
- metadataColumns
-
Si ha habilitado los metadatos en las recomendaciones al crear o actualizar la campaña, especifique las columnas de metadatos del conjunto de datos de elementos que se van a incluir en la clasificación personalizada. La clave de asignación es
ITEMSy el valor es una lista de nombres de columnas de su conjunto de datos de elementos. El número máximo de columnas que puede proporcionar es 10.Para obtener información sobre cómo habilitar los metadatos para una campaña, consulte Habilitación de los metadatos en las recomendaciones para una campaña.
Tipo: mapa de cadena a matriz de cadenas
Entradas de mapa: número máximo de 1 elemento.
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.
Miembros de la matriz: número máximo de 99 elementos.
Limitaciones de longitud: longitud máxima de 150 caracteres.
Obligatorio: no
- userId
-
El usuario para el que quiere que la campaña proporcione una clasificación personalizada.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256 caracteres.
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"personalizedRanking": [
{
"itemId": "string",
"metadata": {
"string" : "string"
},
"promotionName": "string",
"reason": [ "string" ],
"score": number
}
],
"recommendationId": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- personalizedRanking
-
Una lista de elementos por orden de interés más probable para el usuario. El máximo es 500.
Tipo: matriz de objetos PredictedItem
- recommendationId
-
El identificador de la recomendación.
Tipo: cadena
Errores
- InvalidInputException
-
Proporcione un valor válido para el campo o el parámetro.
Código de estado HTTP: 400
- ResourceNotFoundException
-
El recurso especificado no existe.
Código de estado HTTP: 404
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
