Obtener recomendaciones de artículos en tiempo real

Puedes obtener recomendaciones de artículos en tiempo real de un recomendante o de una campaña personalizada de Amazon Personalize con la consola Amazon Personalize, AWS Command Line Interface (AWS CLI), o AWS SDKs.

Obtención de recomendaciones de elementos (consola)

Para obtener recomendaciones con la consola de Amazon Personalize, proporcione la información de la solicitud en la página de detalles de un generador de recomendaciones (grupo de conjuntos de datos de dominio) o una campaña personalizada.

Cómo obtener recomendaciones

1. Abre la consola Amazon Personalize en https://console.aws.amazon.com/personalize/casa e inicia sesión en tu cuenta.

2. Elija el grupo de conjuntos de datos que contenga la campaña o el recomendador que esté utilizando.

3. En el panel de navegación, elija Campañas o Generadores de recomendaciones.

4. Elija la campaña o el recomendador objetivo.

5. En el caso de una campaña, en Probar resultados de la campaña, introduzca los detalles de la solicitud de recomendación en función de la receta que haya utilizado. En el caso de un generador de recomendaciones, elija Probar recomendador e introduzca los detalles de su solicitud de recomendación en función de su caso de uso.

   Si ha registrado eventos para un usuario antes de que iniciara sesión (un usuario anónimo), puede obtener recomendaciones para ese usuario si proporciona el valor sessionId de esos eventos como si fuera su userId. Para obtener más información sobre el registro de eventos para usuarios anónimos, consulte Registro de eventos para usuarios anónimos.

6. Si lo desea, elija un filtro. Para obtener más información, consulte Recomendaciones de filtrado y segmentos de usuarios.

7. Si utiliza metadatos contextuales, proporcione datos para cada contexto. Para cada contexto, introduzca el campo de metadatos para la Clave. Para el Valor, introduzca los datos de contexto. Para obtener más información, consulte Aumento de la relevancia de las recomendaciones con metadatos contextuales.

8. Si ha habilitado los metadatos en las recomendaciones para su campaña o recomendador, en Columnas de conjuntos de datos de elementos, elija las columnas de metadatos que quiera incluir en los resultados de las recomendaciones. Para obtener información sobre cómo habilitar los metadatos para una campaña, consulte Metadatos de los artículos en las recomendaciones. Para obtener información sobre cómo habilitar los metadatos para un recomendador, consulte Habilitar los metadatos en las recomendaciones para un recomendador de dominios en Amazon Personalize.

9. Si desea promocionar un subconjunto de elementos, si lo desea, complete los campos de Promoción. Para obtener más información, consulte Promoción de elementos en las recomendaciones.

10. Elija Obtener recomendaciones. Aparece una tabla con los 25 elementos más recomendados por el usuario. Si utilizas la versión 2 de personalización de usuario, cada artículo recomendado incluye una lista de los motivos por los que se incluyó el artículo en las recomendaciones. Para obtener más información, consulte Motivos de recomendación con la personalización del usuario v2.

Obtener recomendaciones de artículos (AWS CLI)

Utilice el siguiente código para obtener recomendaciones de una campaña. Para obtener recomendaciones de un recomendador, reemplace el parámetro campaign-arn por recommender-arn.

Especifica el ID del usuario para el que quieres recibir recomendaciones y el nombre del recurso de Amazon (ARN) de tu campaña o recomendante. Se muestra una lista de los 10 elementos más recomendados para el usuario. Si utilizas user-Personalization-v2, cada elemento recomendado incluye una lista de los motivos por los que se incluyó el artículo en las recomendaciones. Para obtener más información, consulte Motivos de recomendación con la personalización del usuario v2.

Para cambiar el número de elementos recomendados, cambie el valor de numResults. El valor predeterminado es de 25 elementos. El máximo es de 500 elementos. Si has utilizado una ITEMS receta RELATED _ para configurar la versión de la solución que respalda la campaña, sustituye el user-id parámetro por el identificador del artículo item-id y especifícalo.

