Configuración de un modelo de recomendación en Amazon Pinpoint

Un modelo de recomendación es un tipo de modelo de aprendizaje automático (ML) que está diseñado para predecir lo que un usuario en particular preferirá de un conjunto determinado de productos o elementos. Proporciona esa información como un conjunto de recomendaciones para el usuario. En Amazon Pinpoint, puede utilizar estos modelos para enviar recomendaciones personalizadas a los destinatarios de mensajes en función de los atributos y del comportamiento de cada destinatario.

Antes de poder utilizar un modelo de recomendación de esta manera, debe configurar una conexión entre Amazon Pinpoint y la campaña de Amazon Personalize que tiene el modelo a utilizar. Cuando configure la conexión, especifique cómo desea recuperar y usar las recomendaciones de la campaña de Amazon Personalize. También puede agregar configuraciones para los atributos que almacenan temporalmente las recomendaciones de la campaña.

Antes de empezar

Antes de configurar un modelo de recomendación en Amazon Pinpoint, revise la información en Preparación para usar un modelo de recomendación con Amazon Pinpoint. Esto le ayudará a recopilar los recursos y la información que necesita para configurar el modelo en Amazon Pinpoint.

Paso 1: Configurar el modelo

Para este paso, especifique de qué campaña de Amazon Personalize desea recuperar las recomendaciones. También puede elegir la configuración que especifique cómo desea recuperar y utilizar esas recomendaciones.

Para configurar un modelo de recomendación

1. Abra la consola de Amazon Pinpoint en https://console.aws.amazon.com/pinpoint/.

2. En el panel de navegación, elija Machine learning models (Modelos de aprendizaje automático).

3. En la página Machine learning models (Modelos de aprendizaje automático) seleccione Add recommender model (Agregar modelo de recomendación).

4. En Detalles del modelo, para Nombre del modelo de recomendación, escriba un nombre para el modelo en Amazon Pinpoint. El nombre debe comenzar con una letra o un número. Puede contener un máximo de 128 caracteres. Los caracteres pueden ser letras, números, guiones bajos (_) o guiones (-).

5. (Opcional) En Recommender model description (Descripción del modelo de recomendación), introduzca una breve descripción del modelo. La descripción puede contener hasta 128 caracteres. Los caracteres pueden ser letras, números, espacios o los siguientes símbolos: _ ; () , ‐.

6. En Configuración del modelo, para Rol de IAM, elija el rol de IAM (AWS Identity and Access Management) que autoriza a Amazon Pinpoint a conectarse y recuperar recomendaciones de la campaña de Amazon Personalize que utiliza el modelo. Dispone de las opciones siguientes:

   • Usar un rol existente: elija esta opción para usar un rol de IAM que ya existe para la cuenta de AWS. A continuación, en la lista de roles, elija el rol que desee.

   • Crear automáticamente un rol: elija esta opción para crear automáticamente un rol de IAM que tenga los permisos requeridos. A continuación, especifique un nombre para el rol.

   Otra opción es colaborar con su administrador para crear el rol manualmente. Para obtener información sobre cómo crear el rol manualmente, consulte Rol de IAM para recuperar recomendaciones en la Guía para desarrolladores de Amazon Pinpoint.

7. Para Modelo de recomendación, elija la campaña de Amazon Personalize de la que desee recuperar recomendaciones.

   Esta lista muestra todas las campañas de Amazon Personalize a las que puede acceder con la cuenta de AWS en la región de AWS actual. Si la lista no incluye la campaña que desea, pida al administrador que le dé acceso a la campaña y verifique que ha elegido el rol de IAM correcto en el paso anterior. Además, compruebe que la campaña existe en la región de AWS actual.

8. En Configuración, para Identificador que utilizar para recomendaciones, especifique si desea asociar a usuarios únicos en la campaña de Amazon Personalize con puntos de conexión (ID de punto de conexión) o usuarios (ID de usuario) en los proyectos de Amazon Pinpoint.

9. En Número de recomendaciones por mensaje, elija el número de elementos recomendados que desea recuperar para cada punto de conexión o usuario en los proyectos de Amazon Pinpoint, en función de la elección del paso anterior.

   Esta configuración determina cuántas recomendaciones recupera Amazon Pinpoint y se pueden agregar a mensajes individuales. Puede recuperar hasta cinco elementos recomendados. Si elige 1, Amazon Pinpoint recupera solo el primer elemento de la lista de recomendaciones para cada destinatario de mensajes, por ejemplo, la película más recomendada para un destinatario. Si elige 2, recupera solo el primer y segundo elemento de la lista para cada destinatario, por ejemplo, las dos películas más recomendadas para un destinatario. Y así sucesivamente, para un máximo de cinco recomendaciones.

