Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Déploiement d'une version de la solution Amazon Personalize avec une campagne Pour obtenir des recommandations en temps réel avec des ressources personnalisées, une fois que vous avez terminé[Création manuelle d'une version de solution](creating-a-solution-version.md), vous êtes prêt à déployer la version de votre solution dans le cadre d'une campagne. Une *campagne* déploie une version de solution (modèle entraîné) dotée d'une capacité de transaction provisionnée pour générer des recommandations en temps réel. Après avoir créé une campagne, vous utilisez les opérations de l'[GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)API [GetRecommendations](API_RS_GetRecommendations.md) or pour obtenir des recommandations. Si vous recevez des recommandations d'articles par lots ou des segments d'utilisateurs, vous n'avez pas besoin de créer de campagne. Pour plus d’informations, consultez [Obtenir des recommandations d'articles par lots](getting-batch-recommendations.md) ou [Obtenir des segments d'utilisateurs par lots](getting-user-segments.md). Lorsque vous créez une campagne, vous pouvez configurer les éléments suivants : + Vous pouvez configurer la campagne pour qu'elle soit automatiquement mise à jour afin d'utiliser la dernière version de votre solution. Pour de plus amples informations, veuillez consulter [Mises à jour automatiques des campagnes](#create-campaign-automatic-latest-sv-update). + Vous pouvez activer les métadonnées des éléments dans les recommandations. Pour de plus amples informations, veuillez consulter [Métadonnées des éléments dans les recommandations](#create-campaign-return-metadata). + Vous pouvez spécifier le nombre minimum de transactions provisionnées par seconde pour la campagne. Il s'agit du débit de transaction de référence pour la campagne mise en place par Amazon Personalize. Il définit les frais de facturation minimaux pour la campagne lorsqu'elle est active. Pour de plus amples informations, veuillez consulter [Nombre minimal de transactions provisionnées par seconde et auto-scaling](#min-tps-auto-scaling). Vous pouvez créer une campagne avec la console Amazon Personalize, AWS Command Line Interface (AWS CLI) ou AWS SDKs. Si vous souhaitez modifier les paramètres d'une campagne existante, par exemple en activant les métadonnées dans les recommandations, vous devez mettre à jour votre campagne. Pour de plus amples informations, veuillez consulter [Mettre à jour la configuration d'une campagne Amazon Personalize](update-campaigns.md). Vous engagez des frais de campagne lorsque celle-ci est active. Pour éviter des coûts inutiles, veillez à supprimer la campagne lorsque vous aurez terminé. Pour plus d'informations sur les coûts des campagnes, consultez la section [Tarification d'Amazon Personalize](https://aws.amazon.com/personalize/pricing/). **Topics** + [Mises à jour automatiques des campagnes](#create-campaign-automatic-latest-sv-update) + [Nombre minimal de transactions provisionnées par seconde et auto-scaling](#min-tps-auto-scaling) + [Métadonnées des éléments dans les recommandations](#create-campaign-return-metadata) + [Création d'une campagne (console)](#create-campaign-console) + [Création d'une campagne (AWS CLI)](#create-campaign-cli) + [Création d'une campagne (AWS SDKs)](#create-campaign-sdk) ## Mises à jour automatiques des campagnes Lorsque vous créez une campagne, vous pouvez activer les mises à jour automatiques de la campagne. Grâce aux mises à jour automatiques, la campagne est automatiquement mise à jour pour déployer la dernière version de votre solution entraînée automatiquement ou manuellement. Cela vous permet de tenir votre campagne à jour plus facilement. Par exemple, si votre solution utilise une [formation automatique](solution-config-auto-training.md) pour créer une nouvelle version de solution tous les sept jours, votre campagne sera automatiquement mise à jour pour utiliser la dernière version de la solution pour chaque formation hebdomadaire. Si vous n'utilisez pas les mises à jour automatiques des campagnes, vous devez les mettre à jour manuellement afin de déployer le dernier modèle entraîné. + Pour activer les mises à jour automatiques des campagnes lorsque vous créez une campagne avec la console Amazon Personalize, choisissez **Mettre à jour automatiquement pour utiliser la dernière version de la solution de votre solution** dans les **détails de la campagne**. Vous trouverez l'horodatage de la dernière mise à jour sur la page des détails de la campagne. Pour de plus amples informations, veuillez consulter [Création d'une campagne (console)](#create-campaign-console). + Pour activer les mises à jour automatiques des campagnes lorsque vous utilisez l'opération [CreateCampaign](API_CreateCampaign.md) API, pour le `SolutionVersionArn` paramètre, spécifiez le nom de ressource Amazon (ARN) de votre solution au `SolutionArn/$LATEST` format. Dans le`campaignConfig`, réglez `enableMetadataWithRecommendations` sur`true`. Pour obtenir l'horodatage de la dernière mise à jour de la campagne, vous pouvez utiliser l'opération [DescribeCampaign](API_DescribeCampaign.md) API et vérifier les `latestCampaignUpdate` détails dans la réponse. Pour des exemples de code expliquant comment activer les mises à jour automatiques, consultez [Création d'une campagne (AWS CLI)](#create-campaign-cli) ou[Création d'une campagne (AWS SDKs)](#create-campaign-sdk). ## Nombre minimal de transactions provisionnées par seconde et auto-scaling **Important** Un montant élevé `minProvisionedTPS` augmentera vos coûts. Nous vous recommandons de commencer par 1 pour `minProvisionedTPS` (valeur par défaut). Suivez votre consommation à l'aide CloudWatch des statistiques Amazon et augmentez-les `minProvisionedTPS` si nécessaire. Lorsque vous créez une campagne Amazon Personalize, vous pouvez spécifier le nombre minimum de transactions provisionnées par seconde (`minProvisionedTPS`) pour la campagne. Il s'agit du débit de transaction de référence pour la campagne mise en place par Amazon Personalize. Il définit les frais de facturation minimaux pour la campagne lorsqu'elle est active. Une transaction est une transaction unique `GetRecommendations` ou une `GetPersonalizedRanking` demande. La valeur par défaut `minProvisionedTPS` est 1. Si votre TPS augmente au-delà de`minProvisionedTPS`, Amazon Personalize redimensionne automatiquement la capacité allouée à la hausse ou à la baisse, mais jamais en dessous. `minProvisionedTPS` Il y a un court délai pendant lequel la capacité augmente, ce qui peut entraîner une perte de transactions. Lorsque votre trafic diminue, la capacité revient au`minProvisionedTPS`. Vous êtes facturé pour le TPS minimum fourni ou, si vos demandes dépassent le`minProvisionedTPS`, le TPS réel. Le TPS réel est le nombre total de demandes de recommandation que vous faites. Nous vous recommandons de commencer par un faible`minProvisionedTPS`, de suivre votre consommation à l'aide CloudWatch des statistiques Amazon, puis de l'`minProvisionedTPS`augmenter si nécessaire. Pour plus d'informations sur les coûts des campagnes, consultez la section [Tarification d'Amazon Personalize](https://aws.amazon.com/personalize/pricing/). ## Métadonnées des éléments dans les recommandations **Important** Si vous utilisez la recette User-Personalization-v 2 ou Personalized-Ranking-v 2, vous n'avez pas à payer de frais supplémentaires pour les métadonnées. Pour toutes les autres recettes et tous les cas d'utilisation du domaine, des frais supplémentaires vous seront facturés. Pour plus d'informations, consultez les [tarifs d'Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Lorsque vous recevez des recommandations, vous pouvez demander à Amazon Personalize d'inclure les métadonnées des articles dans les résultats des recommandations. Dans votre demande, vous pouvez choisir les colonnes à inclure dans votre jeu de données Items. Amazon Personalize renvoie ces données pour chaque article dans la réponse de recommandation. Vous pouvez utiliser les métadonnées pour enrichir les recommandations dans votre interface utilisateur, par exemple en ajoutant les genres de films aux carrousels. Vous pouvez également l'utiliser pour évaluer visuellement la qualité des recommandations. Si vous utilisez l'IA générative dans votre application, vous pouvez intégrer les métadonnées aux instructions de l'IA pour générer un contenu plus pertinent. Pour plus d'informations sur l'utilisation d'Amazon Personalize avec l'IA générative, consultez[Amazon Personalize et l'IA générative](personalize-with-gen-ai.md). ### Activation des métadonnées Pour ajouter des métadonnées aux recommandations, vous devez disposer d'un jeu de données Items avec une colonne de métadonnées. Vous n'êtes pas obligé d'utiliser les métadonnées lors de l'entraînement. Pour plus d'informations sur la création d'un jeu de données, consultez[Création d'un schéma et d'un jeu de données](data-prep-creating-datasets.md). Pour plus d'informations sur la mise à jour des données, consultez[Mise à jour des données dans les ensembles de données après l'entraînement](updating-datasets.md). Si vous utilisez la formule User-Personalization-v 2 ou Personalized-Ranking-v 2, les nouvelles campagnes ont automatiquement la possibilité d'inclure les métadonnées des articles dans les résultats des recommandations. Vous n'avez pas activé manuellement les métadonnées pour votre campagne. Pour toutes les autres recettes et cas d'utilisation du domaine, vous devez activer l'option de métadonnées : + Pour activer les métadonnées avec la console Amazon Personalize, lorsque vous créez la campagne, sélectionnez **Retourner les métadonnées des articles dans les résultats des recommandations** dans les **détails de la campagne**. Pour de plus amples informations, veuillez consulter [Création d'une campagne (console)](#create-campaign-console). + Pour activer les métadonnées avec le AWS SDKs ou AWS CLI, utilisez l'opération [CreateCampaign](API_CreateCampaign.md) API et dans le `campaignConfig` set `enableMetadataWithRecommendations` to`true`. Pour plus d’informations, consultez [Création d'une campagne (AWS CLI)](#create-campaign-cli) ou [Création d'une campagne (AWS SDKs)](#create-campaign-sdk). ## Création d'une campagne (console) **Important** Vous engagez des frais de campagne lorsque celle-ci est active. Pour éviter des coûts inutiles, veillez à supprimer la campagne lorsque vous aurez terminé. Pour plus d'informations sur les coûts des campagnes, consultez la section [Tarification d'Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Une fois que le statut de la version de votre solution est actif, vous êtes prêt à la déployer dans le cadre d'une campagne Amazon Personalize. **Pour créer une campagne (console)** 1. Ouvrez la console Amazon Personalize [https://console.aws.amazon.com/personalize/chez](https://console.aws.amazon.com/personalize/home) vous et connectez-vous à votre compte. 1. Choisissez le groupe de jeux de données contenant la version de solution que vous souhaitez déployer. 1. Dans le volet de navigation, sous **Ressources personnalisées**, sélectionnez **Campagnes**. 1. Sur la page **Campagnes**, choisissez **Créer une campagne**. 1. Sur la page **Créer une nouvelle campagne**, pour les **détails de la campagne**, fournissez les informations suivantes : + **Nom de la campagne** — Entrez le nom de la campagne. Le texte que vous saisissez ici apparaît sur le tableau de bord et la page de détails de la campagne. + **Solution** — Choisissez la solution que vous venez de créer. + **Mise à jour automatique pour utiliser la dernière version de la solution de votre** solution : choisissez cette option pour que la campagne utilise automatiquement la dernière version active de la solution. Si vous ne choisissez pas cette option, vous devez mettre à jour manuellement la campagne chaque fois que vous souhaitez déployer une nouvelle version de solution. Pour de plus amples informations, veuillez consulter [Mises à jour automatiques des campagnes](#create-campaign-automatic-latest-sv-update). + **ID de version de la solution** : si vous n'utilisez pas les mises à jour automatiques des campagnes pour utiliser la dernière version de la solution, choisissez l'ID de la version de solution que vous souhaitez déployer. + **Minimum de transactions provisionnées par seconde (appelé MinProvisionedTPS in APIs) : définissez le nombre minimum de transactions provisionnées par seconde prises en** charge par Amazon Personalize. Une valeur élevée augmentera vos frais. Nous vous recommandons de commencer par 1 (valeur par défaut). Suivez votre consommation à l'aide CloudWatch des statistiques Amazon et augmentez-les `minProvisionedTPS` si nécessaire. Pour de plus amples informations, veuillez consulter [Nombre minimal de transactions provisionnées par seconde et auto-scaling](#min-tps-auto-scaling). + **Renvoyer les métadonnées des éléments dans les résultats des recommandations** : choisissez cette option si vous souhaitez inclure les métadonnées dans les résultats des recommandations. Si cette option est activée, vous pouvez spécifier les colonnes de votre jeu de données Items lorsque vous recevez des recommandations. Pour de plus amples informations, veuillez consulter [Métadonnées des éléments dans les recommandations](#create-campaign-return-metadata). 1. Si vous avez utilisé la recette de personnalisation par l'utilisateur, dans la **configuration de la campagne**, vous pouvez éventuellement saisir des valeurs pour le **poids d'exploration** et la limite d'**âge des objets d'exploration.** Pour de plus amples informations, veuillez consulter [Personnalisation par l'utilisateur](native-recipe-new-item-USER_PERSONALIZATION.md). 1. Pour les **balises**, ajoutez éventuellement des balises. Pour plus d'informations sur le balisage des ressources Amazon Personalize, consultez[Marquer les ressources Amazon Personalize](tagging-resources.md). 1. Choisissez **Create campaign (Créer une campagne)**. 1. Sur la page des détails de la campagne, lorsque le statut de la campagne est **Actif**, vous pouvez utiliser la campagne pour obtenir des recommandations et enregistrer des impressions. Pour de plus amples informations, veuillez consulter [Obtenir des recommandations d'Amazon Personalize](getting-recommendations.md). La campagne est prête lorsque son statut est ACTIF. Si vous modifiez la version de votre solution ou si vous souhaitez modifier les paramètres de votre campagne, vous devez mettre à jour votre campagne. Pour de plus amples informations, veuillez consulter [Mettre à jour la configuration d'une campagne Amazon Personalize](update-campaigns.md). ## Création d'une campagne (AWS CLI) **Important** Vous engagez des frais de campagne lorsque celle-ci est active. Pour éviter des coûts inutiles, veillez à supprimer la campagne lorsque vous aurez terminé. Pour plus d'informations sur les coûts des campagnes, consultez la section [Tarification d'Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Une fois que la version de votre solution est active, vous êtes prêt à la déployer dans le cadre d'une campagne Amazon Personalize. Pour créer une campagne avec le AWS CLI, vous devez utiliser la `create-campaign` commande. L'exemple de code suivant vous montre comment créer une campagne. Il déploie la dernière version d'une solution qui utilise la recette de personnalisation utilisateur. La campagne qu'il crée est automatiquement mise à jour pour utiliser les futures versions de la solution. Le code utilise la configuration suivante : + Il configure la campagne pour qu'elle soit automatiquement mise à jour afin d'utiliser la dernière version de la solution pour votre solution : elle `solution-version-arn` est au `{{solution ARN}}/$LATEST` format, et elle l'`syncWithLatestSolutionVersion`est`True`. Pour utiliser le code, remplacez-le `solution ARN` par le Amazon Resource Name (ARN) de votre solution. Pour désactiver la fonction automatique`syncWithLatestSolutionVersion`, spécifiez uniquement l'ARN de la version de la solution (sans`/$LATEST`) et définissez `syncWithLatestSolutionVersion` sur`False`. + Il définit l'`enableMetadataWithRecommendations`option sur`True`. Cela permet à une option de demande de recommandation d'inclure les métadonnées d'un élément d'un jeu de données d'articles avec les résultats des recommandations. Pour désactiver cette option, définissez-la sur`False`. Pour de plus amples informations, veuillez consulter [Métadonnées des éléments dans les recommandations](#create-campaign-return-metadata). + Il est défini `min-provisioned-tps` sur 1 (valeur par défaut). Nous vous recommandons de commencer par 1 pour `minProvisionedTPS` (valeur par défaut). Suivez votre consommation à l'aide CloudWatch des statistiques Amazon et augmentez-les `minProvisionedTPS` si nécessaire. Pour de plus amples informations, veuillez consulter [Nombre minimal de transactions provisionnées par seconde et auto-scaling](#min-tps-auto-scaling). Pour obtenir la liste complète de tous les paramètres, voir[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 campagne est prête lorsque son statut est ACTIF. Pour obtenir l'état actuel, appelez l'API [DescribeCampaign](API_DescribeCampaign.md) et vérifiez que le champ `status` est `ACTIVE`. Si vous modifiez la version de votre solution et que votre campagne n'est pas automatiquement mise à jour pour utiliser la dernière version de la solution, ou si vous souhaitez modifier les paramètres de votre campagne, vous devez mettre à jour votre campagne. Pour de plus amples informations, veuillez consulter [Mettre à jour la configuration d'une campagne Amazon Personalize](update-campaigns.md). Amazon Personalize vous propose des opérations de gestion de campagnes, telles que [ListCampaigns](API_ListCampaigns.md) la liste des campagnes que vous avez créées. Vous pouvez supprimer une campagne en appelant l'API [DeleteCampaign](API_DeleteCampaign.md). Si vous supprimez une campagne, les versions des solutions qui font partie de cette campagne ne sont pas supprimées. Après avoir créé votre campagne, vous pouvez l'utiliser pour faire des recommandations. Pour de plus amples informations, veuillez consulter [Obtenir des recommandations d'Amazon Personalize](getting-recommendations.md). ## Création d'une campagne (AWS SDKs) **Important** Vous engagez des frais de campagne lorsque celle-ci est active. Pour éviter des coûts inutiles, veillez à supprimer la campagne lorsque vous aurez terminé. Pour plus d'informations sur les coûts des campagnes, consultez la section [Tarification d'Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Une fois que la version de votre solution est active, vous êtes prêt à la déployer dans le cadre d'une campagne Amazon Personalize. Pour créer une campagne avec AWS SDKs, vous devez utiliser l'opération [CreateCampaign](API_CreateCampaign.md) API. L'exemple de code suivant vous montre comment créer une campagne. Le code déploie la dernière version d'une solution qui utilise la recette de personnalisation utilisateur. La campagne qu'il crée est automatiquement mise à jour pour utiliser les futures versions de la solution. Le code utilise la configuration suivante : + Il configure la campagne pour qu'elle soit automatiquement mise à jour afin d'utiliser la dernière version de la solution pour votre solution : elle `solutionVersionArn` est au `{{solution ARN}}/$LATEST` format, et elle l'`syncWithLatestSolutionVersion`est`True`. Pour utiliser le code, remplacez-le `solution ARN` par le Amazon Resource Name (ARN) de la version de votre solution. Pour désactiver la fonction automatique`syncWithLatestSolutionVersion`, spécifiez uniquement l'ARN de la version de la solution (sans`/$LATEST`) et définissez `syncWithLatestSolutionVersion` sur`False`. + Il définit l'`enableMetadataWithRecommendations`option sur`True`. Cela permet à une option de demande de recommandation d'inclure les métadonnées d'un élément d'un jeu de données d'articles avec les résultats des recommandations. Pour désactiver cette option, définissez-la sur`False`. Pour de plus amples informations, veuillez consulter [Métadonnées des éléments dans les recommandations](#create-campaign-return-metadata). + Il est défini `minProvisionedTPS` sur 1 (valeur par défaut). Nous vous recommandons de commencer par 1 pour `minProvisionedTPS` (valeur par défaut). Suivez votre consommation à l'aide CloudWatch des statistiques Amazon et augmentez-les `minProvisionedTPS` si nécessaire. Pour de plus amples informations, veuillez consulter [Nombre minimal de transactions provisionnées par seconde et auto-scaling](#min-tps-auto-scaling). Pour obtenir la liste complète de tous les paramètres, voir[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 campagne est prête lorsque son statut est ACTIF. Pour connaître le statut actuel[DescribeCampaign](API_DescribeCampaign.md), appelez et vérifiez que le `status` champ est bien renseigné`ACTIVE`. Si vous modifiez manuellement la version de votre solution ou si vous souhaitez modifier les paramètres de votre campagne, vous devez mettre à jour votre campagne. Pour de plus amples informations, veuillez consulter [Mettre à jour la configuration d'une campagne Amazon Personalize](update-campaigns.md). Amazon Personalize vous propose des opérations de gestion de campagnes, telles que [ListCampaigns](API_ListCampaigns.md) la liste des campagnes que vous avez créées. Vous pouvez supprimer une campagne en appelant l'API [DeleteCampaign](API_DeleteCampaign.md). Si vous supprimez une campagne, les versions des solutions qui font partie de cette campagne ne sont pas supprimées. Une fois que vous avez créé votre campagne, utilisez-la pour effectuer des recommandations. Pour de plus amples informations, veuillez consulter [Obtenir des recommandations d'Amazon Personalize](getting-recommendations.md).