Si ha registrado eventos para un usuario antes de que iniciara sesión (un usuario anónimo), puede obtener recomendaciones para ese usuario si proporciona el valor sessionId de esos eventos como si fuera su userId. Para obtener más información sobre el registro de eventos para usuarios anónimos, consulte Registro de eventos para usuarios anónimos.

aws personalize-runtime get-recommendations \
--campaign-arn campaign arn \
--user-id User ID \
--num-results 10

Obtener recomendaciones de artículos (AWS SDKs)

El siguiente código muestra cómo obtener recomendaciones de Amazon Personalize para un usuario a partir de una campaña con la AWS SDKs. Para obtener recomendaciones de un recomendador, reemplace el parámetro campaignArn por recommenderArn.

Especifica el ID del usuario para el que quieres recibir recomendaciones y el nombre del recurso de Amazon (ARN) de tu campaña o recomendante. Se muestra una lista de los 10 elementos más recomendados para el usuario. Si utilizas user-Personalization-v2, cada elemento recomendado incluye una lista de los motivos por los que se incluyó el artículo en las recomendaciones. Para obtener más información, consulte Motivos de recomendación con la personalización del usuario v2.

Para cambiar el número de elementos recomendados, cambie el valor de numResults. El valor predeterminado es de 25 elementos. El máximo es de 500 elementos. Si has utilizado una ITEMS receta RELATED _ para configurar la versión de la solución que respalda la campaña, sustituye el userId parámetro por el identificador del artículo itemId y especifícalo.

Si ha habilitado los metadatos en las recomendaciones para su campaña o recomendador, puede especificar las columnas de metadatos del conjunto de datos de elementos para incluirlas en la respuesta. Para ver una muestra de código, consulte Incluir metadatos de artículos con recomendaciones (AWS SDKs). Para obtener más información acerca de cómo habilitar los metadatos, consulte Metadatos de los artículos en las recomendaciones.

Si ha registrado eventos para un usuario antes de que iniciara sesión (un usuario anónimo), puede obtener recomendaciones para ese usuario si proporciona el valor sessionId de esos eventos como si fuera su userId. Para obtener más información sobre el registro de eventos para usuarios anónimos, consulte Registro de eventos para usuarios anónimos.

SDK for Python (Boto3)

import boto3

personalizeRt = boto3.client('personalize-runtime')

response = personalizeRt.get_recommendations(
    campaignArn = 'Campaign ARN',
    userId = 'User ID',
    numResults = 10
)

print("Recommended items")
for item in response['itemList']:
    print (item['itemId'])

SDK for Java 2.x

    public static void getRecs(PersonalizeRuntimeClient personalizeRuntimeClient, String campaignArn, String userId) {

        try {
            GetRecommendationsRequest recommendationsRequest = GetRecommendationsRequest.builder()
                    .campaignArn(campaignArn)
                    .numResults(20)
                    .userId(userId)
                    .build();

            GetRecommendationsResponse recommendationsResponse = personalizeRuntimeClient
                    .getRecommendations(recommendationsRequest);
            List<PredictedItem> items = recommendationsResponse.itemList();
            for (PredictedItem item : items) {
                System.out.println("Item Id is : " + item.itemId());
                System.out.println("Item score is : " + item.score());
            }

        } catch (AwsServiceException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }

SDK for JavaScript v3

// Get service clients module and commands using ES6 syntax.
import { GetRecommendationsCommand } from
  "@aws-sdk/client-personalize-runtime";

import { personalizeRuntimeClient } from "./libs/personalizeClients.js";
// Or, create the client here.
// const personalizeRuntimeClient = new PersonalizeRuntimeClient({ region: "REGION"});

// Set the recommendation request parameters.
export const getRecommendationsParam = {
  campaignArn: 'CAMPAIGN_ARN', /* required */
  userId: 'USER_ID',      /* required */
  numResults: 15    /* optional */
}

export const run = async () => {
  try {
    const response = await personalizeRuntimeClient.send(new GetRecommendationsCommand(getRecommendationsParam));
    console.log("Success!", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();