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.
# Implementación de una versión de solución de Amazon Personalize con una campaña
Para obtener recomendaciones en tiempo real con recursos personalizados, una vez finalizada [Creación manual de una versión de solución](creating-a-solution-version.md), estará listo para implementar la versión de la solución con una campaña.
Una *campaña* implementa una versión de la solución (modelo entrenado) con una capacidad de transacción aprovisionada para generar recomendaciones en tiempo real. Después de crear una campaña, puede utilizar las operaciones de la API de [GetRecommendations](API_RS_GetRecommendations.md) o [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) para obtener recomendaciones. Si recibe recomendaciones de elementos o de segmentos de usuarios por lotes, no es necesario que cree una campaña. Para obtener más información, consulte [Obtención de recomendaciones de elemento por lotes](getting-batch-recommendations.md) o [Obtención de segmentos de usuarios por lotes](getting-user-segments.md).
Al crear una campaña, puede configurar lo siguiente:
+ Puede configurar la campaña para que se actualice automáticamente y utilice la versión de solución más reciente. Para obtener más información consulte () [Actualizaciones de campaña automáticas](#create-campaign-automatic-latest-sv-update).
+ Puede habilitar los metadatos de elemento en las recomendaciones. Para obtener más información, consulte [Metadatos de elemento en las recomendaciones](#create-campaign-return-metadata).
+ Puede especificar el número mínimo de transacciones aprovisionadas por segundo para la campaña. Este es el rendimiento de transacciones de línea base para la campaña aprovisionada por Amazon Personalize. Establece el cargo de facturación mínimo de la campaña mientras esté activa. Para obtener más información, consulte [Transacciones mínimas aprovisionadas por segundo y escalado automático](#min-tps-auto-scaling).
Puede crear una campaña con la consola de Amazon Personalize, la AWS Command Line Interface (AWS CLI) o los SDK de AWS. Si desea cambiar la configuración de una campaña existente, por ejemplo, habilitar los metadatos en las recomendaciones, debe actualizar la campaña. Para obtener más información, consulte [Actualización de la configuración de una campaña de Amazon Personalize](update-campaigns.md).
Generará costos de campaña mientras la campaña esté activa. Para evitar costos innecesarios, asegúrese de eliminar la campaña cuando haya terminado. Para obtener información sobre los costos de campaña, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
**Topics**
+ [Actualizaciones de campaña automáticas](#create-campaign-automatic-latest-sv-update)
+ [Transacciones mínimas aprovisionadas por segundo y escalado automático](#min-tps-auto-scaling)
+ [Metadatos de elemento en las recomendaciones](#create-campaign-return-metadata)
+ [Crear una campaña (consola)](#create-campaign-console)
+ [Creación de una campaña (AWS CLI)](#create-campaign-cli)
+ [Creación de una campaña (SDK de AWS)](#create-campaign-sdk)
## Actualizaciones de campaña automáticas
Al crear una campaña, puede habilitar las actualizaciones de campaña automáticas. Con las actualizaciones automáticas, la campaña se actualiza automáticamente para implementar la última versión de solución entrenada de forma automática o manual. Esto le facilita la actualización de la campaña.
Por ejemplo, si la solución usa el [entrenamiento automático](solution-config-auto-training.md) para crear una nueva versión de solución cada siete días, la campaña se actualizará automáticamente para usar la última versión de solución en cada entrenamiento semanal. Si no utiliza las actualizaciones de campaña automáticas, debe actualizarla manualmente para implementar el modelo entrenado más reciente.
+ Para habilitar las actualizaciones de campaña automáticas al crear una campaña con la consola de Amazon Personalize, elija **Actualizar automáticamente para usar la última versión de solución de la solución** en los **Detalles de la campaña**. Puede encontrar la marca horaria de la última actualización en la página de detalles de la campaña.
Para obtener más información, consulte [Crear una campaña (consola)](#create-campaign-console).
+ Para habilitar las actualizaciones de campaña automáticas cuando utilice la operación de la API [CreateCampaign](API_CreateCampaign.md), especifique el formato `SolutionArn/$LATEST` del nombre de recurso de Amazon (ARN) de la solución para el parámetro `SolutionVersionArn`. En `campaignConfig`, establezca `enableMetadataWithRecommendations` en `true`.
Para obtener la marca temporal de la última actualización de campaña, puede utilizar la operación de la API [DescribeCampaign](API_DescribeCampaign.md) y comprobar los detalles de `latestCampaignUpdate` en la respuesta.
Para ver muestras de código que presentan cómo activar las actualizaciones automáticas, consulte [Creación de una campaña (AWS CLI)](#create-campaign-cli) o [Creación de una campaña (SDK de AWS)](#create-campaign-sdk).
## Transacciones mínimas aprovisionadas por segundo y escalado automático
**importante**
Un valor elevado de `minProvisionedTPS` aumentará los costos. Le recomendamos empezar con 1 para `minProvisionedTPS` (el valor predeterminado). Realice un seguimiento de su uso mediante las métricas de Amazon CloudWatch y aumente el valor de `minProvisionedTPS` según sea necesario.
Al crear una campaña de Amazon Personalize, puede especificar el número mínimo de transacciones aprovisionadas por segundo (`minProvisionedTPS`) para la campaña. Este es el rendimiento de transacciones de línea base para la campaña aprovisionada por Amazon Personalize. Establece el cargo de facturación mínimo de la campaña mientras esté activa. Una transacción es una solicitud `GetRecommendations` o `GetPersonalizedRanking` simple. El valor predeterminado de `minProvisionedTPS` es 1.
Si su TPS aumenta más de `minProvisionedTPS`, Amazon Personalize escala automáticamente la capacidad aprovisionada hacia arriba y hacia abajo, pero nunca por debajo de `minProvisionedTPS`. Se produce un breve retraso durante el aumento de la capacidad que podría provocar la pérdida de transacciones. Cuando se reduce el tráfico, la capacidad vuelve al valor de `minProvisionedTPS`.
Se le cobrará el valor de TPS aprovisionado mínimo o, si las solicitudes superan el valor de `minProvisionedTPS`, el TPS real. El TPS real es el número total de solicitudes de recomendación que realiza. Recomendamos empezar con un nivel bajo de `minProvisionedTPS`, realizar un seguimiento del uso mediante las métricas de Amazon CloudWatch y, a continuación, aumentar el `minProvisionedTPS` según sea necesario.
Para obtener más información sobre los costos de las campañas, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
## Metadatos de elemento en las recomendaciones
**importante**
Si usa la receta User-Personalization-v2 o Personalized-Ranking-v2, no generará costos adicionales por los metadatos. Para el resto de las recetas y todos los casos de uso de dominio, se generan costos adicionales. Para obtener más información, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Cuando reciba recomendaciones, puede hacer que Amazon Personalize incluya metadatos de elemento en los resultados de las recomendaciones. En la solicitud, puede elegir las columnas del conjunto de datos de elementos que se incluirán. Amazon Personalize devuelve estos datos para cada elemento en la respuesta a la recomendación.
Puede usar metadatos para enriquecer las recomendaciones de la interfaz de usuario, por ejemplo, agregar los géneros de las películas a los carruseles. También puede usarlos para evaluar la calidad de las recomendaciones de manera visual. Si usa IA generativa en la aplicación, puede conectar los metadatos a las indicaciones de la IA a fin de generar contenido más relevante. Para obtener más información sobre el uso de Amazon Personalize con la IA generativa, consulte [Amazon Personalize y la IA generativa](personalize-with-gen-ai.md).
### Habilitación de metadatos
Para agregar metadatos a las recomendaciones, debe tener un conjunto de datos de elementos con una columna de metadatos. No es necesario usar los metadatos en el entrenamiento. Para obtener información sobre cómo crear un conjunto de datos, consulte [Creación de un esquema y un conjunto de datos](data-prep-creating-datasets.md). Para obtener información sobre la actualización de datos, consulte [Actualización de datos en conjuntos de datos después del entrenamiento](updating-datasets.md).
Si utiliza la receta User-Personalization-v2 o Personalized-Ranking-v2, las nuevas campañas tienen automáticamente la opción de incluir los metadatos de elemento con los resultados de las recomendaciones. No tiene que activar manualmente los metadatos de la campaña. Para el resto de las recetas y casos de uso de dominio, debes habilitar la opción de metadatos:
+ Para habilitar los metadatos con la consola de Amazon Personalize, al crear la campaña, seleccione **Devolver metadatos de los elementos en los resultados de las recomendaciones** en **Detalles de la campaña**. Para obtener más información, consulte [Crear una campaña (consola)](#create-campaign-console).
+ Para habilitar los metadatos con los SDK de AWS o la AWS CLI, use la operación de API [CreateCampaign](API_CreateCampaign.md) y en `campaignConfig` establezca `enableMetadataWithRecommendations` en `true`. Para obtener más información, consulte [Creación de una campaña (AWS CLI)](#create-campaign-cli) o [Creación de una campaña (SDK de AWS)](#create-campaign-sdk).
## Crear una campaña (consola)
**importante**
Generará costos de campaña mientras la campaña esté activa. Para evitar costos innecesarios, asegúrese de eliminar la campaña cuando haya terminado. Para obtener información sobre los costos de campaña, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Cuando el estado de la versión de la solución sea Activo, ya puede implementarla con una campaña de Amazon Personalize.
**Para crear una campaña (consola)**
1. Abra la consola de Amazon Personalize en [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) e inicie sesión en su cuenta.
1. Elija el grupo de conjuntos de datos con la versión de solución que desea implementar.
1. En el panel de navegación, en **Recursos personalizados**, elija **Campañas**.
1. En la pestaña **Campañas**, elija **Crear campaña**.
1. En la página **Crear nueva campaña**, en los **Detalles de la campaña**, proporcione la siguiente información:
+ **Nombre de la campaña**: escriba el nombre de la campaña. El texto que escriba aquí aparecerá en el panel Campaña y en la página de detalles.
+ **Solución**: elija la solución que acaba de crear.
+ **Actualizar automáticamente para usar la última versión de solución de la solución**: elija esta opción para que la campaña use automáticamente la última versión de solución activa. Si no elige esta opción, debe actualizar manualmente la campaña cada vez que desee implementar una nueva versión de solución. Para obtener más información, consulte [Actualizaciones de campaña automáticas](#create-campaign-automatic-latest-sv-update).
+ **ID de versión de solución**: si no utiliza las actualizaciones de campaña automáticas para usar la versión de solución más reciente, elija el ID de la versión de solución que desea implementar.
+ **Mínimo de transacciones aprovisionadas por segundo (denominadas minProvisionedTPS en las API)**: defina el mínimo de transacciones aprovisionadas por segundo que admite Amazon Personalize. Un valor elevado aumentará los gastos. Le recomendamos que comience con 1 (el valor predeterminado). Realice un seguimiento del uso mediante las métricas de Amazon CloudWatch y aumente el valor de `minProvisionedTPS` según sea necesario. Para obtener más información, consulte [Transacciones mínimas aprovisionadas por segundo y escalado automático](#min-tps-auto-scaling).
+ **Devolver metadatos de elementos en los resultados de recomendaciones**: elija esta opción si desea incluir los metadatos en los resultados de recomendaciones. Si está habilitada esta opción, puede especificar las columnas del conjunto de datos de elementos cuando reciba recomendaciones. Para obtener más información, consulte [Metadatos de elemento en las recomendaciones](#create-campaign-return-metadata).
1. Si ha utilizado la receta User-Personalization, en **Configuración de la campaña**, si lo desea, puede especificar valores para **Ponderación de exploración** y **Límite de antigüedad de los elementos de exploración**. Para obtener más información, consulte [User-Personalization](native-recipe-new-item-USER_PERSONALIZATION.md).
1. Para **Etiquetas**, si lo desea, añada cualquier etiqueta. Para obtener más información acerca del etiquetado de recursos de Amazon Personalize, consulte [Etiquetado de recursos de Amazon Personalize](tagging-resources.md).
1. Elija **Crear una campaña**.
1. En la página de detalles de la campaña, cuando el estado de la campaña es **Activo**, puede utilizarla para obtener recomendaciones y registrar las impresiones. Para obtener más información, consulte [Obtención de recomendaciones de Amazon Personalize](getting-recommendations.md).
La campaña estará lista cuando su estado sea ACTIVO. Si vuelve a entrenar la versión de solución o desea cambiar la configuración de la campaña, debe actualizarla. Para obtener más información, consulte [Actualización de la configuración de una campaña de Amazon Personalize](update-campaigns.md).
## Creación de una campaña (AWS CLI)
**importante**
Generará costos de campaña mientras la campaña esté activa. Para evitar costos innecesarios, asegúrese de eliminar la campaña cuando haya terminado. Para obtener información sobre los costos de campaña, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Cuando el estado de la versión de solución sea Activo, podrá implementarla con una campaña de Amazon Personalize. Para crear una campaña con la AWS CLI, utilice el comando `create-campaign`.
En la siguiente muestra de código se presenta cómo crear una campaña. Implementa la última versión de solución de una solución que utiliza la receta User-Personalization. La campaña que crea se actualiza automáticamente para usar futuras versiones de solución. El código utiliza la siguiente configuración:
+ Configura la campaña para que se actualice automáticamente y utilice la versión de solución más reciente: `solution-version-arn` está en formato `solution ARN/$LATEST` y `syncWithLatestSolutionVersion` es `True`. Para utilizar el código, reemplace `solution ARN` por el nombre de recurso de Amazon (ARN) de la solución.
Para deshabilitar el valor automático de `syncWithLatestSolutionVersion`, especifique únicamente el ARN de la versión de solución (sin `/$LATEST`) y establezca `syncWithLatestSolutionVersion` en `False`.
+ Establece la opción `enableMetadataWithRecommendations` en `True`. Esto permite que una opción de solicitud de recomendación incluya los metadatos de elemento del conjunto de datos de elementos en los resultados de las recomendaciones. Para deshabilitar esta opción, establézcala a `False`. Para obtener más información, consulte [Metadatos de elemento en las recomendaciones](#create-campaign-return-metadata).
+ Establece `min-provisioned-tps` en 1 (el valor predeterminado). Le recomendamos empezar con 1 para `minProvisionedTPS` (el valor predeterminado). Realice un seguimiento del uso mediante las métricas de Amazon CloudWatch y aumente el valor de `minProvisionedTPS` según sea necesario. Para obtener más información, consulte [Transacciones mínimas aprovisionadas por segundo y escalado automático](#min-tps-auto-scaling).
Para obtener una lista completa de todos los parámetros, consulte [CreateCampaign](API_CreateCampaign.md).
```
aws personalize create-campaign \
--name campaign-name \
--solution-version-arn solution-arn/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"
```
La campaña estará lista cuando su estado sea ACTIVO. Para obtener el estado actual de la campaña, llame a [DescribeCampaign](API_DescribeCampaign.md) y compruebe que el valor de la propiedad `status` es `ACTIVE`.
Si vuelve a entrenar la versión de solución y la campaña no se actualiza automáticamente para usar la última versión de solución, o si desea cambiar la configuración de la campaña, debe actualizarla. Para obtener más información, consulte [Actualización de la configuración de una campaña de Amazon Personalize](update-campaigns.md).
Amazon Personalize le proporciona operaciones para administrar las campañas como, por ejemplo, [ListCampaigns](API_ListCampaigns.md) para obtener una lista de las campañas que ha creado. Puede eliminar una campaña llamando a [DeleteCampaign](API_DeleteCampaign.md). Si elimina una campaña, las versiones de solución que forman parte de la campaña no se eliminan.
Una vez que haya creado la campaña, puede utilizarla para realizar recomendaciones. Para obtener más información, consulte [Obtención de recomendaciones de Amazon Personalize](getting-recommendations.md).
## Creación de una campaña (SDK de AWS)
**importante**
Generará costos de campaña mientras la campaña esté activa. Para evitar costos innecesarios, asegúrese de eliminar la campaña cuando haya terminado. Para obtener información sobre los costos de campaña, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Cuando el estado de la versión de solución sea Activo, podrá implementarla con una campaña de Amazon Personalize. Para crear una campaña con los SDK de AWS, utilice la operación de la API [CreateCampaign](API_CreateCampaign.md).
En la siguiente muestra de código se presenta cómo crear una campaña. El código implementa la última versión de solución de una solución que utiliza la receta User-Personalization. La campaña que crea se actualiza automáticamente para usar futuras versiones de solución. El código utiliza la siguiente configuración:
+ Configura la campaña para que se actualice automáticamente y utilice la versión de solución más reciente: `solutionVersionArn` está en formato `solution ARN/$LATEST` y `syncWithLatestSolutionVersion` es `True`. Para usar el código, reemplace `solution ARN` por el nombre de recurso de Amazon (ARN) de la versión de solución.
Para deshabilitar el valor automático de `syncWithLatestSolutionVersion`, especifique únicamente el ARN de la versión de solución (sin `/$LATEST`) y establezca `syncWithLatestSolutionVersion` en `False`.
+ Establece la opción `enableMetadataWithRecommendations` en `True`. Esto permite que una opción de solicitud de recomendación incluya los metadatos de elemento del conjunto de datos de elementos en los resultados de las recomendaciones. Para deshabilitar esta opción, establézcala a `False`. Para obtener más información, consulte [Metadatos de elemento en las recomendaciones](#create-campaign-return-metadata).
+ Establece `minProvisionedTPS` en 1 (el valor predeterminado). Le recomendamos que comience con 1 para `minProvisionedTPS` (el valor predeterminado). Realice un seguimiento del uso mediante las métricas de Amazon CloudWatch y aumente el valor de `minProvisionedTPS` según sea necesario. Para obtener más información, consulte [Transacciones mínimas aprovisionadas por segundo y escalado automático](#min-tps-auto-scaling).
Para obtener una lista completa de todos los parámetros, consulte [CreateCampaign](API_CreateCampaign.md).
------
#### [ SDK for Python (Boto3) ]
```
import boto3
personalize = boto3.client('personalize')
response = personalize.create_campaign(
name = 'campaign name',
solutionVersionArn = 'solution ARN/$LATEST',
minProvisionedTPS = 1,
campaignConfig = {"syncWithLatestSolutionVersion": True, "enableMetadataWithRecommendations": True}
)
arn = response['campaignArn']
description = personalize.describe_campaign(campaignArn = arn)['campaign']
print('Name: ' + description['name'])
print('ARN: ' + description['campaignArn'])
print('Status: ' + description['status'])
```
------
#### [ SDK for JavaScript v3 ]
```
// Get service clients module and commands using ES6 syntax.
import { CreateCampaignCommand, PersonalizeClient } from
"@aws-sdk/client-personalize";
// create personalizeClient
const personalizeClient = new PersonalizeClient({ region: "REGION" });
// set the campaign parameters
export const createCampaignParam = {
solutionVersionArn: "SOLUTION_ARN/$LATEST" /* required */,
name: "NAME" /* required */,
minProvisionedTPS: 1 /* optional */,
campaignConfig: { /* optional */
syncWithLatestSolutionVersion: true,
enableMetadataWithRecommendations: true,
},
};
export const run = async () => {
try {
const response = await personalizeClient.send(
new CreateCampaignCommand(createCampaignParam)
);
console.log("Success", response);
return response; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
------
La campaña estará lista cuando su estado sea ACTIVO. Para obtener el estado actual, llame a [DescribeCampaign](API_DescribeCampaign.md) y compruebe que el valor del campo `status` es `ACTIVE`.
Si vuelve a entrenar manualmente la versión de solución o si desea cambiar la configuración de la campaña, debe actualizarla. Para obtener más información, consulte [Actualización de la configuración de una campaña de Amazon Personalize](update-campaigns.md).
Amazon Personalize le proporciona operaciones para administrar las campañas como, por ejemplo, [ListCampaigns](API_ListCampaigns.md) para obtener una lista de las campañas que ha creado. Puede eliminar una campaña llamando a [DeleteCampaign](API_DeleteCampaign.md). Si elimina una campaña, las versiones de solución que forman parte de la campaña no se eliminan.
Una vez que haya creado su campaña, utilícela para realizar recomendaciones. Para obtener más información, consulte [Obtención de recomendaciones de Amazon Personalize](getting-recommendations.md).