翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタムリソースを使用したバッチユーザーセグメントの取得
<a name="getting-user-segments"></a>

 *ユーザーセグメント*取得するには、バッチセグメントジョブを使用します。*バッチセグメントジョブ*は、Amazon S3 バケットからバッチ入力データをインポートし、USER\_SEGMENTATION レシピでトレーニングされたソリューションバージョンを使用して、入力データの各行の*ユーザーセグメント*を生成するツールです。

レシピに応じて、入力データはアイテムまたはアイテムメタデータ属性のリスト (JSON 形式) です。アイテム属性については、入力データに、複数のメタデータ属性に基づいてユーザーセグメントを作成するための式を含めることができます。バッチセグメントジョブは、出力の Amazon S3 バケットにユーザーセグメントをエクスポートします。各ユーザーセグメントは、各ユーザーが入力データ内のアイテムを操作する蓋然性に基づいて、降順にソートされます。

ユーザーセグメントを生成する際、Amazon Personalize は、一括インポートと個別インポートのデータセット内のデータを考慮します。
+ バルクデータの場合、Amazon Personalize は前回のフルソリューションバージョントレーニングで提示されたバルクデータのみを使用してセグメントを生成します。また、インポートモードが FULL で (既存のデータを置き換えて) インポートしたバルクデータのみを使用します。
+ 個々のデータインポートオペレーションのデータについては、Amazon Personalize は前回のフルソリューションバージョントレーニングで得られたデータを使用してユーザーセグメントを生成します。新しいレコードがユーザーセグメントに影響を与えるには、新しいソリューションバージョンを作成してから、バッチセグメントジョブを作成します。

ユーザーセグメントの生成は次のように行われます。

1.  入力データを JSON 形式で準備して Amazon S3 バケットにアップロードします。入力データの形式は、使用するレシピと作成するジョブによって異なります。「[ユーザーセグメントの入力データを準備しています。](prepare-input-data-user-segment.md)」を参照してください。

1.  フォルダまたは別の Amazon S3 バケットのいずれかで、出力データ用に個別の場所を作成します。

1.  バッチセグメントジョブを作成します。「[バッチセグメントジョブを使用してユーザーセグメントを取得する](creating-batch-seg-job.md)」を参照してください。

1.  バッチセグメントジョブが完了したら、Amazon S3 の出力場所からユーザーセグメントを取得します。

**Topics**
+ [ユーザーセグメントを取得するためのガイドラインと要件](#batch-seg-permissions-req)
+ [ユーザーセグメントの入力データを準備しています。](prepare-input-data-user-segment.md)
+ [バッチセグメントジョブを使用してユーザーセグメントを取得する](creating-batch-seg-job.md)
+ [バッチセグメントジョブの出力形式例](batch-segment-job-output-examples.md)

## ユーザーセグメントを取得するためのガイドラインと要件
<a name="batch-seg-permissions-req"></a>

バッチセグメントを一括取得するためのガイドラインと要件は次のとおりです。
+  USER\_SEGMENTATION レシピを使用する必要があります。
+ 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 のキャンペーンを作成する必要はありません。ドメインデータセットグループを作成した場合は、引き続きカスタムリソースを作成できます。
+  入力データは、「[ユーザーセグメントの入力データを準備しています。](prepare-input-data-user-segment.md)」で説明されている形式にする必要があります。
+  Item-Attribute-Affinity レシピを使用する場合、入力データの属性に、製品の説明などの非構造化テキストのアイテムメタデータを含めることはできません。
+ プレースホルダーパラメータを含むフィルタを使用する場合は、`filterValues` オブジェクトの入力データにパラメータの値を含める必要があります。詳細については、「[入力 JSON にフィルター値を指定します。](filter-batch.md#providing-filter-values)」を参照してください。
+ 出力データには入力データとは異なるの場所 (フォルダまたは別の Amazon S3 バケット) を使用することをお勧めします。