As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Você pode implantar uma versão da solução do Amazon Personalize com uma campanha.
Para recomendações em tempo real com recursos personalizados, depois de concluir [Criar uma versão da solução manualmente](creating-a-solution-version.md), você estará pronto para implantar sua versão da solução com uma campanha.
Uma *campanha* implanta uma versão da solução (modelo treinado) com uma capacidade de transação provisionada para gerar recomendações em tempo real. Depois de criar uma campanha, você pode usar as operações de API [GetRecommendations](API_RS_GetRecommendations.md) ou [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) para obter recomendações. Se você estiver recebendo recomendações de itens em lote, não precisará criar uma campanha. Para ter mais informações, consulte [Obter recomendações de itens em lote](getting-batch-recommendations.md) ou [Obter segmentos em lote de usuários](getting-user-segments.md).
Ao criar uma campanha, é possível configurar o seguinte:
+ Você pode configurar a campanha para ser atualizada automaticamente para usar a versão mais recente da solução. Para obter mais informações, consulte [Atualizações automáticas da campanha](#create-campaign-automatic-latest-sv-update).
+ É possível habilitar os metadados do item nas recomendações. Para obter mais informações, consulte [Habilitar metadados nas recomendações](#create-campaign-return-metadata).
+ É possível especificar o mínimo de transações provisionadas por segundo para a campanha. Esse é o throughput de transação básico para a campanha provisionada pelo Amazon Personalize. Ele define a cobrança mínima para a campanha enquanto ela está ativa. Para obter mais informações, consulte [Transações mínimas por segundo provisionadas e ajuste de escala automático](#min-tps-auto-scaling).
É possível criar uma campanha com o console do Amazon Personalize, a AWS Command Line Interface (AWS CLI) ou SDKs da AWS. Se quiser modificar as configurações atuais de uma campanha, como habilitar os metadados nas recomendações, atualize a campanha. Para obter mais informações, consulte [Atualizar a configuração de uma campanha do Amazon Personalize](update-campaigns.md).
Os custos da campanha são acumulados enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter mais informações sobre os custos das campanhas, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
**Topics**
+ [Atualizações automáticas da campanha](#create-campaign-automatic-latest-sv-update)
+ [Transações mínimas por segundo provisionadas e ajuste de escala automático](#min-tps-auto-scaling)
+ [Habilitar metadados nas recomendações](#create-campaign-return-metadata)
+ [Criar uma campanha (console)](#create-campaign-console)
+ [Criar uma campanha (AWS CLI)](#create-campaign-cli)
+ [Criar uma campanha (SDKs da AWS)](#create-campaign-sdk)
## Atualizações automáticas da campanha
Ao criar uma campanha, é possível habilitar as atualizações automáticas dela. Com esse recurso, a campanha é atualizada para implantar a versão mais recente de forma automática ou a versão da sua solução treinada manualmente. Isso facilita a atualização da campanha.
Por exemplo, se sua solução usa o [treinamento automático](solution-config-auto-training.md) para criar uma nova versão da solução a cada sete dias, sua campanha será atualizada automaticamente para usar a versão mais recente da solução dos treinos semanais. Se você não usa atualizações automáticas da campanha, deve atualizar manualmente a campanha para implantar o modelo treinado mais recente.
+ Para ativar as atualizações automáticas ao criar uma campanha com o console Amazon Personalize, escolha **Atualizar automaticamente para usar a versão mais recente da solução** nos **Detalhes campanha**. Você pode encontrar a data e hora da atualização mais recente na página de detalhes da campanha.
Para obter mais informações, consulte [Criar uma campanha (console)](#create-campaign-console).
+ Para ativar as atualizações automáticas da campanha ao usar a operação da API [CreateCampaign](API_CreateCampaign.md), especifique o nome do recurso da Amazon (ARN) da sua solução no formato `SolutionArn/$LATEST` para o parâmetro `SolutionVersionArn`. Em `campaignConfig`, defina `enableMetadataWithRecommendations` como `true`.
Para obter a data e hora da atualização mais recente da campanha, você pode usar a operação da API [DescribeCampaign](API_DescribeCampaign.md) e verificar os detalhes de `latestCampaignUpdate` na resposta.
Para exemplos de código que mostram como ativar as atualizações automáticas, consulte [Criar uma campanha (AWS CLI)](#create-campaign-cli) ou [Criar uma campanha (SDKs da AWS)](#create-campaign-sdk).
## Transações mínimas por segundo provisionadas e ajuste de escala automático
**Importante**
Um `minProvisionedTPS` alto aumentará o custo. Recomendamos começar com 1 para `minProvisionedTPS` (o padrão). Monitore seu uso com as métricas do Amazon CloudWatch e aumente o `minProvisionedTPS` conforme necessário.
Ao criar uma campanha do Amazon Personalize, é possível especificar o mínimo de transações provisionadas por segundo (`minProvisionedTPS`) para a campanha. Esse é o throughput de transação básico para a campanha provisionada pelo Amazon Personalize. Ele define a cobrança mínima para a campanha enquanto ela está ativa. Transação é uma solicitação `GetRecommendations` ou `GetPersonalizedRanking` única. O `minProvisionedTPS` padrão é um.
Se o TPS ultrapassar o `minProvisionedTPS`, o Amazon Personalize fará um ajuste de escala automático da capacidade provisionada, mas nunca a definirá como abaixo de `minProvisionedTPS`. Há um pequeno atraso no aumento da capacidade, o que pode causar perda de transações. Quando o tráfego é reduzido, a capacidade retorna ao `minProvisionedTPS`.
Você recebe as cobranças pelo TPS mínimo provisionado ou, se as solicitações excederem o `minProvisionedTPS`, o TPS real. O TPS real é o número total de solicitações de recomendação realizadas. Recomendamos iniciar com um `minProvisionedTPS` baixo, monitorar seu uso com as métricas do Amazon CloudWatch e aumentar o `minProvisionedTPS` conforme necessário.
Para obter mais informações sobre custos de campanhas, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
## Habilitar metadados nas recomendações
**Importante**
Se você usar a fórmula User-Personalization-v2 ou Personalized-Ranking-v2, não incorrerá em custos adicionais com metadados. Para todas as outras fórmulas e todos os casos de uso do domínio, há custos adicionais. Para obter mais informações, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Ao receber recomendações, é possível fazer com que o Amazon Personalize inclua metadados do item nos resultados da recomendação. Na solicitação, é possível escolher as colunas do conjunto de dados de itens a serem incluídas. O Amazon Personalize exibe esses dados para cada item na resposta da recomendação.
É possível usar metadados para aprimorar as recomendações na interface de usuário, como adicionar gêneros de filmes a carrosséis. Também é possível usá-los para avaliar visualmente a qualidade da recomendação. Se você usa IA generativa na aplicação, pode conectar os metadados às solicitações de IA com o objetivo de gerar conteúdo mais relevante. Para obter mais informações sobre o uso do Amazon Personalize com IA generativa, consulte [Amazon Personalize e IA generativa](personalize-with-gen-ai.md).
### Habilitar metadados
Para adicionar metadados a recomendações, é necessário ter um conjunto de dados de itens com uma coluna de metadados. Não é necessário usar os metadados no treinamento. Para obter informações sobre como criar um conjunto de dados, consulte [Criar um conjunto de dados e um esquema](data-prep-creating-datasets.md). Para obter informações sobre como atualizar os dados, consulte [Atualizar os dados em conjuntos de dados após o treinamento](updating-datasets.md).
Se você usar a fórmula User-Personalization-v2 ou Personalized-Ranking-v2, as novas campanhas terão a opção de incluir metadados do item nos resultados das recomendações. Você não precisa habilitar manualmente os metadados da sua campanha. Para todas as outras fórmulas e casos de uso de domínio, você deve habilitar os metadados:
+ Para habilitar metadados com o console do Amazon Personalize, ao criar a campanha, selecione **Exibir metadados de itens nos resultados da recomendação** em **Detalhes da campanha**. Para obter mais informações, consulte [Criar uma campanha (console)](#create-campaign-console).
+ Para habilitar metadados com os SDKs da AWS ou a AWS CLI, use a operação de API [CreateCampaign](API_CreateCampaign.md) e, na `campaignConfig`, defina `enableMetadataWithRecommendations` como `true`. Para ter mais informações, consulte [Criar uma campanha (AWS CLI)](#create-campaign-cli) ou [Criar uma campanha (SDKs da AWS)](#create-campaign-sdk).
## Criar uma campanha (console)
**Importante**
Os custos da campanha são acumulados enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter mais informações sobre os custos das campanhas, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Quando o status da versão da solução for ativo, você estará pronto para implantá-la com uma campanha do Amazon Personalize.
**Para criar uma campanha (console)**
1. Abra o console do Amazon Personalize em [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) e faça login na sua conta.
1. Escolha o grupo de conjuntos de dados com a versão da solução que você deseja implantar.
1. No painel de navegação, em **Recursos personalizados**, selecione **Campanhas**.
1. Na página **Campanhas**, escolha **Criar campanha**.
1. Na página **Criar nova campanha**, para **Detalhes da campanha**, forneça as seguintes informações:
+ **Nome da campanha**: insira o nome da campanha. O texto que você insere aqui aparece no painel Campanha e na página de detalhes.
+ **Solução**: escolha a solução que você acabou de criar.
+ **Atualize automaticamente para usar a versão mais recente da solução**: escolha essa opção para que a campanha use automaticamente a versão mais recente da solução ativa. Se não escolher essa alternativa, você deverá atualizar manualmente a campanha sempre que quiser implantar uma nova versão da solução. Para obter mais informações, consulte [Atualizações automáticas da campanha](#create-campaign-automatic-latest-sv-update).
+ **ID da versão da solução**: se você não usa atualizações automáticas da campanha para usar a versão mais recente da solução, escolha o ID da versão da solução que você quer implantar.
+ **Transações mínimas provisionadas por segundo (chamadas de minProvisionedTPS em APIs)**: defina as transações mínimas provisionadas por segundo compatíveis com o Amazon Personalize. Um alto valor aumentará sua conta. Recomendamos começar com 1 (o padrão). Monitore seu uso com as métricas do Amazon CloudWatch e aumente o `minProvisionedTPS` conforme necessário. Para obter mais informações, consulte [Transações mínimas por segundo provisionadas e ajuste de escala automático](#min-tps-auto-scaling).
+ **Retornar metadados de itens nos resultados da recomendação**: escolha essa opção se quiser incluir metadados nos resultados da recomendação. Se a opção estiver ativada, será possível especificar as colunas do conjunto de dados de itens no pedido de recomendações. Para obter mais informações, consulte [Habilitar metadados nas recomendações](#create-campaign-return-metadata).
1. Se você usou a fórmula User-Personalization, na **configuração da campanha**, é possível inserir valores para o **Peso da exploração** e o **Limite de idade do item de exploração**. Para obter mais informações, consulte [User-Personalization](native-recipe-new-item-USER_PERSONALIZATION.md).
1. Para **Tags**, é possível adicionar quaisquer tags. Para obter mais informações sobre recursos de atribuição de tags do Amazon Personalize, consulte [Usar tags nos recursos do Amazon Personalize](tagging-resources.md).
1. Escolha **Create campaign (Criar campanha)**.
1. Na página de detalhes da campanha, quando o status da campanha é **Ativo**, você pode usar a campanha para obter recomendações e registrar impressões. Para obter mais informações, consulte [Obter recomendações do Amazon Personalize](getting-recommendations.md).
A campanha estará pronta quando seu status for ATIVO. Se você retreinar a versão da solução ou quiser alterar as configurações da campanha, deverá atualizá-la. Para obter mais informações, consulte [Atualizar a configuração de uma campanha do Amazon Personalize](update-campaigns.md).
## Criar uma campanha (AWS CLI)
**Importante**
Os custos da campanha são acumulados enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter mais informações sobre os custos das campanhas, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Quando o status da versão da solução for ativo, você poderá para implantá-la com uma campanha do Amazon Personalize. Para criar uma campanha com a AWS CLI, use o comando `create-campaign`.
O exemplo de código a seguir mostra como criar uma campanha. Ele implanta a versão mais recente de uma solução que usa a fórmula de personalização do usuário. A campanha que ele cria é atualizada automaticamente para usar versões futuras da solução. O código usa a seguinte configuração:
+ Ele configura a campanha para ser atualizada automaticamente e usar a versão mais recente da solução: o `solution-version-arn` está no formato `solution ARN/$LATEST`, e `syncWithLatestSolutionVersion` é `True`. Para usar o código, `solution ARN` substitua pelo nome do recurso da Amazon (ARN) da solução.
Para desativar o `syncWithLatestSolutionVersion` automático, especifique somente o ARN da versão da solução (sem `/$LATEST`) e `syncWithLatestSolutionVersion` defina como. `False`
+ Define a opção `enableMetadataWithRecommendations` como `True`. Isso permite que a opção de um pedido de recomendação inclua metadados de itens do conjunto de dados relevante com resultados de recomendação. Para desativar essa opção, defina-a como `False`. Para obter mais informações, consulte [Habilitar metadados nas recomendações](#create-campaign-return-metadata).
+ Ela define `min-provisioned-tps` como 1 (por padrão). Recomendamos começar com 1 para `minProvisionedTPS` (o padrão). Monitore seu uso com as métricas do Amazon CloudWatch e aumente o `minProvisionedTPS` conforme necessário. Para obter mais informações, consulte [Transações mínimas por segundo provisionadas e ajuste de escala automático](#min-tps-auto-scaling).
Para conferir uma lista com todos os 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"}"
```
A campanha estará pronta quando seu status for ATIVO. Para obter o status atual, chame [DescribeCampaign](API_DescribeCampaign.md) e verifique se o campo `status` está definido como `ACTIVE`.
Se você retreinar a versão da solução e a campanha não for atualizada automaticamente para usar a versão mais recente, ou se quiser alterar as configurações da campanha, será necessário atualizar a campanha. Para obter mais informações, consulte [Atualizar a configuração de uma campanha do Amazon Personalize](update-campaigns.md).
O Amazon Personalize oferece operações para gerenciar campanhas, como a [ListCampaigns](API_ListCampaigns.md), e listar aquelas que você criou. Você pode excluir uma campanha chamando [DeleteCampaign](API_DeleteCampaign.md). Se você excluir uma campanha, as versões da solução que fazem parte da campanha não serão excluídas.
Depois que você criar sua campanha, use-a para fazer recomendações. Para obter mais informações, consulte [Obter recomendações do Amazon Personalize](getting-recommendations.md).
## Criar uma campanha (SDKs da AWS)
**Importante**
Os custos da campanha são acumulados enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter mais informações sobre os custos das campanhas, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/).
Quando o status da versão da solução for ativo, você poderá para implantá-la com uma campanha do Amazon Personalize. Para criar uma campanha com os AWS SDKs, use a operação da API [CreateCampaign](API_CreateCampaign.md).
O exemplo de código a seguir mostra como criar uma campanha. O código implanta a versão mais recente de uma solução que usa a fórmula User-Personalization. A campanha que ele cria é atualizada automaticamente para usar versões futuras da solução. O código usa a seguinte configuração:
+ Ele configura a campanha para ser atualizada automaticamente e usar a versão mais recente da solução: o `solutionVersionArn` está no formato `solution ARN/$LATEST`, e `syncWithLatestSolutionVersion` é `True`. Para usá-lo, substitua `solution ARN` pelo nome do recurso da Amazon (ARN) da versão da sua solução.
Para desativar o `syncWithLatestSolutionVersion` automático, especifique somente o ARN da versão da solução (sem `/$LATEST`) e `syncWithLatestSolutionVersion` defina como. `False`
+ Define a opção `enableMetadataWithRecommendations` como `True`. Isso permite que a opção de um pedido de recomendação inclua metadados de itens do conjunto de dados relevante com resultados de recomendação. Para desativar essa opção, defina-a como `False`. Para obter mais informações, consulte [Habilitar metadados nas recomendações](#create-campaign-return-metadata).
+ Ela define `minProvisionedTPS` como 1 (por padrão). Recomendamos começar com 1 para `minProvisionedTPS` (o padrão). Monitore seu uso com as métricas do Amazon CloudWatch e aumente o `minProvisionedTPS` conforme necessário. Para obter mais informações, consulte [Transações mínimas por segundo provisionadas e ajuste de escala automático](#min-tps-auto-scaling).
Para conferir uma lista com todos os 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();
```
------
A campanha estará pronta quando seu status for ATIVO. Para obter o status atual, chame [DescribeCampaign](API_DescribeCampaign.md) e verifique se o campo `status` está definido como `ACTIVE`.
Se você retreinar manualmente a versão da solução ou quiser alterar as configurações da sua campanha, deverá atualizar a campanha. Para obter mais informações, consulte [Atualizar a configuração de uma campanha do Amazon Personalize](update-campaigns.md).
O Amazon Personalize oferece operações para gerenciar campanhas, como a [ListCampaigns](API_ListCampaigns.md), e listar aquelas que você criou. Você pode excluir uma campanha chamando [DeleteCampaign](API_DeleteCampaign.md). Se você excluir uma campanha, as versões da solução que fazem parte da campanha não serão excluídas.
Depois de criar sua campanha, use-a para fazer recomendações. Para obter mais informações, consulte [Obter recomendações do Amazon Personalize](getting-recommendations.md).