创建市场活动 - Amazon Personalize
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

创建市场活动

如需实时推荐,请在完成后准备和导入数据创建解决方案,可随时部署解决方案版本以生成建议。您可以通过创建 Amazon Personalize)市场活动来部署 如果您获取批量推荐,则无需创建市场活动。有关更多信息,请参阅获取批量推荐和用户细分.

活动是部署的解决方案版本(训练模型),具有预置的专用事务容量,用于为您的应用程序用户创建实时建议 创建市场活动后,您可以使用GetRecommendations要么GetPersonalizedRanking获取推荐的 API 操作。

您使用 Amazon Personalize 化控制台创建广告活动,Amazon Command Line Interface(Amazon CLI),或者Amazon开发工具包。

重要

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

每秒最小预配置事务数和 auto-scaling

当您创建 Amazon Personate(个性化)市场活动时,需指定专用的交易容量,用于为您的应用程序用户创建 交易是单一的GetRecommendations要么GetPersonalizedRanking调用。每秒事务数 (TPS) 是指 Amazon Personalize 的吞吐量和账单单位。最低预配的 TPS (minProvisionedTPS) 指定 Amazon Personalize 化配置的基准吞吐量,从而指定最低账单费用。

如果你的 TPS 增加超过minProvisionedTPS,Amazon Personalize 化自动扩展预配置容量,但永远不会低于minProvisionedTPS. 容量增加时会有很短的延迟,这可能会导致交易丢失。

使用的实际 TPS 按 5 分钟窗口内的平均请求/秒计算。您支付最低预置的 TPS 或实际 TPS 的最高费用。我们建议从低开始minProvisionedTPS,使用 Amazon CloudWatch 指标跟踪您的使用情况,然后增加minProvisionedTPS根据需要。

创建市场活动(控制台)

在解决方案版本状态为 “活动” 后,您就可以通过 Amazon Personalize 化广告系列进行部署。

创建市场活动(控制台)

  1. 在打开 Amazon Personalize 控制台https://console.aws.amazon.com/personalize/home然后登录您的账户。

  2. 选择具有要部署的解决方案版本的数据集组。

  3. 在导航窗格中,选择 Campaigns (活动)

  4. 在存储库的活动页面,选择创建活动.

  5. 在存储库的创建新市场活动页面,活动详情中,请提供以下信息:

    • 活动名称:输入市场活动的名称。您在此输入的文本将显示在广告系列控制面板和详情页面上。

    • 解决方案:选择刚创建的解决方案。

    • 解决方案版本 ID:选择刚创建的解决方案版本的 ID。

    • 每秒最小预配置交易数:设置 Amazon Personalize 支持的每秒最小预配置交易数。有关更多信息,请参阅 每秒最小预配置事务数和 auto-scaling

  6. 如果你使用了用户个性化配方,请在配置活动(可选)输入值勘探权重探索物品年龄截止. 有关更多信息,请参阅用户个性化.

  7. 选择 Create campaign (创建活动)

  8. 在广告活动详情页面上,当广告活动状态为处于活动状态,您可以使用市场活动获取推荐并记录展示次数。有关更多信息,请参阅 获取推荐(自定义数据集组)

    当广告活动状态为 “活动” 时,该活动就绪。如果您重新训练解决方案版本或想更改广告系列设置,则必须更新广告系列。有关更多信息,请参阅更新市场活动.

创建市场活动 (Amazon CLI)

在您的解决方案版本状态为 “活动” 后,可随时使用 Amazon Personate (Amazon Personalize ate) 市场活动 使用以下命令create-campaign Amazon CLI命令来创建一个营销活动,部署使用用户个性化配方培训的解决方案版本。为广告活动命名并指定解决方案版本 ARN(亚马逊资源名称)。(可选)更改minProvisionedTPS如果您的使用案例需要更高的预配置容量。最小值为 1。

这些区域有:campaign-config参数特定于用于训练解决方案版本的配方(有关配方的详细信息,请参阅第 1 步:选择配方)。该示例使用以下特定于用户个性化配方itemExplorationConfig具有默认值的字段:explorationWeightexplorationItemAgeCutOff. 如果你省略了campaign-config参数,默认值应用。有关的更多信息itemExplorationConfig字段,请参阅属性和超级参数(对于 )用户个性化配方。