10. Para Método de procesamiento, elija una de las siguientes opciones para especificar cómo desea que Amazon Pinpoint procese las recomendaciones que recupera:

    • Usar el valor devuelto por el modelo: con esta opción, los mensajes muestran el texto exacto de las recomendaciones que proporciona la campaña de Amazon Personalize. Además, todas las recomendaciones para cada punto de enlace o usuario se almacenan temporalmente en un atributo estándar recomendado para cada punto de enlace o usuario.

    • Utilizar una función de Lambda: con esta opción, los mensajes pueden mostrar recomendaciones mejoradas en lugar o además del texto de las recomendaciones que proporciona la campaña de Amazon Personalize. Si elige esta opción, Amazon Pinpoint envía recomendaciones a una función de AWS Lambda para su procesamiento adicional, antes de que envíe un mensaje que incluya las recomendaciones. Además, puede almacenar temporalmente recomendaciones en hasta 10 atributos recomendados personalizados para cada punto de enlace o usuario.

      Si elige esta opción, utilice también la lista de funciones de Lambda para elegir la función que desee utilizar. Esta lista muestra todas las funciones de Lambda a las que puede acceder con la cuenta de AWS en la región de AWS actual. Si la lista no incluye la función que desea, pida al administrador que le dé acceso a la función. Si la función aún no existe, elija Crear nueva función de Lambda y trabaje con el equipo de desarrollo para crear la función. Para obtener más información, consulte Personalización de las recomendaciones con AWS Lambda en la Guía para desarrolladores de Amazon Pinpoint.

11. Cuando termine de ingresar esta configuración, elija Siguiente para continuar con el siguiente paso: agregar la configuración de atributos para el modelo de recomendación.

Paso 2: Agregar atributos al modelo

Después de elegir la configuración para conectarse y recuperar recomendaciones de la campaña de Amazon Personalize, estará listo para escribir la configuración de los atributos que almacenarán los datos de recomendación. Estas opciones varían en función del método de procesamiento que haya elegido en el paso anterior:

Use the value returned by the model (Utilizar el valor devuelto por el modelo)

Si elige esta opción, las recomendaciones se almacenan temporalmente en un atributo. Se trata de un atributo estándar recomendado para cada punto de enlace o usuario, en función de la opción que haya elegido para el valor Identifier to use for recommendations (Identificador que utilizar para las recomendaciones) en el paso anterior. El nombre subyacente de este atributo es RecommendationItems.

En Display name (Nombre para mostrar), introduzca un nombre descriptivo para el atributo. Este nombre aparecerá en el Attribute finder (Buscador de atributos) del editor de plantillas cuando agregue una variable para el atributo a una plantilla de mensaje. El nombre puede contener hasta 25 caracteres. Los caracteres pueden ser letras, números, espacios, guiones bajos (_) o guiones (-).

Utilizar una función de Lambda

Si elige esta opción, puede usar hasta 10 atributos para almacenar datos para cada recomendación. Estos son atributos recomendados personalizados para cada punto de enlace o usuario, en función de la opción que haya elegido para el valor Identifier to use for recommendations (Identificador que utilizar para las recomendaciones) en el paso anterior. Por ejemplo, si recupera una recomendación de producto para cada punto de conexión o usuario, la función de Lambda puede procesar la recomendación y agregar los resultados a tres atributos personalizados para la recomendación: nombre del producto, precio e imagen.

Para cada atributo personalizado que desee agregar, elija Add attribute (Agregar atributo), y, a continuación, haga lo siguiente:

• En Attribute name (Nombre de atributo), introduzca un nombre para el atributo. Este nombre, precedido por el prefijo Recommendations, aparecerá en el editor de plantillas después de agregar una variable para el atributo a una plantilla de mensaje. El nombre debe coincidir con el nombre de un atributo que la función de Lambda utiliza para almacenar datos de recomendación.

  El nombre de atributo debe comenzar por una letra o un número y puede contener hasta 50 caracteres. Los caracteres pueden ser letras, números, guiones bajos (_) o guiones (-). Los nombres de atributo distinguen entre mayúsculas y minúsculas y deben ser únicos.

• En Display name (Nombre para mostrar), introduzca un nombre descriptivo para el atributo. Este nombre aparecerá en el Attribute finder (Buscador de atributos) del editor de plantillas cuando agregue una variable para el atributo a una plantilla de mensaje. El nombre debe comenzar por una letra o un número y puede contener hasta 25 caracteres. Los caracteres pueden ser letras, números, espacios, guiones bajos (_) o guiones (-).

Cuando termine de ingresar la configuración de atributos, elija Siguiente para continuar con el siguiente paso: revisar y publicar los ajustes de configuración para el modelo de recomendación.

Paso 3: Revisar y publicar el modelo

Una vez que haya terminado de escribir todos los valores para conectarse y utilizar el modelo de recomendación, estará listo para revisar los ajustes.

Cuando termine de revisar la configuración, elija Publicar para guardarla. A continuación, Amazon Pinpoint comprueba la configuración para asegurarse de que es correcta. Si falta algún valor o es incorrecto, muestra un mensaje para cada error que le ayudará a determinar la configuración que se debe corregir. Si necesita corregir una configuración, utilice el panel de navegación para ir directamente a la página que contiene la configuración.

Después de publicar la configuración, puede comenzar a usar recomendaciones en los mensajes.