翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# カスタムリソースを使用したバッチアイテムのレコメンデーションの取得
カスタムリソースを使用すると、非同期のバッチフローでアイテムのレコメンデーションを取得できます。例えば、メールリストに登録されている全ユーザー向けの商品レコメンデーション度や、在庫全体での[アイテム間の類似度](native-recipe-similar-items.md)などを取得できます。
バッチレコメンデーションを取得するには、バッチ推論ジョブを使用します。*バッチ推論ジョブ*は、Amazon S3 バケットからバッチ入力データをインポートし、ソリューションバージョンを使用して*アイテムのレコメンデーション*を生成してから、そのレコメンデーションを Amazon S3 バケットにエクスポートするツールです。レシピに応じて、入力データは、ユーザーもしくはアイテムのリスト、またはそれぞれがアイテムのコレクションを持つユーザーのリストです。
ソリューションが Similar Items レシピを使用し、Items データセットにテキストデータとアイテムタイトルデータがある場合、アイテムグループごとにテーマ付きのバッチレコメンデーションを生成できます。詳細については、「[Content Generator のテーマ付きバッチレコメンデーション](themed-batch-recommendations.md)」を参照してください。
カスタムソリューションバージョンを作成した後、新しいデータがバッチアイテムのレコメンデーションにどのように影響するかは、タイプ、インポート方法、使用するカスタムレシピによって異なります。新しいデータがバッチレコメンデーションにどのように影響するかについては、「[新しいデータがバッチレコメンデーションに与える影響 (カスタムリソース)](how-new-data-influences-batch-recommendations.md)」を参照してください。
**Topics**
+ [バッチワークフロー](#batch-worfklow-steps)
+ [ガイドラインと要件](#batch-permissions-req)
+ [バッチワークフローのスコアリング](#batch-scoring)
+ [Content Generator のテーマ付きバッチレコメンデーション](themed-batch-recommendations.md)
+ [バッチレコメンデーション用の入力データを準備します。](batch-data-upload.md)
+ [バッチ推論ジョブの作成](creating-batch-inference-job.md)
+ [Batch 推論ジョブの出力例](batch-inference-job-output-examples.md)
## バッチワークフロー
バッチワークフローは次のとおりです。
1. 入力データを JSON 形式で準備して Amazon S3 バケットにアップロードします。入力データの形式は、使用するレシピによって異なります。「[バッチレコメンデーション用の入力データを準備します。](batch-data-upload.md)」を参照してください。
1. フォルダまたは別の Amazon S3 バケットのいずれかで、出力データ用に個別の場所を作成します。
1. バッチ推論ジョブを作成します。「[バッチ推論ジョブの作成](creating-batch-inference-job.md)」を参照してください。
1. バッチ推論が完了したら、Amazon S3 の出力場所からアイテムのレコメンデーションを取得します。
## ガイドラインと要件
バッチレコメンデーションを取得するためのガイドラインと要件は次のとおりです。
+ Amazon Personalize の IAM サービスロールには、Amazon S3 バケットを読み取り、ファイルを追加するための許可が必要です。許可の付与については、「[バッチワークフロー用のサービスロールのポリシー](granting-personalize-s3-access.md#role-policy-for-batch-workflows)」を参照してください。バケットの許可の詳細については、**「Amazon Simple Storage Service デベロッパーガイド」の「[ユーザーポリシーの例](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html)」を参照してください。暗号化に AWS Key Management Service (AWS KMS) を使用している場合は、Amazon Personalize および Amazon Personalize IAM サービスロールにキーを使用するためのアクセス許可を付与する必要があります。詳細については、「[AWS KMS キーを使用するためのアクセス許可を Amazon Personalize に付与する](granting-personalize-key-access.md)」を参照してください。
+ バッチ推論ジョブを作成する前に、カスタムソリューションとソリューションバージョンを作成する必要があります。ただし、Amazon Personalize のキャンペーンを作成する必要はありません。ドメインデータセットグループを作成した場合は、引き続きカスタムリソースを作成できます。
+ テーマ付きバッチレコメンデーションを生成するには、Similar-Items レシピを使用する必要があります。また、テキストデータとアイテムタイトルデータを含むアイテムデータセットが必要です。テーマ別レコメンデーションの詳細については、「[Content Generator のテーマ付きバッチレコメンデーション](themed-batch-recommendations.md)」を参照してください。
+ 入力データは、「[ユーザーセグメントの入力データを準備しています。](prepare-input-data-user-segment.md)」で説明されている形式にする必要があります。
+ Trending-Now レシピまたは Next-Best-Action レシピではバッチレコメンデーションを取得することはできません。
+ プレースホルダーパラメータを含むフィルタを使用する場合は、`filterValues` オブジェクトの入力データにパラメータの値を含める必要があります。詳細については、「[入力 JSON にフィルター値を指定します。](filter-batch.md#providing-filter-values)」を参照してください。
+ 出力データには入力データとは異なるの場所 (フォルダまたは別の Amazon S3 バケット) を使用することをお勧めします。
+ バッチレコメンデーションは、リアルタイムレコメンデーションとまったく同じではない場合があります。これは、バッチ推論ジョブの完了に時間がかかり、ジョブの開始の 15 分前に利用可能なデータのみを考慮するためです。
## バッチワークフローのスコアリング
バッチレコメンデーションには、次のようなスコアが含まれます。
+ Amazon Personalize は、ユーザーパーソナライゼーションレシピとパーソナライズランキングレシピを使用して、[レコメンデーションスコアの仕組み (カスタムリソース)](recommendations.md#how-recommendation-scoring-works) および [パーソナライズされたランキングスコアリングの仕組み](rankings.md#how-ranking-scoring-works) で説明されているようにバッチ推論ジョブの推奨スコアを計算します。バッチ推論ジョブの出力 JSON ファイルでスコアを表示できます。
+ Similar-Items レシピでテーマ別のバッチレコメンデーションを取得する場合、Amazon Personalize は、各アイテムに対するテーマの関連性に基づいて関連アイテムの各セットをランク付けします。各アイテムには 0～1 のスコアが含まれます。スコアが高いほど、そのアイテムはテーマと密接に関連していることになります。テーマ付きレコメンデーションの詳細については、「[Content Generator のテーマ付きバッチレコメンデーション](themed-batch-recommendations.md)」を参照してください。