翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
キャンペーンを使用した Amazon Personalize ソリューションバージョンのデプロイ
カスタムリソースを使ったリアルタイムのレコメンデーションについては、ソリューションバージョンを手動で作成する を完了すると、ソリューションバージョンをキャンペーンでデプロイする準備が整います。
キャンペーンでは、アプリケーションユーザー向けのリアルタイムレコメンデーションを生成するためのプロビジョンドトランザクション容量を搭載した、ソリューションバージョン (トレーニング済みモデル) がデプロイされます。キャンペーンを作成したら、 GetRecommendationsまたは GetPersonalizedRankingAPIオペレーションを使用してレコメンデーションを取得します。バッチアイテムのレコメンデーションやユーザーセグメントを取得する場合は、キャンペーンを作成する必要はありません。詳細については、バッチアイテムレコメンデーションの取得 または バッチユーザーセグメントの取得 を参照してください。
キャンペーンを作成するときに、以下を設定できます。
-
ソリューションの最新のソリューションバージョンを使用するように自動的に更新するようにキャンペーンを設定できます。詳細については、「自動キャンペーン更新の有効化」を参照してください。
-
レコメンデーションでアイテムメタデータを有効にできます。詳細については、「レコメンデーションのアイテムメタデータ」を参照してください。
-
キャンペーンの 1 秒あたりの最小プロビジョニングトランザクションを指定できます。これは Amazon Personalize によってプロビジョニングされたキャンペーンのベースライントランザクションスループットです。キャンペーンがアクティブである間の最低請求額を設定します。詳細については、「1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング」を参照してください。
Amazon Personalize コンソールを使用してキャンペーンを作成できます。 AWS Command Line Interface (AWS CLI)、または AWS SDKs。レコメンデーションでメタデータを有効にするなど、既存のキャンペーンの設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「Amazon Personalize キャンペーンの設定の更新」を参照してください。
キャンペーンがアクティブになっている間は、キャンペーンコストが発生します。不要なコストを回避するには、完了したらキャンペーンを削除してください。キャンペーンのコストについては、「Amazon Personalize の料金
トピック
自動キャンペーン更新の有効化
キャンペーンを作成するときに、キャンペーンの自動更新を有効にできます。自動更新では、キャンペーンは自動的に更新され、ソリューションの最新の自動または手動でトレーニングされたソリューションバージョンがデプロイされます。これにより、キャンペーンを最新の状態に保つことが容易になります。
例えば、ソリューションが自動トレーニングを使用して 7 日ごとに新しいソリューションバージョンを作成する場合、キャンペーンは自動的に更新され、毎週のトレーニングごとに最新のソリューションバージョンが使用されます。自動キャンペーン更新を使用しない場合は、キャンペーンを手動で更新して、最新のトレーニング済みモデルをデプロイする必要があります。
-
Amazon Personalize コンソールでキャンペーンを作成するときに自動キャンペーン更新を有効にするには、キャンペーンの詳細 でソリューションの最新バージョンを使用するように自動更新を選択します。最新の更新のタイムスタンプは、キャンペーンの詳細ページで確認できます。
詳細については、「キャンペーンの作成 (コンソール)」を参照してください。
-
CreateCampaign API オペレーションの使用時にキャンペーンの自動更新を有効にするには、
SolutionVersionArn
パラメータにソリューションの Amazon リソースネーム (ARN) をSolutionArn/$LATEST
形式で指定します。でcampaignConfig
、enableMetadataInInferenceResponse
を に設定しますtrue
。最新のキャンペーン更新のタイムスタンプを取得するには、 DescribeCampaignAPIオペレーションを使用してレスポンス
latestCampaignUpdate
の詳細を確認します。自動更新を有効にする方法を示すコードサンプルについては、キャンペーンの作成 (AWS CLI)「」または「」を参照してくださいキャンペーンの作成 (AWS SDKs)。
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 の料金
レコメンデーションのアイテムメタデータ
重要
User-Personalization-v2 または Personalized-Ranking-v2 レシピを使用する場合、メタデータの追加コストは発生しません。他のすべてのレシピとすべてのドメインのユースケースでは、追加料金が発生します。詳細については、「Amazon Personalize の料金
レコメンデーションを取得すると、Amazon Personalize にレコメンデーション結果にアイテムメタデータを含めることができます。リクエストでは、含める Items データセットから列を選択できます。Amazon Personalize は、レコメンデーションレスポンス内の各アイテムについてこのデータを返します。
メタデータを使用して、映画のジャンルをカルーセルに追加するなど、ユーザーインターフェイスのレコメンデーションを充実させることができます。あるいは、レコメンデーションの質を視覚的に評価するのにも使えます。アプリで生成 AI を使用している場合は、メタデータを AI プロンプトに組み込んで、より関連性の高いコンテンツを生成できます。Amazon Personalize の生成 AI の使用に関する詳細については、「Amazon Personalize と生成 AI」を参照してください。
メタデータの有効化
レコメンデーションにメタデータを追加するには、メタデータの列を含むアイテムデータセットが必要です。トレーニングではメタデータを使用する必要はありません。データセットの作成については、「スキーマとデータセットの作成」を参照してください。データの更新については、「」を参照してくださいトレーニング後のデータセットのデータの更新。
User-Personalization-v2 または Personalized-Ranking-v2 レシピを使用する場合、キャンペーンにはアイテムメタデータをレコメンデーション結果に含めるオプションが自動的に用意されます。キャンペーンのメタデータを手動で有効にすることはできません。他のすべてのレシピとドメインのユースケースでは、メタデータオプションを有効にする必要があります。
-
Amazon Personalize コンソールでメタデータを有効にするには、キャンペーンを作成するときに、[キャンペーン詳細] の [レコメンデーション結果にあるアイテムのメタデータを返す] を選択します。詳細については、「キャンペーンの作成 (コンソール)」を参照してください。
-
でメタデータを有効にするには AWS SDKs または AWS CLI、 に
campaignConfig
設定された で CreateCampaignAPIオペレーション とenableMetadataInInferenceResponse
を使用しますtrue
。詳細については、キャンペーンの作成 (AWS CLI) または キャンペーンの作成 (AWS SDKs) を参照してください。
キャンペーンの作成 (コンソール)
重要
キャンペーンがアクティブになっている間は、キャンペーンコストが発生します。不要なコストを回避するには、完了したらキャンペーンを削除してください。キャンペーンのコストについては、「Amazon Personalize の料金
ソリューションバージョンのステータスが [Active ] (アクティブ) になったら、Amazon Personalize のキャンペーンでそのソリューションバージョンをデプロイする準備が整います。
キャンペーンを作成するには (コンソール)
-
https://console.aws.amazon.com/personalize/自宅
の Amazon Personalize コンソールを開き、アカウントにサインインします。 -
デプロイするソリューションバージョンを含むデータセットグループを選択します。
-
ナビゲーションペインの [カスタムリソース] で、[キャンペーン] を選択します。
-
[Campaigns] (キャンペーン) のページで、[Create campaign] (キャンペーンを作成) を選択します。
-
[Create new campaign] (新しいキャンペーンを作成) ページの [Campaign details] (キャンペーンの詳細) で、次の情報を入力します。
-
キャンペーン名 - キャンペーンの名前を入力します。ここで入力したテキストは、[Campaign] (キャンペーン) ダッシュボードと詳細のページに表示されます。
-
ソリューション - 先ほど作成したソリューションを選択します。
-
ソリューションの最新のソリューションバージョンを使用するように自動的に更新する – キャンペーンで最新のアクティブなソリューションバージョンを自動的に使用するには、このオプションを選択します。これを選択しない場合は、新しいソリューションバージョンをデプロイするたびにキャンペーンを手動で更新する必要があります。詳細については、「自動キャンペーン更新の有効化」を参照してください。
-
ソリューションバージョン ID – 自動キャンペーン更新を使用して最新のソリューションバージョンを使用しない場合は、デプロイするソリューションバージョンの ID を選択します。
-
1 秒あたりの最小プロビジョニングトランザクション数 ( minProvisionedTPSで呼び出されますAPIs) — Amazon Personalize がサポートする 1 秒あたりの最小プロビジョニングトランザクション数を設定します。値を大きくすると、料金が増加します。1 (デフォルト) から始めることをお勧めします。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、
minProvisionedTPS
必要に応じて を増やします。詳細については、「1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング」を参照してください。 -
レコメンデーション結果にアイテムメタデータを返す – レコメンデーション結果にメタデータを含める場合は、このオプションを選択します。有効にすると、レコメンデーションを取得するときに Items データセットの列を指定できます。詳細については、「レコメンデーションのアイテムメタデータ」を参照してください。
-
-
User-Personalization レシピを使用した場合は、キャンペーン設定 で、オプションで探索の重みと探索項目の経過時間カットオフ の値を入力できます。詳細については、「User-Personalization」を参照してください。
-
[タグ] には、オプションで任意のタグを追加します。Amazon Personalize リソースのタグ付けの詳細については、「Amazon Personalize リソースのタグ付け」を参照してください。
-
[キャンペーンの作成] を選択します。
-
キャンペーンの詳細のページで、キャンペーンのステータスが [Active] (アクティブ) の場合、キャンペーンを使用してレコメンデーションを取得し、インプレッションを記録できます。詳細については、「Amazon Personalize からのレコメンデーションの取得」を参照してください。
キャンペーンのステータスが になると、キャンペーンの準備が整いますACTIVE。ソリューションバージョンを再トレーニングする場合、またはキャンペーン設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「Amazon Personalize キャンペーンの設定の更新」を参照してください。
キャンペーンの作成 (AWS CLI)
重要
キャンペーンがアクティブになっている間は、キャンペーンコストが発生します。不要なコストを回避するには、完了したらキャンペーンを削除してください。キャンペーンのコストについては、「Amazon Personalize の料金
ソリューションバージョンがアクティブになったら、Amazon Personalize キャンペーンでデプロイする準備が整います。を使用してキャンペーンを作成するには AWS CLI、 create-campaign
コマンドを使用します。
次のコードサンプルは、キャンペーンを作成する方法を示しています。User-Personalization レシピを使用するソリューションの最新バージョンをデプロイします。作成するキャンペーンは、将来のソリューションバージョンを使用するように自動的に更新されます。このコードでは、次の設定を使用します。
-
ソリューションの最新のソリューションバージョンを使用するように自動的に更新するようにキャンペーンを設定します。
solution-version-arn
は
形式、 はsolution ARN
/$LATESTsyncWithLatestSolutionVersion
ですTrue
。コードを使用するには、 をソリューションの Amazon リソースネーム (ARN)solution ARN
に置き換えます。自動 を無効にするには
syncWithLatestSolutionVersion
、ソリューションバージョン ARN ( なし/$LATEST
) のみを指定し、syncWithLatestSolutionVersion
を に設定しますFalse
。 -
enableMetadataWithRecommendations
オプションを に設定しますTrue
。これにより、レコメンデーションリクエストオプションにアイテムデータセットのアイテムメタデータをレコメンデーション結果に含めることができます。このオプションを無効にするには、 に設定しますFalse
。詳細については、「レコメンデーションのアイテムメタデータ」を参照してください。 -
min-provisioned-tps
は 1 (デフォルト) に設定されます。最初はminProvisionedTPS
に 1 を使用することをお勧めします (デフォルト)。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、minProvisionedTPS
必要に応じて を増やします。詳細については、「1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング」を参照してください。
すべてのパラメータの詳細なリストについては、「CreateCampaign」を参照してください。
aws personalize create-campaign \ --name
campaign-name
\ --solution-version-arnsolution-arn
/\$LATEST \ --min-provisioned-tps 1 \ --campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"
キャンペーンのステータスが になると、キャンペーンの準備が整いますACTIVE。現在のステータスを取得するには、DescribeCampaign を呼び出して、status
フィールドが ACTIVE
であることを確認します。
ソリューションバージョンを再トレーニングし、最新のソリューションバージョンを使用するようにキャンペーンが自動的に更新されない場合、またはキャンペーン設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「Amazon Personalize キャンペーンの設定の更新」を参照してください。
Amazon Personalize では、作成したキャンペーンを一覧表示ListCampaignsするなど、キャンペーンを管理するためのオペレーションを利用できます。キャンペーンを削除するには、DeleteCampaign を呼び出します。キャンペーンを削除しても、キャンペーンの一部であるソリューションバージョンは削除されません。
キャンペーンを作成したら、それを使用してレコメンデーションを作成できます。詳細については、「Amazon Personalize からのレコメンデーションの取得」を参照してください。
キャンペーンの作成 (AWS SDKs)
重要
キャンペーンがアクティブになっている間は、キャンペーンコストが発生します。不要なコストを回避するには、完了したらキャンペーンを削除してください。キャンペーンのコストについては、「Amazon Personalize の料金
ソリューションバージョンがアクティブになったら、Amazon Personalize キャンペーンでデプロイする準備が整います。でキャンペーンを作成するには AWS SDKs、 CreateCampaignAPIオペレーションを使用します。
次のコードサンプルは、キャンペーンを作成する方法を示しています。このコードは、User-Personalization レシピを使用するソリューションの最新バージョンをデプロイします。作成するキャンペーンは、将来のソリューションバージョンを使用するように自動的に更新されます。このコードでは、次の設定を使用します。
-
ソリューションの最新のソリューションバージョンを使用するように自動的に更新するようにキャンペーンを設定します。
solutionVersionArn
は
形式、 はsolution ARN
/$LATESTsyncWithLatestSolutionVersion
ですTrue
。コードを使用するには、 をソリューションバージョンの Amazon リソースネーム (ARN)solution ARN
に置き換えます。自動 を無効にするには
syncWithLatestSolutionVersion
、ソリューションバージョン ARN ( なし/$LATEST
) のみを指定し、syncWithLatestSolutionVersion
を に設定しますFalse
。 -
enableMetadataWithRecommendations
オプションを に設定しますTrue
。これにより、レコメンデーションリクエストオプションにアイテムデータセットのアイテムメタデータをレコメンデーション結果に含めることができます。このオプションを無効にするには、 に設定しますFalse
。詳細については、「レコメンデーションのアイテムメタデータ」を参照してください。 -
minProvisionedTPS
は 1 (デフォルト) に設定されます。(minProvisionedTPS
デフォルト) には 1 から始めることをお勧めします。Amazon CloudWatch メトリクスを使用して使用状況を追跡し、minProvisionedTPS
必要に応じて を増やします。詳細については、「1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング」を参照してください。
すべてのパラメータの詳細なリストについては、「CreateCampaign」を参照してください。
キャンペーンのステータスが になると、キャンペーンの準備が整いますACTIVE。現在のステータスを取得するには、 を呼び出しDescribeCampaign、 status
フィールドが であることを確認しますACTIVE
。
ソリューションバージョンを手動で再トレーニングする場合、またはキャンペーン設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「Amazon Personalize キャンペーンの設定の更新」を参照してください。
Amazon Personalize では、作成したキャンペーンを一覧表示ListCampaignsするなど、キャンペーンを管理するためのオペレーションを利用できます。キャンペーンを削除するには、DeleteCampaign を呼び出します。キャンペーンを削除しても、キャンペーンの一部であるソリューションバージョンは削除されません。
キャンペーンを作成したら、これを使用して推奨を行うことができます。詳細については、「Amazon Personalize からのレコメンデーションの取得」を参照してください。