Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Implementazione di una versione della soluzione Amazon Personalize con una campagna
Per ricevere consigli in tempo reale con risorse personalizzate, una volta completata l'operazione[Creazione manuale di una versione della soluzione](creating-a-solution-version.md), sei pronto a distribuire la versione della soluzione con una campagna.
Una *campagna* implementa una versione della soluzione (modello addestrato) con una capacità di transazione predisposta per generare consigli in tempo reale. Dopo aver creato una campagna, utilizzi le operazioni [GetRecommendations](API_RS_GetRecommendations.md) o le [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) API per ottenere consigli. Se ricevi consigli su articoli in batch o segmenti di utenti, non è necessario creare una campagna. Per ulteriori informazioni, consulta [Ottenere consigli sugli articoli in batch](getting-batch-recommendations.md) o [Ottenere segmenti di utenti in batch](getting-user-segments.md).
Quando crei una campagna, puoi configurare quanto segue:
+ Puoi configurare la campagna in modo che si aggiorni automaticamente per utilizzare la versione più recente della soluzione. Per ulteriori informazioni, consulta [Aggiornamenti automatici delle campagne](#create-campaign-automatic-latest-sv-update).
+ Puoi abilitare i metadati degli articoli nei consigli. Per ulteriori informazioni, consulta [Metadati degli articoli nei consigli](#create-campaign-return-metadata).
+ Puoi specificare il numero minimo di transazioni assegnate al secondo per la campagna. Questo è il throughput di transazione di base per la campagna fornita da Amazon Personalize. Imposta il costo minimo di fatturazione per la campagna mentre è attiva. Per ulteriori informazioni, consulta [Transazioni con provisioning minimo al secondo e auto-scaling](#min-tps-auto-scaling).
Puoi creare una campagna con la console Amazon Personalize, AWS Command Line Interface (AWS CLI) o. AWS SDKs Se desideri modificare le impostazioni di una campagna esistente, ad esempio abilitando i metadati nei consigli, devi aggiornare la campagna. Per ulteriori informazioni, consulta [Aggiornamento della configurazione di una campagna Amazon Personalize](update-campaigns.md).
I costi della campagna sono a tuo carico mentre la campagna è attiva. Per evitare costi inutili, assicurati di eliminare la campagna quando hai finito. Per informazioni sui costi delle campagne, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
**Topics**
+ [Aggiornamenti automatici delle campagne](#create-campaign-automatic-latest-sv-update)
+ [Transazioni con provisioning minimo al secondo e auto-scaling](#min-tps-auto-scaling)
+ [Metadati degli articoli nei consigli](#create-campaign-return-metadata)
+ [Creazione di una campagna (console)](#create-campaign-console)
+ [Creare una campagna ()AWS CLI](#create-campaign-cli)
+ [Creazione di una campagna (AWS SDKs)](#create-campaign-sdk)
## Aggiornamenti automatici delle campagne
Quando crei una campagna, puoi abilitare gli aggiornamenti automatici della campagna. Con gli aggiornamenti automatici, la campagna si aggiorna automaticamente per distribuire la versione più recente della soluzione, addestrata automaticamente o manualmente. In questo modo è più facile mantenere aggiornata la campagna.
Ad esempio, se la soluzione utilizza la [formazione automatica](solution-config-auto-training.md) per creare una nuova versione della soluzione ogni sette giorni, la campagna si aggiornerà automaticamente per utilizzare la versione più recente della soluzione per ogni formazione settimanale. Se non utilizzi gli aggiornamenti automatici della campagna, devi aggiornare manualmente la campagna per implementare il modello addestrato più recente.
+ Per abilitare gli aggiornamenti automatici delle campagne quando crei una campagna con la console Amazon Personalize, scegli **Aggiorna automaticamente per utilizzare la versione più recente della soluzione nei dettagli** della **campagna**. Puoi trovare il timestamp dell'ultimo aggiornamento nella pagina dei dettagli della campagna.
Per ulteriori informazioni, consulta [Creazione di una campagna (console)](#create-campaign-console).
+ Per abilitare gli aggiornamenti automatici delle campagne quando utilizzi l'operazione [CreateCampaign](API_CreateCampaign.md) API, specifica il `SolutionVersionArn` formato Amazon Resource Name (ARN) della tua soluzione per il parametro. `SolutionArn/$LATEST` Nel`campaignConfig`, imposta su`enableMetadataWithRecommendations`. `true`
Per ottenere il timestamp dell'ultimo aggiornamento della campagna, puoi utilizzare l'operazione [DescribeCampaign](API_DescribeCampaign.md) API e controllare `latestCampaignUpdate` i dettagli nella risposta.
Per esempi di codice che mostrano come abilitare gli aggiornamenti automatici, consulta [Creare una campagna ()AWS CLI](#create-campaign-cli) o. [Creazione di una campagna (AWS SDKs)](#create-campaign-sdk)
## Transazioni con provisioning minimo al secondo e auto-scaling
**Importante**
Un massimo `minProvisionedTPS` aumenterà i costi. Ti consigliamo di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali se necessario.
Quando crei una campagna Amazon Personalize, puoi specificare il numero minimo di transazioni assegnate al secondo (`minProvisionedTPS`) per la campagna. Questo è il throughput di transazione di base per la campagna fornita da Amazon Personalize. Imposta il costo minimo di fatturazione per la campagna mentre è attiva. Una transazione è una singola `GetRecommendations` `GetPersonalizedRanking` richiesta. L'impostazione predefinita `minProvisionedTPS` è 1.
Se il tuo TPS supera il limite`minProvisionedTPS`, Amazon Personalize ridimensiona automaticamente la capacità assegnata verso l'alto e verso il basso, ma mai al di sotto. `minProvisionedTPS` Si verifica un breve ritardo nell'aumento della capacità che potrebbe causare la perdita delle transazioni. Quando il traffico diminuisce, la capacità torna a`minProvisionedTPS`.
Ti viene addebitato il TPS minimo fornito o, se le tue richieste superano il`minProvisionedTPS`, il TPS effettivo. Il TPS effettivo è il numero totale di richieste di raccomandazione effettuate. Ti consigliamo di iniziare con un valore minimo`minProvisionedTPS`, di monitorare l'utilizzo utilizzando i CloudWatch parametri di Amazon e quindi di aumentarlo `minProvisionedTPS` se necessario.
Per ulteriori informazioni sui costi delle campagne, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
## Metadati degli articoli nei consigli
**Importante**
Se utilizzi la ricetta User-Personalization-v 2 o Personalized-Ranking-v 2, non dovrai sostenere costi aggiuntivi per i metadati. Per tutte le altre ricette e tutti i casi d'uso del dominio, sono previsti costi aggiuntivi. Per ulteriori informazioni, consulta i [prezzi di Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Quando ricevi consigli, puoi fare in modo che Amazon Personalize includa i metadati degli articoli nei risultati dei consigli. Nella richiesta, puoi scegliere le colonne del set di dati Items da includere. Amazon Personalize restituisce questi dati per ogni articolo nella risposta alla raccomandazione.
Puoi utilizzare i metadati per arricchire i consigli nella tua interfaccia utente, ad esempio per aggiungere i generi dei film ai caroselli. Oppure puoi utilizzarli per valutare visivamente la qualità dei consigli. Se utilizzi l'intelligenza artificiale generativa nella tua app, puoi collegare i metadati ai prompt dell'intelligenza artificiale per generare contenuti più pertinenti. Per ulteriori informazioni sull'utilizzo di Amazon Personalize con l'intelligenza artificiale generativa, consulta. [Amazon Personalize e AI generativa](personalize-with-gen-ai.md)
### Abilitazione dei metadati
Per aggiungere metadati ai consigli, devi disporre di un set di dati Items con una colonna di metadati. Non è necessario utilizzare i metadati durante la formazione. Per informazioni sulla creazione di un set di dati, consulta. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md) Per informazioni sull'aggiornamento dei dati, vedere[Aggiornamento dei dati nei set di dati dopo l'allenamento](updating-datasets.md).
Se utilizzi la ricetta User-Personalization-v 2 o Personalized-Ranking-v 2, le nuove campagne hanno automaticamente la possibilità di includere i metadati degli articoli nei risultati delle raccomandazioni. Non hai abilitato manualmente i metadati per la tua campagna. Per tutte le altre ricette e casi d'uso del dominio, devi abilitare l'opzione dei metadati:
+ **Per abilitare i metadati con la console Amazon Personalize, quando crei la campagna, **scegli Restituisci i metadati degli articoli nei risultati delle raccomandazioni nei dettagli** della campagna.** Per ulteriori informazioni, consulta [Creazione di una campagna (console)](#create-campaign-console).
+ Per abilitare i metadati con AWS SDKs o AWS CLI, utilizza l'operazione [CreateCampaign](API_CreateCampaign.md) API e l'impostazione è impostata su. `campaignConfig` `enableMetadataWithRecommendations` `true` Per ulteriori informazioni, consulta [Creare una campagna ()AWS CLI](#create-campaign-cli) o [Creazione di una campagna (AWS SDKs)](#create-campaign-sdk).
## Creazione di una campagna (console)
**Importante**
Ti vengono addebitati i costi della campagna mentre la campagna è attiva. Per evitare costi inutili, assicurati di eliminare la campagna quando hai finito. Per informazioni sui costi delle campagne, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Una volta che lo stato della versione della soluzione è Attivo, sei pronto per distribuirla con una campagna Amazon Personalize.
**Per creare una campagna (console)**
1. Apri la console Amazon Personalize da [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e accedi al tuo account.
1. Scegli il gruppo di set di dati con la versione della soluzione che desideri distribuire.
1. **Nel riquadro di navigazione, in **Risorse personalizzate**, scegli Campagne.**
1. Nella pagina **Campagne**, scegli **Crea campagna**.
1. Nella pagina **Crea nuova campagna**, per **i dettagli della campagna**, fornisci le seguenti informazioni:
+ **Nome della campagna**: inserisci il nome della campagna. Il testo che inserisci qui viene visualizzato nella dashboard e nella pagina dei dettagli della campagna.
+ **Soluzione**: scegli la soluzione che hai appena creato.
+ **Aggiorna automaticamente per utilizzare la versione più recente della soluzione**: scegli questa opzione per fare in modo che la campagna utilizzi automaticamente l'ultima versione attiva della soluzione. Se non scegli questa opzione, devi aggiornare manualmente la campagna ogni volta che desideri implementare una nuova versione della soluzione. Per ulteriori informazioni, consulta [Aggiornamenti automatici delle campagne](#create-campaign-automatic-latest-sv-update).
+ **ID della versione della soluzione**: se non utilizzi gli aggiornamenti automatici della campagna per utilizzare la versione più recente della soluzione, scegli l'ID della versione della soluzione che desideri distribuire.
+ **Transazioni con provisioned minime al secondo (chiamate minProvisionedTPS in APIs)**: imposta le transazioni con provisioning minimo al secondo supportate da Amazon Personalize. Un valore elevato aumenterà i costi. Ti consigliamo di iniziare con 1 (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali se necessario. Per ulteriori informazioni, consulta [Transazioni con provisioning minimo al secondo e auto-scaling](#min-tps-auto-scaling).
+ **Restituisci i metadati degli articoli nei risultati dei consigli**: scegli questa opzione se desideri includere i metadati nei risultati dei consigli. Se abilitata, puoi specificare le colonne del set di dati Items quando ricevi consigli. Per ulteriori informazioni, consulta [Metadati degli articoli nei consigli](#create-campaign-return-metadata).
1. Se hai utilizzato la ricetta User-Personalization, nella **configurazione di Campaign** puoi facoltativamente inserire i valori per il **peso dell'esplorazione e l'età massima per gli articoli **Exploration****. Per ulteriori informazioni, consulta [Personalizzazione dell'utente](native-recipe-new-item-USER_PERSONALIZATION.md).
1. Per i **tag, aggiungi facoltativamente qualsiasi tag**. Per ulteriori informazioni sull'etichettatura delle risorse Amazon Personalize, consulta. [Etichettare le risorse di Amazon Personalize](tagging-resources.md)
1. Scegliere **Create campaign (Crea campagna)**.
1. Nella pagina dei dettagli della campagna, quando lo stato della campagna è **Attivo**, puoi utilizzare la campagna per ottenere consigli e registrare impressioni. Per ulteriori informazioni, consulta [Ricevere consigli da Amazon Personalize](getting-recommendations.md).
La campagna è pronta quando il suo stato è ATTIVO. Se riqualifichi la versione della soluzione o se desideri modificare le impostazioni della campagna, devi aggiornare la campagna. Per ulteriori informazioni, consulta [Aggiornamento della configurazione di una campagna Amazon Personalize](update-campaigns.md).
## Creare una campagna ()AWS CLI
**Importante**
Ti vengono addebitati i costi della campagna mentre la campagna è attiva. Per evitare costi inutili, assicurati di eliminare la campagna quando hai finito. Per informazioni sui costi delle campagne, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Una volta che la versione della soluzione è attiva, sei pronto per distribuirla con una campagna Amazon Personalize. Per creare una campagna con AWS CLI, usa il `create-campaign` comando.
Il seguente esempio di codice mostra come creare una campagna. Implementa la versione più recente di una soluzione che utilizza la ricetta di personalizzazione degli utenti. La campagna che crea si aggiorna automaticamente per utilizzare le versioni future della soluzione. Il codice utilizza la seguente configurazione:
+ Configura la campagna in modo che si aggiorni automaticamente per utilizzare la versione più recente della soluzione: `solution-version-arn` è in `{{solution ARN}}/$LATEST` formato ed `syncWithLatestSolutionVersion` è`True`. Per utilizzare il codice, sostituiscilo `solution ARN` con l'Amazon Resource Name (ARN) della tua soluzione.
Per disabilitare l'automatico`syncWithLatestSolutionVersion`, specificate solo la versione della soluzione ARN (senza`/$LATEST`) e `syncWithLatestSolutionVersion` impostatela su. `False`
+ Imposta l'`enableMetadataWithRecommendations`opzione su. `True` Ciò consente a un'opzione di richiesta di raccomandazione di includere i metadati degli elementi da un set di dati Items con i risultati dei consigli. Per disabilitare questa opzione, impostala su. `False` Per ulteriori informazioni, consulta [Metadati degli articoli nei consigli](#create-campaign-return-metadata).
+ È `min-provisioned-tps` impostata su 1 (impostazione predefinita). Si consiglia di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali se necessario. Per ulteriori informazioni, consulta [Transazioni con provisioning minimo al secondo e auto-scaling](#min-tps-auto-scaling).
Per un elenco completo di tutti i parametri, consulta[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 campagna è pronta quando il suo stato è ATTIVO. Per ottenere lo stato corrente, chiamare l'operazione [DescribeCampaign](API_DescribeCampaign.md) e verificare che il campo `status` sia `ACTIVE`.
Se riqualifichi la versione della soluzione e la campagna non si aggiorna automaticamente per utilizzare la versione più recente della soluzione o se desideri modificare le impostazioni della campagna, devi aggiornare la campagna. Per ulteriori informazioni, consulta [Aggiornamento della configurazione di una campagna Amazon Personalize](update-campaigns.md).
Amazon Personalize ti fornisce le operazioni per la gestione delle campagne, ad esempio [ListCampaigns](API_ListCampaigns.md) elencare le campagne che hai creato. È possibile eliminare una campagna chiamando l'operazione [DeleteCampaign](API_DeleteCampaign.md). Se si elimina una campagna, le versioni delle soluzioni che ne fanno parte non vengono eliminate.
Dopo aver creato la tua campagna, puoi usarla per formulare consigli. Per ulteriori informazioni, consulta [Ricevere consigli da Amazon Personalize](getting-recommendations.md).
## Creazione di una campagna (AWS SDKs)
**Importante**
Ti vengono addebitati i costi della campagna mentre la campagna è attiva. Per evitare costi inutili, assicurati di eliminare la campagna quando hai finito. Per informazioni sui costi delle campagne, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Una volta che la versione della soluzione è attiva, sei pronto per distribuirla con una campagna Amazon Personalize. Per creare una campagna con AWS SDKs, usi l'operazione [CreateCampaign](API_CreateCampaign.md) API.
Il seguente esempio di codice mostra come creare una campagna. Il codice implementa la versione più recente di una soluzione che utilizza la ricetta di personalizzazione degli utenti. La campagna che crea si aggiorna automaticamente per utilizzare le versioni future della soluzione. Il codice utilizza la seguente configurazione:
+ Configura la campagna in modo che si aggiorni automaticamente per utilizzare la versione più recente della soluzione: `solutionVersionArn` è in `{{solution ARN}}/$LATEST` formato ed `syncWithLatestSolutionVersion` è`True`. Per utilizzare il codice, sostituiscilo `solution ARN` con l'Amazon Resource Name (ARN) della versione della soluzione.
Per disabilitare l'automatico`syncWithLatestSolutionVersion`, specificate solo la versione della soluzione ARN (senza`/$LATEST`) e `syncWithLatestSolutionVersion` impostatela su. `False`
+ Imposta l'`enableMetadataWithRecommendations`opzione su. `True` Ciò consente a un'opzione di richiesta di raccomandazione di includere i metadati degli elementi da un set di dati Items con i risultati dei consigli. Per disabilitare questa opzione, impostala su. `False` Per ulteriori informazioni, consulta [Metadati degli articoli nei consigli](#create-campaign-return-metadata).
+ È `minProvisionedTPS` impostata su 1 (impostazione predefinita). Si consiglia di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali se necessario. Per ulteriori informazioni, consulta [Transazioni con provisioning minimo al secondo e auto-scaling](#min-tps-auto-scaling).
Per un elenco completo di tutti i parametri, consulta[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 campagna è pronta quando il suo stato è ATTIVO. Per conoscere lo stato attuale[DescribeCampaign](API_DescribeCampaign.md), chiama e verifica che il `status` campo sia`ACTIVE`.
Se riqualifichi manualmente la versione della soluzione o se desideri modificare le impostazioni della campagna, devi aggiornare la campagna. Per ulteriori informazioni, consulta [Aggiornamento della configurazione di una campagna Amazon Personalize](update-campaigns.md).
Amazon Personalize ti fornisce le operazioni per la gestione delle campagne, ad esempio [ListCampaigns](API_ListCampaigns.md) elencare le campagne che hai creato. È possibile eliminare una campagna chiamando l'operazione [DeleteCampaign](API_DeleteCampaign.md). Se si elimina una campagna, le versioni delle soluzioni che ne fanno parte non vengono eliminate.
Una volta creata la campagna, utilizzala per le raccomandazioni. Per ulteriori informazioni, consulta [Ricevere consigli da Amazon Personalize](getting-recommendations.md).