Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建市场活动

要获取包含自定义资源的实时建议，完成创建解决方案版本后，您就可以通过市场活动部署解决方案版本了。

市场活动 部署的解决方案版本（经过训练的模型）具有预调配的事务容量，用于生成实时建议。创建市场活动后，您可以使用 GetRecommendations 或 GetPersonalizedRanking API 操作来获取建议。如果您收到批量建议，则无需创建市场活动。有关更多信息，请参阅 批量建议和用户细分（自定义资源）。

创建活动时，您可以配置以下内容：

您可以使用 Amazon Personalize 控制台、 Amazon Command Line Interface (Amazon CLI) 或 Amazon 软件开发工具包创建活动。如果您想更改现有广告系列的设置，例如在推荐中启用元数据，则必须更新您的广告活动。有关更多信息，请参阅 更新市场活动。

当广告活动处于活动状态时，您需要支付广告费用。为避免不必要的费用，请务必在活动结束后删除该活动。有关活动费用的信息，请参阅 Amazon Personalize 定价。

启用广告系列自动更新

创建广告活动时，您可以启用广告系列的自动更新。通过自动更新，活动会自动更新以部署最新的自动或手动训练的解决方案版本。这使您可以更轻松地将广告系列保持最新状态。

例如，如果您的解决方案使用自动培训每七天创建一次新的解决方案版本，则您的活动将自动更新为在每周培训中使用最新的解决方案版本。如果您不使用自动广告系列更新，则必须手动更新广告系列以部署经过训练的最新模型。

预调配的最低每秒事务数和自动扩缩

在创建 Amazon Personalize 市场活动时，您可以为该市场活动指定预置的每秒最低事务数 (minProvisionedTPS)。这是 Amazon Personalize 为该市场活动预置的基准事务吞吐量。它会设置市场活动处于活动状态时的最低账单费用。事务是单个 GetRecommendations 或 GetPersonalizedRanking 请求。默认 minProvisionedTPS 为 1。

如果您的 TPS 增加到超过 minProvisionedTPS，则 Amazon Personalize 会自动纵向扩展和缩减预置容量，但从不会低于 minProvisionedTPS。增加容量时会有短时间延迟，这可能会导致事务丢失。当您的流量减少时，容量将恢复到 minProvisionedTPS。

您需要为最低预配置 TPS 付费，如果您的请求超过了实际 TPS，则需要支付实际的 minProvisionedTPS TPS 费用。实际 TPS 是您发出的建议请求的总数。我们建议从低开始minProvisionedTPS，使用 Amazon CloudWatch 指标跟踪您的使用情况，然后minProvisionedTPS根据需要增加使用量。

有关市场活动成本的更多信息，请参阅 Amazon Personalize 定价。

推荐中的商品元数据

收到推荐后，您可以让 Amazon Personalize 在推荐结果中包含商品元数据。在您的请求中，您可以从 Items 数据集中选择要包含的列。Amazon Personalize 会在建议响应中返回每个物品的这些数据。

您可以使用元数据来丰富用户界面中的建议，例如将电影的类型添加到轮播中。或者，您可以用它来直观地评测建议质量。如果您在应用程序中使用生成式人工智能，则可以将元数据插入人工智能提示中，以生成相关性更高的内容。有关 Amazon Personalize 与生成式人工智能结合使用的更多信息，请参阅Amazon Personalize 和生成式人工智能。

启用元数据

要向建议添加元数据，您必须拥有包含一列元数据的物品数据集。您不一定要在训练中使用元数据。有关创建数据集的信息，请参阅创建数据集和架构。有关管理和更新数据的信息，请参阅管理数据集中的训练数据。

如果您使用用户个性化-v2 或 personalized-ranking-v2 配方，则广告系列会自动选择在推荐结果中包含商品元数据。您没有手动为广告活动启用元数据。对于所有其他配方和域用例，您必须启用元数据选项：

创建市场活动（控制台）

在您的解决方案版本状态变为“活动”后，您就可以通过 Amazon Personalize 市场活动进行部署了。

创建市场活动 (Amazon CLI)

在您的解决方案版本处于活动状态后，您就可以通过 Amazon Personalize 活动进行部署了。要使用创建活动 Amazon CLI，请使用create-campaign命令。

以下代码示例向您展示了如何创建广告系列。它部署了使用用户个性化配方的解决方案的最新解决方案版本。它创建的活动会自动更新以使用 future 的解决方案版本。该代码使用以下配置：

要获得所有参数的完整列表，请参阅CreateCampaign。

aws personalize create-campaign \
--name campaign-name \
--solution-version-arn solution-arn/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"

当市场活动状态为“活动”时，市场活动即已准备就绪。要获取当前状态，请调用 DescribeCampaign 并检查 status 字段是否为 ACTIVE。

如果您对解决方案版本进行了重新培训，但您的广告系列没有自动更新以使用最新的解决方案版本，或者您想更改广告系列设置，则必须更新您的广告系列。有关更多信息，请参阅 更新市场活动。

Amazon Personalize 为您提供管理活动的操作，例如ListCampaigns列出您创建的广告活动。您可以通过调用 DeleteCampaign 来删除活动。如果您删除一个市场活动，不会删除属于该市场活动的一部分的解决方案版本。

创建广告活动后，你可以用它来提出推荐。有关更多信息，请参阅 步骤 4：获取建议。

创建广告系列 (Amazon SDK)

在您的解决方案版本处于活动状态后，您就可以通过 Amazon Personalize 活动进行部署了。要使用 Amazon 软件开发工具包创建活动，请使用 CreateCampaign API 操作。

以下代码示例向您展示了如何创建广告系列。该代码部署了使用用户个性化配方的解决方案的最新解决方案版本。它创建的活动会自动更新以使用 future 的解决方案版本。该代码使用以下配置：

要获得所有参数的完整列表，请参阅CreateCampaign。

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();

当市场活动状态为“活动”时，市场活动即已准备就绪。要获取当前状态DescribeCampaign，请致电并检查该status字段是否为ACTIVE。

如果您手动重新训练解决方案版本，或者想要更改广告系列设置，则必须更新您的广告系列。有关更多信息，请参阅 更新市场活动。

Amazon Personalize 为您提供管理活动的操作，例如ListCampaigns列出您创建的广告活动。您可以通过调用 DeleteCampaign 来删除活动。如果您删除一个市场活动，不会删除属于该市场活动的一部分的解决方案版本。

在创建您的市场活动后，请使用它来进行推荐。有关更多信息，请参阅 步骤 4：获取建议。