Amazon Personalize キャンペーンの設定の更新

キャンペーンの を変更最小プロビジョニング数 TPSしたり、新しいソリューションバージョンを手動でデプロイしたり、レコメンデーションにメタデータを含めるオプションを有効にするなど、キャンペーンの設定を変更したりするには、キャンペーンを手動で更新する必要があります。

以下では、キャンペーンを手動で更新する必要はありません。

• キャンペーンで自動キャンペーン更新を使用している場合は、更新して、ソリューションの最新の自動または手動でトレーニングされたソリューションバージョンをデプロイする必要はありません。詳細については、「キャンペーンの自動更新」を参照してください。

• User-Personalization-v2、User-Personalization、または を使用すると Next-Best-Action、Amazon Personalize は 2 時間ごとに最新のソリューションバージョンを自動的に更新し、レコメンデーションに新しい項目やアクションを含めます。キャンペーンでは、更新されたソリューションバージョンが自動的に使用されます。

Amazon Personalize コンソール、 AWS Command Line Interface （AWS CLI）、または を使用してキャンペーンを手動で更新します AWS SDKs。

注記

キャンペーンを更新して、レコメンデーションにメタデータを含めるオプションを有効にするには、メタデータの列を含むアイテムデータセットが必要です。トレーニングではメタデータを使用する必要はありません。

キャンペーンで以前に User-Personalization-v2 または Personalized-Ranking-v2 を使用したソリューションバージョンをデプロイし、古いバージョンのレシピに切り替える場合、メタデータを含めるオプションはデフォルトでオフになっています。キャンペーンを更新するときに有効にできます。詳細については、「レコメンデーションの項目メタデータ」を参照してください。

キャンペーンの更新 (コンソール)

手動で再トレーニングされたソリューションバージョンをデプロイしたり、キャンペーン設定を変更したりするには、キャンペーンを更新する必要があります。

キャンペーンを更新するには (コンソール)

1. https://console.aws.amazon.com/personalize/自宅で Amazon Personalize コンソールを開き、アカウントにサインインします。

2. 更新するキャンペーンのデータセットグループを選択します。

3. ナビゲーションペインで、[キャンペーン] を選択します。

4. [Campaigns] (キャンペーン) のページで、更新するキャンペーンを選択します。

5. キャンペーンの詳細のページで、[Update] (更新) を選択します。

6. [Update campaign] (キャンペーンを更新) のページで、変更を加えます。例えば、再トレーニングされたソリューションバージョンをデプロイする場合、[Solution version ID] (ソリューションバージョン ID) で、新しいソリューションバージョンの識別番号を選択します。

7. [Update] (更新) を選択します。Amazon Personalize は、新しいソリューションバージョンと変更された設定を使用するようにキャンペーンを更新します。

キャンペーンの更新 (AWS CLI)

新しいソリューションバージョンをデプロイしたり、キャンペーンの 最小プロビジョニング数 TPS を変更したり、キャンペーンの設定を変更したりするには、キャンペーンを更新する必要があります。次の update-campaign コマンドを使用してキャンペーンを更新し、 AWS CLIで新しいソリューションバージョンを使用します。

を、更新するキャンペーンの Amazon リソースネーム (ARN) campaign arnに置き換えます。new solution version arn を、デプロイするソリューションバージョンに置き換えます。

aws personalize update-campaign \
--campaign-arn campaign arn \
--solution-version-arn new solution version arn \
--min-provisioned-tps 1

キャンペーンの更新 (AWS SDKs)

新しいソリューションバージョンをデプロイしたり、キャンペーンの 最小プロビジョニング数 TPS を変更したり、キャンペーンの設定を変更したりするには、キャンペーンを更新する必要があります。次のコードを使用して、 SDK for Python (Boto3) または SDK for Java 2.x でキャンペーンを更新します。パラメータの詳細なリストについては、「UpdateCampaign」を参照してください。

SDK for Python (Boto3)

次の update_campaign メソッドを使用して、新しいソリューションバージョンをデプロイします。更新するキャンペーンの Amazon リソースネーム (ARN) campaign arnに置き換え、 を新しいソリューションバージョンに置き換えARN、オプションnew solution version arnで を変更しますminProvisionedTPS。

import boto3

personalize = boto3.client('personalize')

response = personalize.update_campaign(
    campaignArn = 'campaign arn',
    solutionVersionArn = 'new solution version arn',
    minProvisionedTPS = 1,
)

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

次の updateCampaign メソッドを使用して、新しいソリューションバージョンを使用するようにキャンペーンを更新します。Amazon Personalize サービスクライアント、新しいソリューションバージョンの Amazon リソースネーム (ARN）、および をパラメータとして渡します最小プロビジョニング数 TPS。

public static void updateCampaign(PersonalizeClient personalizeClient, 
                                String campaignArn,
                                String solutionVersionArn, 
                                Integer minProvisionedTPS) {

    try {    
        // build the updateCampaignRequest
        UpdateCampaignRequest updateCampaignRequest = UpdateCampaignRequest.builder()
            .campaignArn(campaignArn)
            .solutionVersionArn(solutionVersionArn)
            .minProvisionedTPS(minProvisionedTPS)
            .build();
        
        // update the campaign
        personalizeClient.updateCampaign(updateCampaignRequest);
        
        DescribeCampaignRequest campaignRequest = DescribeCampaignRequest.builder()
              .campaignArn(campaignArn)
              .build();
    
        DescribeCampaignResponse campaignResponse = personalizeClient.describeCampaign(campaignRequest);
        Campaign updatedCampaign = campaignResponse.campaign();
        
        System.out.println("The Campaign status is " + updatedCampaign.status());
    
    } catch (PersonalizeException e) {
        System.err.println(e.awsErrorDetails().errorMessage());
        System.exit(1);
    }
}