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

フィルター基準を満たすアイテムのみにレコメンデーションを制限するために INCLUDE を使用するか、またはフィルター基準を満たす、すべてのアイテムを削除するために EXCLUDE を使用します。

これらの要素のいずれかを INCLUDE または EXCLUDE 要素の後で使用します。使用する要素は、アイテム (アイテムレコメンデーション)、アクション (アクションレコメンデーション)、またはユーザー (ユーザーセグメント) のどれをフィルタリングするかによって異なります。

アイテム、アクション、またはユーザーの条件を確認するには、WHERE を使用します。WHERE 要素は、ItemID、ActionID、または UserID の後で使用する必要があります。

同じフィルター式内で複数の条件を連鎖させるには、AND または OR を使用します。AND または OR を使用して組み合わせられた条件は、最初の条件で使用されたデータセットのフィールドにのみ影響を及ぼすことができます。

dataset.field 形式でレコメンデーションをフィルタリングするデータセットとメタデータフィールドを指定します。例えば、Items データセットの genres フィールドに基づいてアイテムレコメンデーションをフィルタリングするには、フィルター式で Items.genres を使用します。

IF 条件は、式の最後で 1 回だけ、CurrentUser の条件をチェックするためにのみ使用してください。ただし、AND を使用して IF 条件を拡張できます。

レコメンデーションを取得しようとしているユーザーに基づいてアイテムのレコメンデーションをフィルタリングするには、IF 条件でのみ、CurrentUser を使用してユーザーフィールドを指定します。例えば、CurrentUser.AGE と指定します。

関連アイテムのレシピとユースケースにのみには、CurrentItem.attribute を使用して、関連商品のレコメンデーションのリクエストで指定した商品の属性に基づいて商品を絞り込むことができます。例えば、CurrentItem.GENRE、CurrentItem.PRICE などです。

ドメインユースケースまたはカスタムレシピが、類似アイテムレシピや More Like X ドメインユースケースなどの関連アイテムのレコメンデーションを生成する場合にのみ、 CurrentItem 要素でフィルターを適用できます。CurrentItem 要素を含むフィルターを初めて作成する場合、フィルタの作成には数分かかることがあります。暗号化 AWS KMS に を使用する場合、フィルターの作成には最大 15 分かかることがあります。

IN または NOT IN を比較演算子として使用して、1 つ以上の文字列値の一致 (または不一致) に基づいてフィルタリングします。Amazon Personalize は、正確な文字列に対してのみフィルターを適用します。

=、＜、<=、＞、>=、!= 演算子を使用して、プレースホルダーパラメータに渡されたデータを含む数値データを等価性についてテストします。

すべてのタイプのインタラクションを含めたり、除外したりするために * を使用します。Interactions データセットの EVENT_TYPE フィールドを使用するフィルター式にのみ * を使用します。

パイプ区切り文字 (|) を使用して、複数の式を連鎖します。詳細については、「複数の式の組み合わせ」を参照してください。

比較演算子または IN 演算子を使用する式の場合、ドル記号 ($) とパラメータ名を使用して、プレースホルダーパラメータを値として追加します。例えば、$GENRES と指定します。この例では、レコメンデーションを取得する際に、フィルタリングする 1 つまたは複数のジャンルを指定します。