翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# キャンペーンを使用して Amazon Personalize のソリューションバージョンをデプロイする
カスタムリソースを使ったリアルタイムのレコメンデーションについては、[ソリューションバージョンの手動作成](creating-a-solution-version.md) を完了すると、ソリューションバージョンをキャンペーンでデプロイする準備が整います。
*キャンペーン*では、アプリケーションユーザー向けのリアルタイムレコメンデーションを生成するためのプロビジョンドトランザクション容量を搭載した、ソリューションバージョン (トレーニング済みモデル) がデプロイされます。キャンペーンを作成したら、[GetRecommendations](API_RS_GetRecommendations.md) または [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) の API 操作を使用してレコメンデーションを取得します。バッチアイテムレコメンデーションやユーザーセグメントを取得しようとしている場合は、キャンペーンを作成する必要はありません。詳細については「[バッチアイテムのレコメンデーションの取得](getting-batch-recommendations.md)」または「[バッチユーザーセグメントの取得](getting-user-segments.md)」を参照してください。
キャンペーンを作成するとき、以下を設定できます。
+ ソリューションの最新バージョンを使用するように、キャンペーンを自動的に更新するように設定できます。詳細については、「[キャンペーンの自動更新](#create-campaign-automatic-latest-sv-update)」を参照してください。
+ レコメンデーションのアイテムメタデータを有効にできます。詳細については、「[レコメンデーションのアイテムメタデータ](#create-campaign-return-metadata)」を参照してください。
+ キャンペーンの 1 秒あたりのプロビジョニングされる最小トランザクション数を指定できます。これは Amazon Personalize によってプロビジョニングされたキャンペーンのベースライントランザクションスループットです。キャンペーンがアクティブである間の最低請求額を設定します。詳細については、「[1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング](#min-tps-auto-scaling)」を参照してください。
キャンペーンは、Amazon Personalize コンソール、AWS Command Line Interface (AWS CLI)、または AWS SDK を使用して作成できます。レコメンデーションのメタデータを有効にするなど、既存のキャンペーンの設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「[Amazon Personalize キャンペーンの設定の更新](update-campaigns.md)」を参照してください。
キャンペーンがアクティブな間は、キャンペーンコストが発生します。不要なコストを避けるため、完了したらキャンペーンを削除します。キャンペーンのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。
**Topics**
+ [キャンペーンの自動更新](#create-campaign-automatic-latest-sv-update)
+ [1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング](#min-tps-auto-scaling)
+ [レコメンデーションのアイテムメタデータ](#create-campaign-return-metadata)
+ [キャンペーンの作成 (コンソール)](#create-campaign-console)
+ [キャンペーンの作成 (AWS CLI)](#create-campaign-cli)
+ [キャンペーンの作成 (AWS SDK)](#create-campaign-sdk)
## キャンペーンの自動更新
キャンペーンを作成するときに、キャンペーンの自動更新を有効にできます。自動更新では、キャンペーンは自動的に更新され、自動または手動でトレーニングされたソリューションの最新のソリューションバージョンがデプロイされます。これにより、キャンペーンを最新の状態に保つことが容易になります。
例えば、ソリューションが[自動トレーニング](solution-config-auto-training.md)を使用して 7 日ごとに新しいソリューションバージョンを作成する場合、キャンペーンは自動的に更新され、毎週のトレーニングごとに最新のソリューションバージョンが使用されます。自動キャンペーン更新を使用しない場合は、キャンペーンを手動で更新して、最新のトレーニング済みモデルをデプロイする必要があります。
+ Amazon Personalize コンソールでキャンペーンを作成するときに自動キャンペーン更新を有効にするには、**[キャンペーンの詳細]** で **[ソリューションの最新バージョンを使用するように自動更新する]** を選択します。最新の更新のタイムスタンプは、キャンペーンの詳細ページで確認できます。
詳細については、「[キャンペーンの作成 (コンソール)](#create-campaign-console)」を参照してください。
+ [CreateCampaign](API_CreateCampaign.md) API オペレーションの使用時にキャンペーンの自動更新を有効にするには、`SolutionVersionArn` パラメータにソリューションの Amazon リソースネーム (ARN) を `SolutionArn/$LATEST` 形式で指定します。`campaignConfig` で、`enableMetadataWithRecommendations` を `true` に設定します。
最新のキャンペーン更新のタイムスタンプを取得するには、[DescribeCampaign](API_DescribeCampaign.md) API オペレーションを使用してレスポンスの `latestCampaignUpdate` の詳細を確認できます。
自動更新を有効にする方法を示すコードサンプルについては、「[キャンペーンの作成 (AWS CLI)](#create-campaign-cli)」または「[キャンペーンの作成 (AWS SDK)](#create-campaign-sdk)」を参照してください。
## 1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング
**重要**
`minProvisionedTPS` の値を高く設定するとコストが増加します。最初は `minProvisionedTPS` に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げます。
Amazon Personalize のキャンペーンを作成する場合、キャンペーンの 1 秒あたりのプロビジョニングされる最小トランザクション数 (`minProvisionedTPS`) を指定できます。これは Amazon Personalize によってプロビジョニングされたキャンペーンのベースライントランザクションスループットです。キャンペーンがアクティブである間の最低請求額を設定します。トランザクションは単一の `GetRecommendations` または `GetPersonalizedRanking` リクエストです。デフォルト `minProvisionedTPS` は 1 です。
TPS が `minProvisionedTPS` を超えて増加した場合、Amazon Personalize はプロビジョンド容量を自動スケーリングしますが、`minProvisionedTPS` を下回ることはありません。容量が引き上げられている間に短時間の遅延が生じます。これにより、トランザクションの損失が生じる可能性があります。トラフィックが減少すると、容量は `minProvisionedTPS` に戻ります。
プロビジョニングされた最小 TPS、またはリクエストが `minProvisionedTPS` を超える場合は実際の TPS に対して課金されます。実際の TPS は、行ったレコメンデーションリクエストの総数です。低い `minProvisionedTPS` から始めて、Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げることをお勧めします。
キャンペーンのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。
## レコメンデーションのアイテムメタデータ
**重要**
User-Personalization-v2 または Personalized-Ranking-v2 レシピを使用する場合、メタデータに追加コストが発生することはありません。他のすべてのレシピとすべてのドメインユースケースでは、追加コストが発生します。詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。
レコメンデーションを取得すると、Amazon Personalize にレコメンデーション結果にアイテムメタデータを含めることができます。リクエストでは、含めるアイテムデータセットから列を選択できます。Amazon Personalize は、レコメンデーションレスポンス内の各アイテムについてこのデータを返します。
メタデータを使用して、映画のジャンルをカルーセルに追加するなど、ユーザーインターフェイスのレコメンデーションを充実させることができます。あるいは、レコメンデーションの質を視覚的に評価するのにも使えます。アプリで生成 AI を使用している場合は、メタデータを AI プロンプトに組み込んで、より関連性の高いコンテンツを生成できます。Amazon Personalize の生成 AI の使用に関する詳細については、「[Amazon Personalize と生成 AI](personalize-with-gen-ai.md)」を参照してください。
### メタデータの有効化
レコメンデーションにメタデータを追加するには、メタデータの列を含むアイテムデータセットが必要です。トレーニングではメタデータを使用する必要はありません。データセットの作成については、「[スキーマとデータセットの作成](data-prep-creating-datasets.md)」を参照してください。データの更新については、「[トレーニング後のデータセット内のデータの更新](updating-datasets.md)」を参照してください。
User-Personalization-v2 または Personalized-Ranking-v2 レシピを使用すると、新しいキャンペーンにアイテムメタデータをレコメンデーション結果に含めるオプションが自動的に追加されます。キャンペーンのメタデータを手動で有効にすることはできません。他のすべてのレシピとドメインのユースケースでは、メタデータオプションを有効にする必要があります。
+ Amazon Personalize コンソールでメタデータを有効にするには、キャンペーンを作成するときに、**[キャンペーン詳細]** の **[レコメンデーション結果にあるアイテムのメタデータを返す]** を選択します。詳細については、「[キャンペーンの作成 (コンソール)](#create-campaign-console)」を参照してください。
+ AWS SDK または AWS CLI でメタデータを有効にするには、[CreateCampaign](API_CreateCampaign.md) API オペレーションを使用し、`campaignConfig` で `enableMetadataWithRecommendations` を `true` に設定します。詳細については「[キャンペーンの作成 (AWS CLI)](#create-campaign-cli)」または「[キャンペーンの作成 (AWS SDK)](#create-campaign-sdk)」を参照してください。
## キャンペーンの作成 (コンソール)
**重要**
キャンペーンがアクティブな間は、キャンペーンコストが発生します。不要なコストを避けるため、完了したらキャンペーンを削除します。キャンペーンのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。
ソリューションバージョンのステータスが [Active ] (アクティブ) になったら、Amazon Personalize のキャンペーンでそのソリューションバージョンをデプロイする準備が整います。
**キャンペーンを作成するには (コンソール)**
1. [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) で Amazon Personalize コンソールを開き、アカウントにサインインします。
1. デプロイするソリューションバージョンのデータセットグループを選択します。
1. ナビゲーションペインの **[カスタムリソース]** で、**[キャンペーン]** を選択します。
1. **[Campaigns]** (キャンペーン) のページで、**[Create campaign]** (キャンペーンを作成) を選択します。
1. **[Create new campaign]** (新しいキャンペーンを作成) ページの **[Campaign details]** (キャンペーンの詳細) で、次の情報を入力します。
+ **キャンペーン名** - キャンペーンの名前を入力します。ここで入力したテキストは、[Campaign] (キャンペーン) ダッシュボードと詳細のページに表示されます。
+ **ソリューション** - 先ほど作成したソリューションを選択します。
+ **ソリューションの最新バージョンを使用するように自動更新する** — キャンペーンに最新のアクティブなソリューションバージョンを自動的に使用させるには、このオプションを選択します。これを選択しない場合は、新しいソリューションバージョンをデプロイするたびにキャンペーンを手動で更新する必要があります。詳細については、「[キャンペーンの自動更新](#create-campaign-automatic-latest-sv-update)」を参照してください。
+ **ソリューションバージョン ID** – 自動キャンペーン更新を使用して最新のソリューションバージョンを使用しない場合は、デプロイするソリューションバージョンの ID を選択します。
+ **1 秒あたりの最小プロビジョンドトランザクション (API では minProvisionedTPS と呼ばれます)** - Amazon Personalize がサポートしている 1 秒あたりの最小プロビジョンドトランザクションを設定します。値を高く設定すると料金が増加します。最初は 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げます。詳細については、「[1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング](#min-tps-auto-scaling)」を参照してください。
+ **レコメンデーション結果にアイテムのメタデータを返す** - レコメンデーション結果にメタデータを含めたい場合は、このオプションを選択してください。有効にすると、レコメンデーションを取得するときに、アイテムデータセットの列を指定できます。詳細については、「[レコメンデーションのアイテムメタデータ](#create-campaign-return-metadata)」を参照してください。
1. User-Personalization レシピを使用した場合は、**[キャンペーン設定]** で、オプションで **[探索の重み]** と **[探索アイテムが存在するようになってからの期間のカットオフ]** の値を入力します。詳細については、「[User-Personalization](native-recipe-new-item-USER_PERSONALIZATION.md)」を参照してください。
1. **[タグ]** には、オプションで任意のタグを追加します。Amazon Personalize リソースのタグ付けの詳細については、「[Amazon Personalize リソースのタグ付け](tagging-resources.md)」を参照してください。
1. **[キャンペーンの作成]** を選択します。
1. キャンペーンの詳細のページで、キャンペーンのステータスが **[Active]** (アクティブ) の場合、キャンペーンを使用してレコメンデーションを取得し、インプレッションを記録できます。詳細については、「[Amazon Personalize からのレコメンデーションの取得](getting-recommendations.md)」を参照してください。
キャンペーンのステータスが ACTIVE になると、キャンペーンの準備が整います。ソリューションバージョンを再トレーニングする場合、またはキャンペーンの設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「[Amazon Personalize キャンペーンの設定の更新](update-campaigns.md)」を参照してください。
## キャンペーンの作成 (AWS CLI)
**重要**
キャンペーンがアクティブな間は、キャンペーンコストが発生します。不要なコストを避けるため、完了したらキャンペーンを削除します。キャンペーンのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。
ソリューションバージョンが Active になったら、Amazon Personalize のキャンペーンでそのソリューションバージョンをデプロイする準備が整います。AWS CLI を使用してキャンペーンを作成するには、`create-campaign` コマンドを使用します。
次のコードサンプルは、新しいキャンペーンを作成する方法を示しています。User-Personalization レシピを使用するソリューションの最新バージョンをデプロイします。将来のソリューションバージョンを使用するように自動的に更新されるキャンペーン。コードは、次の設定を使用します。
+ ソリューションの最新バージョンを使用するようにキャンペーンを自動的に更新するように設定します。`solution-version-arn` は `solution ARN/$LATEST` 形式で、`syncWithLatestSolutionVersion` は `True` です。コードを使用するには、`solution ARN` をソリューションの Amazon リソースネーム (ARN) に置き換えます。
自動 `syncWithLatestSolutionVersion` を無効にするには、ソリューションバージョン ARN (`/$LATEST` なし) のみを指定し、`syncWithLatestSolutionVersion` を `False` に設定します。
+ これにより、`enableMetadataWithRecommendations` のオプションが `True` に設定されます。これにより、アイテムデータセットのアイテムメタデータをレコメンデーション結果に含めるレコメンデーションリクエストオプションを有効にできます。このオプションを無効にするには、`False` に設定します。詳細については、「[レコメンデーションのアイテムメタデータ](#create-campaign-return-metadata)」を参照してください。
+ `min-provisioned-tps` は 1 に設定されます (デフォルト)。最初は `minProvisionedTPS` に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げます。詳細については、「[1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング](#min-tps-auto-scaling)」を参照してください。
すべてのパラメータの詳細なリストについては、「[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"}"
```
キャンペーンのステータスが ACTIVE になると、キャンペーンの準備が整います。現在のステータスを取得するには、[DescribeCampaign](API_DescribeCampaign.md) を呼び出して、`status` フィールドが `ACTIVE` であることを確認します。
ソリューションバージョンを再トレーニングし、キャンペーンが自動的に更新されて最新のソリューションバージョンが使用されない場合、またはキャンペーン設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「[Amazon Personalize キャンペーンの設定の更新](update-campaigns.md)」を参照してください。
Amazon Personalize には、作成したキャンペーンを一覧表示する [ListCampaigns](API_ListCampaigns.md) など、キャンペーンを管理するための操作が用意されています。キャンペーンを削除するには、[DeleteCampaign](API_DeleteCampaign.md) を呼び出します。キャンペーンを削除しても、キャンペーンの一部であるソリューションバージョンは削除されません。
キャンペーンを作成したら、これを使用して推奨を行うことができます。詳細については、「[Amazon Personalize からのレコメンデーションの取得](getting-recommendations.md)」を参照してください。
## キャンペーンの作成 (AWS SDK)
**重要**
キャンペーンがアクティブな間は、キャンペーンコストが発生します。不要なコストを避けるため、完了したらキャンペーンを削除します。キャンペーンのコストの詳細については、「[Amazon Personalize の料金](https://aws.amazon.com/personalize/pricing/)」を参照してください。
ソリューションバージョンが Active になったら、Amazon Personalize のキャンペーンでそのソリューションバージョンをデプロイする準備が整います。AWS SDK を使用してキャンペーンを作成するには、[CreateCampaign](API_CreateCampaign.md) API オペレーションを使用します。
次のコードサンプルは、新しいキャンペーンを作成する方法を示しています。このコードは、User-Personalization レシピを使用するソリューションの最新バージョンをデプロイします。将来のソリューションバージョンを使用するように自動的に更新されるキャンペーン。コードは、次の設定を使用します。
+ ソリューションの最新バージョンを使用するようにキャンペーンを自動的に更新するように設定します。`solutionVersionArn` は `solution ARN/$LATEST` 形式で、`syncWithLatestSolutionVersion` は `True` です。コードを使用するには、`solution ARN` をソリューションバージョンの Amazon リソースネーム (ARN) に置き換えます。
自動 `syncWithLatestSolutionVersion` を無効にするには、ソリューションバージョン ARN (`/$LATEST` なし) のみを指定し、`syncWithLatestSolutionVersion` を `False` に設定します。
+ これにより、`enableMetadataWithRecommendations` のオプションが `True` に設定されます。これにより、アイテムデータセットのアイテムメタデータをレコメンデーション結果に含めるレコメンデーションリクエストオプションを有効にできます。このオプションを無効にするには、`False` に設定します。詳細については、「[レコメンデーションのアイテムメタデータ](#create-campaign-return-metadata)」を参照してください。
+ `minProvisionedTPS` は 1 に設定されます (デフォルト)。最初は `minProvisionedTPS` に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて `minProvisionedTPS` を引き上げます。詳細については、「[1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング](#min-tps-auto-scaling)」を参照してください。
すべてのパラメータの詳細なリストについては、「[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();
```
------
キャンペーンのステータスが ACTIVE になると、キャンペーンの準備が整います。現在のステータスを取得するには、[DescribeCampaign](API_DescribeCampaign.md) を呼び出して、`status` フィールドが `ACTIVE` であることを確認します。
ソリューションバージョンを手動で再トレーニングする場合、またはキャンペーンの設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「[Amazon Personalize キャンペーンの設定の更新](update-campaigns.md)」を参照してください。
Amazon Personalize には、作成したキャンペーンを一覧表示する [ListCampaigns](API_ListCampaigns.md) など、キャンペーンを管理するための操作が用意されています。キャンペーンを削除するには、[DeleteCampaign](API_DeleteCampaign.md) を呼び出します。キャンペーンを削除しても、キャンペーンの一部であるソリューションバージョンは削除されません。
キャンペーンを作成したら、これを使用して推奨を行うことができます。詳細については、「[Amazon Personalize からのレコメンデーションの取得](getting-recommendations.md)」を参照してください。