フィルタ式

フィルターを設定するには、適切にフォーマットされたフィルター式を使用する必要があります。フィルター式は、論理演算子、キーワード、および値とともに、dataset.field フォーマットのデータセットとフィールド識別子で構成されます。値については、固定値を指定するか、プレースホルダーパラメータを追加して、レコメンデーションを取得する際にフィルター基準を設定できます。

フィルター式を使用して、以下のデータセットのデータに基づいて、レコメンデーションからアイテム、ユーザー、またはアクションをフィルタリングできます。

• アイテムインタラクション: フィルター式を使用して、インタラクションデータに基づいてアイテムまたはユーザーを含めたり除外したりできます。例えば、ユーザーが既にクリックしたアイテムを除外したり (アイテムレコメンデーションの場合)、アイテムが評価されたユーザーのみを含めることができます (Item-Affinity レシピの場合)。すべてのレシピタイプで、イベントタイプに基づいてのみフィルタリングできます。コンテキストメタデータなど、他のインタラクションメタデータに基づいてフィルタリングすることはできません。アイテムインタラクションフィルターは、Item-Attribute-Affinity レシピ と併用することはできません。

  Amazon Personalize は、イベントタイプごとに、ユーザー 1 人あたり最大 100 件の最新のインタラクションを考慮します。これは調整可能なクォータです。Service Quotas コンソールを使用してクォータの増加をリクエストできます。ユーザーのアイテムインタラクションを 3 か月間インポートしない場合、フィルターはユーザーの履歴データを考慮しなくなります。このデータを考慮するには、ユーザーのイベント履歴全体を再度インポートする必要があります。

• アクションインタラクション: フィルター式を使用して、ユーザーがイベントタイプに基づいて操作したアクションを含めたり除外したりします。例えば、ユーザーが既に実行したアクションを除外できます。他のアクションインタラクションメタデータに基づいてフィルタリングすることはできません。

  Amazon Personalize は、イベントタイプごとに、ユーザー 1 人あたり最大 300 件の最新のアクションインタラクションを考慮します。これは調整可能なクォータです。Service Quotas コンソールを使用してクォータの増加をリクエストできます。

• Items: フィルター式を使用して、特定のアイテム条件に基づいてアイテムを含めたり除外したりします。フィルターを使用して、商品の説明などの構造化されていないテキストのアイテムメタデータに基づいてアイテムを含めたり、除外したりすることはできません。Similar-Items レシピや More Like X ドメインユースケースなど、ドメインのユースケースやカスタムレシピが関連アイテムのレコメンデーションを生成する場合、レコメンデーションリクエストで指定したアイテムのプロパティに基づいて、フィルター式を使用してアイテムを含めたり除外したりできます。

• Users: アイテムおよびアクションレコメンデーションの場合、Users データセットがあれば、CurrentUser に基づいてアイテムやアクションを除外したり含めたりできます。パーソナライズされたレコメンデーション、人気アイテム、およびアクションレコメンデーションの場合、これは、レコメンデーションを受けるユーザーです。関連アイテムの場合、これはレコメンデーションリクエストで指定できるオプションのユーザーです。

  ユーザーセグメントについては、フィルター式を使用して、Users.MEMBERSHIP_STATUS などの属性に基づいてユーザーをユーザーセグメントに含めたり、ユーザーセグメントから除外したりできます。

• Actions: フィルター式を使用して、特定のアクション条件に基づいて、アクションを含めたり除外したりします。Amazon Personalize は、Action expiration timestamp および Repeat frequency データに基づくアクションを自動的に除外します。このデータに基づいてフィルタリングする追加のカスタムフィルターを作成することはできません。

フィルター式の要素の詳細なリストについては、「フィルター式の要素」を参照してください。フィルター式の例については、「フィルター式の例」を参照してください。

トピック

• ガイドラインと要件

• フィルター式の構造と要素

• フィルター式の例