aws personalize create-campaign \ --name campaign name \ --solution-version-arn solution version arn \ --min-provisioned-tps 1 \ --campaign-config "{\"itemExplorationConfig\":{\"explorationWeight\":\"0.3\",\"explorationItemAgeCutOff\":\"30\"}}"

当广告活动状态为 “活动” 时,该活动就绪。要获取当前状态,请调用 DescribeCampaign 并检查 status 字段是否为 ACTIVE

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

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

在创建您的市场活动后,请使用它来进行推荐。有关更多信息,请参阅 获取推荐(自定义数据集组)

创建市场活动 (Amazon开发工具包)

在解决方案版本状态为 “活动” 后,您就可以通过 Amazon Personalize 化广告系列进行部署。使用以下代码创建市场活动Amazon SDK for Python (Boto3)要么Amazon SDK for Java 2.x.

示例代码使用以下参数(有关参数的完整列表,请参阅CreateCampaign):

  • 活动的名称。

  • 解决方案版本的 ARN(Amazon 资源名称)。

  • 这些区域有:最小预配置的 TPS将支持市场活动(此参数的最小值为 1)。

  • 可选活动配置参数itemExplorationWeightexplorationItemAgeCutOff.

广告系列配置参数特定于您用于训练解决方案版本的配方(有关配方的更多信息,请参阅第 1 步:选择配方)。在此示例中,itemExplorationWeightexplorationItemAgeCutOff参数特定于用户个性化配方。默认物品探索权重为0.3默认的探索 ItemageCutoff 是30. 如果您忽略广告活动配置参数,则默认值适用。

SDK for Python (Boto3)
import boto3 personalize = boto3.client('personalize') response = personalize.create_campaign( name = 'campaign name', solutionVersionArn = 'solution version arn', minProvisionedTPS = 1, campaignConfig = {"itemExplorationConfig": {"explorationWeight": "0.3", "explorationItemAgeCutOff": "30"}} ) arn = response['campaignArn'] description = personalize.describe_campaign(campaignArn = arn)['campaign'] print('Name: ' + description['name']) print('ARN: ' + description['campaignArn']) print('Status: ' + description['status'])
SDK for Java 2.x
public static void createCampaign(PersonalizeClient personalizeClient, String campaignName, String solutionVersionArn, Integer minProvisionedTPS, String itemExplorationWeight, String explorationItemAgeCutOff) { //Optional code to instantiate a HashMap and add the explorationWeight and explorationItemAgeCutOff values. //Remove if you aren't using User-Personaliztion. Map<String,String> itemExploration = new HashMap<String,String>(); itemExploration.put("explorationWeight", itemExplorationWeight); itemExploration.put("explorationItemAgeCutOff", explorationItemAgeCutOff); try { // Build a User-Personalization recipe specific campaignConfig object with the itemExploration map. // CampaignConfig construction will vary by recipe. CampaignConfig campaignConfig = CampaignConfig.builder() .itemExplorationConfig(itemExploration) .build(); // build the createCampaignRequest CreateCampaignRequest createCampaignRequest = CreateCampaignRequest.builder() .name(campaignName) .solutionVersionArn(solutionVersionArn) .minProvisionedTPS(minProvisionedTPS) .campaignConfig(campaignConfig) // .build(); // create the campaign CreateCampaignResponse campaignResponse = personalizeClient.createCampaign(createCampaignRequest); String campaignArn = campaignResponse.campaignArn(); DescribeCampaignRequest campaignRequest = DescribeCampaignRequest.builder() .campaignArn(campaignArn) .build(); DescribeCampaignResponse campaignResponse = personalizeClient.describeCampaign(campaignRequest); Campaign newCampaign = campaignResponse.campaign(); System.out.println("The Campaign status is " + newCampaign.status()); } catch (PersonalizeException e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } }

当广告活动状态为 “活动” 时,该活动就绪。要获取当前状态,请调用 DescribeCampaign 并检查 status 字段是否为 ACTIVE

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

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

在创建您的市场活动后,请使用它来进行推荐。有关更多信息,请参阅获取推荐(自定义数据集组)