これは、Recommendations AI、Retail Search、新しい Retail コンソールに関するドキュメントです。

属性を構成する

Retail Search では、インデックス登録、動的ファセット、検索可能性を高めるために商品属性を活用できます。このページでは、これらの構成の設定と、使用する方法と構成に応じた Retail Search での処理方法について説明します。

属性タイプ

商品の属性はタイプによって、デフォルト設定や許可されるオプションが異なります。

  • システム属性: 事前定義されたシステム属性は既存の Product フィールドであり、商品に関する詳細情報を提供します。ブランド、在庫状況、色、サイズなどの商品属性が含まれます。プロダクトで使用可能なすべてのシステム属性については、Product リファレンス ドキュメントをご覧ください。

  • カスタム属性: カスタム属性は、Product.attributes フィールドで定義する追加の属性です。たとえば、店舗名、ベンダー、スタイルなどがあります。カスタム属性の例と制限については、Product.attributes リファレンス ドキュメントをご覧ください。

  • 在庫レベルの属性: 商品に関する店舗レベルの情報を提供するシステム属性またはカスタム属性。在庫レベルの属性は、店舗や地域によって特性が大きく異なる商品(食料品店など)や、店舗固有のプロモーションがある商品に使用します。

    inventories.priceinventories.originalPrice は、Retail API によって事前定義されている数値システム属性です。カスタム在庫レベル属性(テキストまたは数値)を作成できます。在庫レベルの属性は、デフォルトでインデックスに登録できます。在庫レベルの属性では、検索可能および動的ファセットの設定はサポートされていません。

利用可能な構成設定

次のタイプの属性構成を有効または無効にできます。

  • Indexable: この属性を使用すると、Retail Search でフィルタを使用してファセットをフィルタリングできます。
  • 動的ファセット: Retail Search では、ユーザーの過去の操作(ファセットのクリックや表示など)に基づいて、この属性が動的ファセットとして自動的に使用されます。属性の動的ファセットを有効にするには、その属性の Indexable を true に設定する必要があります。
  • 検索可能: この属性は Retail Search クエリで検索できます。これによって、この属性の再現率が向上します。このコントロールは、テキスト属性にのみ適用されます。

Indexable

属性がインデックス登録可能に設定されている場合、Retail Search はその属性を使用してフィルタリングやファセットを行います。

  • システム属性: 事前定義されたシステム属性に対して常にインデックス化が有効になっています。この設定は、システム属性に対して無効にすることはできません。
  • カスタム属性: デフォルトで有効になっています。任意のカスタム属性でインデックス化を無効にできます。カスタム属性をインデックス登録可能にする場合は、正規表現パターン [a-zA-Z0-9][a-zA-Z0-9_]* に従う必要があります。たとえば、key0LikeThisKEY_1_LIKE_THIS です。
  • 在庫レベルの属性: システム在庫レベルの属性に対して常に有効になります。この設定を変更することはできません。カスタム在庫レベルの属性では、デフォルトで有効になっています。この設定をオフにできます。
  • 依存関係: 該当なし

インデックス登録可能な属性の構成設定の変更は、12 時間以内、または次回のカタログ取り込み直後に有効になります。変更が適用されたかどうかは、[評価] ページでテストできます。

動的ファセット

属性の動的ファセットが有効になっている場合、Retail Search ではその属性を動的ファセットとして使用できます。動的ファセットは、ファセットのクリックやビューなど、ユーザーの過去の行動に基づいて自動的に検索に追加できます。

  • システム属性: インデックス化が true に設定されている場合は、デフォルトで有効になっています。任意のシステム属性で動的ファセットを無効にできます。
  • カスタム属性: インデックス化が true に設定されている場合は、デフォルトで有効になっています。動的ファセットは、任意のカスタム属性で無効にできます。
  • 在庫レベルの属性: サポートされていません。
  • 依存関係: 属性の動的ファセットを有効にするには、まずその属性のインデックス化を有効にする必要があります。

属性の動的ファセットの設定は常にグローバルです。この属性に適用された動的ファセット構成は、その属性を使用するカタログ内のプロダクトで使用されます。

動的ファセット構成の変更は最大 2 日かかります。変更が適用されたかどうかは、[評価] ページでテストできます。

数値のカスタム属性の場合、リクエスト内でバケットを指定する必要があります。数値は自動的にバケット化されません。

検索可能

属性を検索可能に設定すると、Retail Search クエリでその属性の再現率が向上します。

検索可能性を有効にできるのは、テキスト形式の属性値のみです。数値属性には適用されません。

  • システム属性: Product の事前定義されたテキスト システム属性は常に検索可能です。この設定は変更できません。
  • カスタム属性: デフォルトで無効になっています。この構成は、任意のテキスト カスタム属性に対して有効にできます。
  • 在庫レベルの属性: サポートされていません。
  • 依存関係: 該当なし

検索可能な属性を持つ商品は、その属性の検索結果に表示される保証はありません。

構成モード

Retail API が設定されている構成モードによって、属性構成の処理方法と設定可能な属性構成が決まります。

  • カタログレベルの構成モード(デフォルト): このモードでは、カタログレベルの属性構成が信頼できる情報源として使用されます。
  • 商品レベルの構成モード(非推奨): このモードでは、商品レベルの属性構成が信頼できる情報源として使用されます。

以前は、商品レベルの構成がデフォルトのモードでした。まだ商品レベルの構成モードを使用していて、カタログレベルの構成モードに切り替える必要がある場合は、Retail サポートにお問い合わせください。Retail Search は、切り替え後に商品レベルの構成モードに戻ることをサポートしていません。

構成モードを確認するには、Retail コンソールの [コントロール] ページに移動します。[サイト全体のコントロール] タブで [インデックス登録可能] オプションが列として使用されている場合、Retail API はカタログレベルの構成モードになっています。[サイト全体のコントロール] タブで [インデックス登録可能] 列がない場合、Retail API は商品レベルの構成モードです。

構成メソッド

属性の構成は次の方法で設定できます。

  • Retail Cloud Console: Cloud Console を使用して、カタログレベルで属性の構成を構成します。これにより、すべての商品の属性がグローバルに構成されます。コンソールでどちらの設定方法を使用できるかは、Retail Search に設定されている構成モードによって異なります。

  • Product API メソッド(非推奨): Product API メソッドを使用して、商品レベルでカスタム属性を設定します。このメソッドを使用して属性を設定することは、新しい Retail API ユーザーには利用できないため、おすすめしません。

コンソールで属性を構成する

サイト全体のコントロールタブの Retail コンソールコントロールページからすべての商品の属性オプションをグローバルに設定できます。コンソールでこれを設定する方法について詳しくは、サイト全体の属性コントロールを設定するをご覧ください。

この機能を使用するには、Retail API がカタログレベルの構成モードになっている必要があります。

Indexable と検索可能についての属性構成の設定の変更は、12 時間以内、または次回のカタログ取り込み直後に有効になります。動的ファセット構成の変更は最大 2 日かかります。変更が適用されたかどうかは、[評価] ページでテストできます。

AttributesConfig で属性を構成する

AttributesConfig API リソースを使用すると、カタログレベルで属性構成を管理できます。

次のフィールドは、カタログレベルで属性オプションを設定します。

すべての属性構成を取得するには、GetAttributesConfig メソッドを使用します。

複数の属性の更新

カタログレベルで複数の属性を更新するには、updateAttributesConfig メソッドを使用します。

リクエストに含めるカタログ属性は、カタログで更新されるか、存在しない場合は挿入されます。カタログ属性フィールドに値がない場合は、デフォルト値が割り当てられます。

1 つのリクエストで許可されるカタログ属性の最大数は 1,000 です。

個々の属性の更新

個々のカタログ属性を更新するには、次のメソッドを使用します。

AddCatalogAttribute: 個々の属性の構成をカタログ属性に追加します。

AddCatalogAttribute の API リファレンス ドキュメントをご覧ください。

ReplaceCatalogAttribute: 個々の属性の構成を変更します。これにより、AttributesConfig 内の指定した CatalogAttribute が、同じ CatalogAttribute.key でカタログ属性が更新されます。

ReplaceCatalogAttribute の API リファレンス ドキュメントをご覧ください。

RemoveCatalogAttribute: 個々の属性の構成を AttributesConfig から削除します。

削除できるのは、商品で使用されていない CatalogAttributes のみです。CatalogAttribute が使用されている場合、RemoveCatalogAttribute はそれを削除しませんが、その構成プロパティをデフォルト値にリセットします。属性がいずれかの商品で使用されている場合、CatalogAttribute.inUseTrue に設定されます。

RemoveCatalogAttribute の API リファレンス ドキュメントをご覧ください。

Product メソッドで属性を構成する(非推奨)

このメソッドを使用して属性を設定することは、新しい Retail API ユーザーには利用できないため、おすすめしません。

次のフィールドでは、Product API メソッドを使用して、特定の商品のインデックス登録可能な設定と検索可能な設定を設定します。

Product メソッドで属性を構成する(非推奨)

このメソッドを使用して属性を設定することは、新しい Retail API ユーザーには利用できないため、おすすめしません。

次のフィールドでは、Product API メソッドを使用して、特定の商品のインデックス登録可能な設定と検索可能な設定を設定します。