ドキュメントCommerceLive Search ガイド

PaaS のみ

Live Search で成功するための設定

最終更新日: 2025年5月6日
  • トピック:
  • 検索

作成対象:

  • 管理者
  • 開発者

Adobe Commerce Live Search と Catalog Service は連携して、パフォーマンスが高く関連性の高い直感的な検索ソリューションを提供し、顧客が必要なものを正確かつ迅速に見つけられるようにします。 特に、Catalog Service は、使用する Live Search など、SaaS サービスのカタログデータを表示します。

この記事では、Catalog Service で Live Search を実装する手順を順を追って説明します。

IMPORTANT
サイト検索に関しては、Adobe Systemsコマースにはオプションがあります。 実装する前に 境界と制限 を必ず読み、 Live Search がビジネスニーズに適合していることを確認してください。

オーディエンス

この記事は、Adobe Systems Commerce インスタンスのインストールと構成を担当するチーム開発者またはシステム インテグレーターを対象としています。

必要条件

  • Adobe Commerce 2.4.4 以降
  • PHP バージョン 8.1、8.2、または 8.3
  • Composer

サポートされるプラットフォーム

  • クラウド上のAdobe Commerce(ECE) :2.4.4 以降
  • Adobe Commerce オンプレミス(EE) :2.4.4 以降

ワークフローの概要

大まかに言えば、オンボーディング Live Search では、次の操作が必要です。

  1. Live Search 拡張機能の インストール
  2. API キーの 設定
  3. カタログデータの 同期
  4. カタログ データがエクスポートされたことを 確認します
  5. データ 🔗 設定)
  6. テスト接続
  7. イベントでデータがキャプチャされていることを 確認します
  8. ストアフロントの カスタマイズ

1. Live Search 拡張機能をインストールする

Live Search は、Adobe Marketplace} から {Composer を通じて拡張機能と 🔗 てインストールさ ます。 Live Search をインストールして設定すると、Adobe Commerce は検索とカタログデータの SaaS サービスとの共有を開始します。 この時点で、管理者 ユーザーは、検索ファセット、同義語およびマーチャンダイジングルールの設定、カスタマイズおよび管理を行うことができます。

NOTE
Live Search 3.0.2 の時点では、Catalog Service 拡張機能は Live Search インストールにバンドルされています。
IMPORTANT
Live Search 4.0.0 以降、検索アダプタは非推奨になりました。 今後、検索アダプタは、セキュリティ上の問題に対処するためにのみ更新されます。
  1. cron ジョブと インデクサーが実行中であることを確認します。

    IMPORTANT
    2023 年 8 月のElasticsearch 7 のサポート終了のお知らせに伴い、Adobe Commerceをご利用のすべてのお客様に OpenSearch 2.x 検索エンジンを利用することをお勧めします。 製品のアップグレード中に検索エンジンを移行する方法については、 アップグレード ガイドの OpenSearch への移行 を参照してください。
  2. Adobe Marketplace から live-search パッケージをダウンロードします。

  3. コマンドラインから次を実行します。

    composer require magento/live-search
    

    Live Search 拡張機能を 新規 Adobe Commerceのインストールに追加する場合は、次のコマンドを実行して、OpenSearch および関連モジュールを一時的に無効にし、Live Search をインストールします。 次に、手順 4 に進みます。

       bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch7 Magento_OpenSearch Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch Magento_ElasticsearchCatalogPermissionsGraphQl
    

    Live Search拡張機能を​ 既存の Adobe Systems Commerce インストールに追加する場合は、次のコマンドを実行して、ストアフロント検索の結果を提供するLive Searchモジュールを無効にします。次に、手順 4 に進みます。

       bin/magento module:disable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover Magento_LiveSearchProductListing
    

    ElasticsearchLive Searchサービスがカタログデータを同期し、製品のインデックスをバックグラウンドで作成している間、ストアフロントからの検索リクエストを引き続き管理します。

  4. 以下を実行します。

    bin/magento setup:upgrade
    
  5. 次の インデクサー が「Update by スケジュール」に設定されていることを確認します。

    • 製品フィード
    • 製品バリアントフィード
    • カタログ属性フィード
    • 商品価格フィード
    • 範囲 Web サイトデータフィード
    • 顧客グループデータフィードの範囲
    • カテゴリフィード
    • カテゴリ権限フィード
  6. 新しいCommerce インスタンスに Live Search をインストールする場合は、作業が完了し、2 にスキップできます。 API キーを設定セクション。 Live Search を既存のCommerce インスタンスにインストールする場合は、次の手順に進んでください。

  7. 次のコマンドを実行して、Live Search 拡張機能を有効にし、OpenSearch を無効にして、setup を実行します。

    bin/magento module:enable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover  Magento_LiveSearchProductListing
    
    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_ElasticsearchCatalogPermissions Magento_InventoryElasticsearch
    Magento_ElasticsearchCatalogPermissionsGraphQl
    
    bin/magento setup:upgrade
    

Live Search ベータ版のインストール

IMPORTANT
次の機能はベータ版です。 ベータ版に参加するには、 commerce-storefront-services に電子メールリクエストを送信してください。

このベータ版では、🔗 の 3 つの新しい機能が productSearch クエリでサポートされています。

  • 階層化された検索 - 別の検索コンテキスト内でSearch - この機能を使用すると、検索クエリに対して最大 2 層の検索を実行できます。 例:

    • レイヤー 1 検索 - 「product_attribute_1」の「モーター」のSearch。
    • レイヤー 2 検索 - 「product_attribute_2」の「部品番号123」のSearch。 この例では、"モーター" の結果内で "部品番号 123" を検索します。

    レイヤー検索は、以下に説明するように、startsWith 検索インデックスと contains 検索インデックスの両方で使用できます。

  • startsWith 検索インデックス付け - startsWith インデックス付けを使用して検索します。 この新機能により、次のことが可能になります。

    • 属性値が特定の文字列で始まる製品の検索。
    • 「次で終わる」検索の設定による、買い物客での属性値が特定の文字列で終わる製品の検索。 「次で終わる」検索を有効にするには、製品属性を逆に取り込む必要があり、API 呼び出しも逆の文字列にする必要があります。
  • contains search indexation -contains indexation を使用して属性を検索します。 この新機能により、次のことが可能になります。

    • より大きな文字列内のクエリを検索する。 たとえば、買い物客文字列 "HAPE-123" 内の製品番号 "PE-123" を検索するとします。

      • 注: この検索タイプは、オートコンプリート検索を実行する既存の フレーズ 検索 とは異なります。 たとえば、商品属性値が「アウトドアパンツ」の場合、フレーズ検索は「アウトパン」の応答を返しますが、「oor ants」の応答は返しません。 ただし、A contains検索は「oor ants」の応答を返します。

これらの新しい条件により、検索クエリのフィルタリングメカニズムが強化され、検索結果を絞り込むことができます。 これらの新しい条件は、メイン検索クエリーには影響しません。

これらの新しい条件は、検索結果ページに実装できます。 例えば、ページに新しいセクションを追加して、買い物客が検索結果をさらに絞り込めるようにすることができます。 買い物客が「製造元」、「部品番号」、「説明」など、特定の製品属性を選択できるようにすることができます。 そこから、contains 条件または startsWith 条件を使用して、これらの属性内を検索します。 検索可能な 属性のリストについては、管理ガイドを参照してください。

  1. ベータ版をインストールするには、次の依存関係をプロジェクトに追加します。

    composer require magento/module-live-search-search-types:"^1.0.0-beta1"
    
  2. 変更をコミットして composer.json にプッシュし、ファイル composer.lock クラウドプロジェクトにプッシュします。 詳細情報。

    このベータ版では、管理者に Autocomplete、Contains、Starts with の Search types チェックボックスが追加されています。 また、productSearch GraphQL API を更新して、これらの新しい検索機能を組み込みます。

  3. 管理者で、検索可能にする 製品属性を設定すると、その属性の検索機能を指定します。例えば、次を含む (デフォルト)や 次で始まる などです。 Contains に対して有効にする属性を最大 6 つ指定し、Starts with に対して有効にする属性を最大 6 つ指定できます。 ベータ版の場合、管理者はこの制限を強制しませんが、API 検索では強制されます。

    検索機能の指定

  4. 新しい contains および startsWith の検索機能を使用して Live Search API 呼び出しを更新する方法については、 開発者向けドキュメントを参照してください。

フィールドの説明

フィールド
説明
Autocomplete
デフォルトで有効になっており、変更できません。 Autocomplete では、 検索フィルターで contains を使用できます。 ここで、contains の検索クエリは、オートコンプリートタイプの検索応答を返します。 Adobeでは、通常 50 文字を超える説明フィールドに、このタイプの検索を使用することをお勧めします。
Contains
オートコンプリート検索ではなく、真の「文字列に含まれるテキスト」検索を有効にします。 検索フィルターで contains を使用します。 詳しくは、 制限事項を参照してください。
Starts with
特定の値で始まる文字列をクエリできます。 検索フィルターで startsWith を使用します。

2. API キーの設定

Adobe Commerce API キーとそれに関連する秘密鍵は、Adobe Commerceのインストールに接続する Live Search めに必要です。 API キーは、Commerce のライセンス所有者のアカウントで生成および管理され、開発者またはシステムインテグレーターと共有できます。 その後、開発者は、ライセンス所有者に代わって SaaS データスペースを作成および管理できます。 既に一連の API キーがある場合は、それらを再生成する必要はありません。

API キーを設定する方法については、Commerce サービスコネクタの記事を参照してください。

3. カタログデータを同期する

Live Search は、カタログデータをAdobeの SaaS インフラストラクチャに移動します。 データのインデックスが作成され検索結果はこのインデックスから直接ストアフロントに配信されます。 サイズと複雑さに応じて、インデックス作成には 30 分から数時間かかる場合があります。

SaaS サービスへのカタログ データの初期同期を開始するには、次のコマンドをこの順序で実行します。

bin/magento saas:resync --feed productattributes
bin/magento saas:resync --feed products
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed productoverrides
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed categoryPermissions

これらのコマンドを実行すると、SaaS サービスへのカタログ データの初期同期が開始されます。

WARNING
データのインデックス作成と同期の間、検索操作とカテゴリ参照操作はストアフロントでは使用できません。 カタログのサイズによっては、データを SaaS サービスに同期するために cron 実行されてからプロセスに少なくとも 1 時間かかる場合があります。

同期進行状況の監視

同期および共有されるデータは、 データ 管理ダッシュボードを使用して表示できます。 このダッシュボードは、ストアフロントの商品データの可用性に関する貴重な洞察を提供し、買い物客に迅速に表示できるようにします。

データ管理ダッシュボード

また、Commerce CLI およびデータ書き出し拡張機能のログを使用して、同期コマンドを実行し、同期プロセスのトラブルシューティングを行うこともできます。

今後の製品アップデート

初回同期後、製品の増分更新がストアフロント検索で使用できるようになるまで最大 15 分かかる場合があります。 詳しくは、インデックス作成ドキュメントの 製品アップデートのストリーミングを参照してください。

4. データがエクスポートされたことを確認する

カタログデータが Adobe Systems Commerce からエクスポートされ、 Live Searchと同期されているかどうかを確認するには、いくつかのオプションがあります。

  • Look、次の表のエントリを参照してください。

    • cde_products_feed
    • cde_product_attributes_feed
    NOTE
    table does not existエラーが発生した場合は、catalog_data_exporter_products および catalog_data_exporter_product_attributes テーブルでエントリを探します。これらのテーブル名は、4.2.1 より前の Live Search バージョンで使用されます。
  • デフォルトの クエリ で GraphQL プレイグラウンド を使用して (詳細については GraphQL リファレンス を参照)、以下を確認します。

    • 返される製品数は、ストア 表示で期待される数に近いものです。
    • ファセットが返されます。

その他のヘルプについては、サポートナレッジベースの「 Live Search カタログが同期されていません を参照してください。

5. データを構成する

商品データを正しく設定することで検索良好な結果が得られます。 このセクションでは、製品リストウィジェットを有効にし、カテゴリを割り当てます。

製品リストウィジェットの有効化

Live Search 4.0.0 以降をインストールすると、製品リストへのウィジェットはデフォルトで有効になります。 ウィジェットを有効にすると、検索結果ページとカテゴリ参照製品リストページで別の UI コンポーネントが使用されます。 この UI コンポーネントは、Catalog Service API を直接呼び出すことで、応答時間を短縮します。

バージョン 4.0.0 以降の Live Search がある場合は、手動で製品一覧ウィジェットを有効にする必要があります。

  1. 管理者 から、Stores/Settings/Configuration ​に移動します。

  2. [ Live Search] で [ Storefront Features] を選択します。

  3. 設定​ Enable Product Listing WidgetsYes。

    製品リストウィジェットの有効化

この設定を変更すると、 Page cache is invalidated メッセージが表示されます。 変更を保存するには、Magento キャッシュをフラッシュする必要があります。

  1. 次のいずれかの方法で キャッシュ管理 ページにアクセスします。

    • メッセージの上にあるワークスペースの Cache Management リンクをクリックします。
    • 管理者 サイドバーで、System/Tools/Cache Management ​に移動します。
  2. Configuration ​Cache Type を選択し、「Flush Magento Cache」をクリックします。

    ストアフロントに対する変更は、キャッシュをフラッシュした直後に行われます。

カテゴリの割り当て

Live Search で返された製品は、 カテゴリに割り当てられている必要があります。 例えば Luma では、製品が「男性」、「女性」、「歯車」などのカテゴリに分類されます。 サブカテゴリも「トップス」、「ボトムス」、「ウォッチポイント」に設定されます。 これらのカテゴリの割り当てにより、フィルタリング時の精度が向上します。

6.接続をテストする

カタログデータを SaaS にして、テストを行い、次のシナリオで製品データが返されることを確認します。

  • Search ボックスは正しく結果を返します
  • カテゴリの参照で結果が正しく返される
  • ファセットは、検索結果ページでフィルターとして使用できます

すべてが正しく動作している場合は、Live Search がインストールされ、接続され、使用できる状態になっています。

ストアフロントで問題が発生した場合は、var/log/system.log ファイルで API 通信の失敗やサービス側のエラーを確認します。

ファイアウォールを通過する Live Search を許可するには、commerce.adobe.io を許可リストに追加します。

7. イベントでデータが取り込まれていることを確認する

サイトにデプロイしたストアフロントイベントが機能していることを確認します。 これは、ヘッドレス実装で特に重要です。

  • リク Live Search ストに必要な イベントを確認します。
  • ライブ検索ダッシュボードに実稼動以外の環境のデータが表示されていることを確認します。
  • イベント コレクションの検証. このページは Product Recommendations ガイドですが、検証手順は Live Search にも適用されます。

8. ストアフロントに合わせたカスタマイズ

Live Search 拡張機能のインストール、データの同期、検証および設定が完了していること。 次の手順では、Live Search ウィジェットがストアのルックアンドフィールに合っていることを確認します。

必要に応じてカスタム CSS ルールを定義することにより、ポップオーバーウィジェットと PLP ウィジェットのスタイルを設定できます。 「 ポップオーバー要素のスタイル設定 およびウィジェットページ 製品リストを参照してください。

ウィジェットの機能を拡張する場合は、ウィジェットのソースコードを公開リポジトリで入手できます。このシナリオでは、独自のニーズに合わせてJavaScriptをカスタマイズし、CDN にカスタム コードをホストできます。 このカスタムスクリプトは Live Search サービスと通信し、通常どおり結果を返して、ウィジェットの機能を制御できます。

  • PLP ウィジェットリポジトリ
  • 検索バーのリポジトリ

Live Search を更新中

Live Search を更新する前に、コマンドラインから次のコマンドを実行して、インストールされている Live Search のバージョンを確認します。

composer show magento/module-live-search | grep version

Live Search を更新するには、コマンドラインから次のコマンドを実行します。

composer update magento/live-search --with-dependencies

3.1.1 から 4.0.0 などのメジャーバージョンにアップデートするには、プロジェクトのルート Composer .json ファイルを次のように編集します。

  1. 現在インストールされている magento/live-search のバージョンが 3.1.1 以下で、バージョン 4.0.0 以降にアップグレードする場合は、アップグレードの前に次のコマンドを実行します。

    bin/magento module:enable Magento_AdvancedSearch
    

    現在インストールされている magento/live-search バージョンについて詳しくは、次のコマンドを実行してください。

    composer show magento/live-search
    
  2. ルート composer.json ファイルを開き、magento/live-search を検索します。

  3. require セクションで、バージョン番号を次のように更新します。

    "require": {
       ...
       "magento/live-search": "^4.0",
       ...
     }
    
  4. 保存 composer.json ます。 コマンドラインから次のコマンドを実行します。

    composer update magento/live-search --with-dependencies
    

アンインストール Live Search

Live Searchをアンインストールするには、モジュールのアンインストールを参照してください。

Live Search パッケージ

Live Search 拡張機能は、次のパッケージで構成されています。

パッケージ
説明
module-live-search
を使用すると、マーチャントは、ファセット、同義語、クエリルールなどの検索設定を指定したり、読み取り専用のGraphQL プレイグラウンドにアクセスして Admin からクエリをテストしたりできます。
module-live-search-adapter
リクエスト検索ストアフロントから Live Search サービスにルーティングし、結果をストアフロントにレンダリングします。
- カテゴリー参照 - ストアフロント 最上位ナビゲーション から検索サービスにリクエストをルーティングします。
- グローバル 検索 - ストアフロントの右上にある クイック 検索 ボックスから Live Search サービスに要求をルーティングします。
module-live-search-storefront-popover
「入力時に検索」ポップオーバーは、標準のクイック検索に取って代わり、上位検索結果のデータとサムネイルを返します。

Live Search 依存関係

Live Search 拡張機能をインストールするための Composer メタパッケージには、次のモジュール依存関係が含まれています。

  • magento/module-saas-catalog
  • magento/module-saas-category
  • magento/module-saas-category-permissions
  • magento/module-saas-product-override
  • magento/module-saas-product-variant
  • magento/module-saas-price
  • magento/module-saas-scopes
  • magento/module-bundle-product-data-exporter
  • magento/module-catalog-inventory-data-exporter
  • magento/module-catalog-url-rewrite-data-exporter
  • magento/module-configurable-product-data-exporter
  • magento/module-parent-product-data-exporter
  • magento/module-gift-card-product-data-exporter
  • magento/module-bundle-product-override-data-exporter
  • data-services
  • services-id

高度な概念

以下のセクションでは、Live Search と Catalog Service を使用する際の、より高度なトピックを示します。

エンドポイント

Live Search は、https://catalog-service.adobe.io/graphql のエンドポイントを介して通信します。

Live Searchは完全な製品データベースにアクセスできないため、Live Search GraphQL およびコマースコア GraphQL API には完全なパリティがありません。

Adobe Systems では、SaaS API (具体的にはカタログ サービス エンドポイント) を直接呼び出すことをお勧めします。

  • コマースデータベース/Graphqlプロセスをバイパスすることでパフォーマンスを向上させ、プロセッサの負荷を軽減します
  • Catalog Service フェデレーションを利用して、単一のエンドポイントからLive Search、Catalog Service、およびProduct Recommendationsを呼び出します。

一部のユースケースでは、製品の詳細や同様のケースについては、Catalog Service に問い合わせることをお勧めします。 詳しくは refineProduct を参照してください。

カスタムヘッドレス実装がある場合は、 Live Search リファレンス実装を確認してください。

  • PLP ウィジェット
  • ライブ検索フィールド

検索アダプター、Luma ウィジェット、AEM CIF ウィジェットなどの標準コンポーネントを使用しない場合、ユーザーインタラクションデータの自動収集はデフォルトでは機能しません。 Adobe Senseiでは、この収集されたデータを使用して、インテリジェントなマーチャンダイジングとパフォーマンスのトラッキングを行います。 この問題を解決するには、このデータ収集をヘッドレスで実装するカスタムソリューションを開発する必要があります。

Live Search の最新バージョンでは、既に Catalog Service が使用されています。

言語サポート

Live Search ウィジェットは次の言語をサポートしています。

言語
地域
言語コード
Magento ロケール
ブルガリア語
ブルガリア
bg_BG
bg_BG
カタルニア語
スペイン
ca_ES
ca_ES
チェコ語
チェコ共和国
cs_CZ
cs_CZ
デンマーク語
デンマーク
da_DK
da_DK
ドイツ語
ドイツ
de_DE
de_DE
ギリシャ語
ギリシャ
el_GR
el_GR
英語
英国
en_GB
en_GB
英語
米国
en_US
en_US
スペイン語
スペイン
es_ES
es_ES
エストニア語
エストニア
et_EE
et_EE
バスク語
スペイン
eu_ES
eu_ES
ペルシャ語
イラン
fa_IR
fa_IR
フィンランド語
フィンランド
fi_FI
fi_FI
フランス語
フランス
fr_FR
fr_FR
ガリシア語
スペイン
gl_ES
gl_ES
ヒンディー語
インド
hi_IN
hi_IN
ハンガリー語
ハンガリー
hu_HU
hu_HU
インドネシア
インドネシア
id_ID
id_ID
イタリア語
イタリア
it_IT
it_IT
韓国語
韓国
ko_KR
ko_KR
リトアニア語
リトアニア
lt_LT
lt_LT
ラトビアン
ラトビア
lv_LV
lv_LV
ノルウェー語
ノルウェー ブークモール
nb_NO
nb_NO
オランダ語
オランダ
nl_NL
nl_NL
ポーランド語
ポーランド
pl_PL
pl_PL
ポルトガル語
ブラジル
pt_BR
pt_BR
ポルトガル語
ポルトガル
pt_PT
pt_PT
ルーマニア語
ルーマニア
ro_RO
ro_RO
ロシア
ロシア
ru_RU
ru_RU
スウェーデン語
スウェーデン
参照(_S)
参照(_S)
タイ語
タイ
th_TH
th_TH
トルコ語
トルコ
tr_TR
tr_TR
中国語
中国
zh_CN
zh_Hans_CN
中国語
台湾
zh_TW
zh_Hant_TW

Commerce管理者の言語設定がサポートされている言語と一致することが検出された場合、デフォルトではその言語に設定されます。 それ以外の場合、ウィジェットのデフォルト値は英語になります。 管理者で、Stores/Settings/Configuration/General/Country Options に移動して、言語設定を指定します。

また、管理者は 検索インデックスの言語を設定して、検索結果を向上させることもできます。

ウィジェットコードリポジトリー

製品一覧表示ページウィジェットとライブ検索フィールドウィジェットのコードは、GitHub からダウンロードできます。

コードにアクセスできる開発者は、その動作と外観を完全にカスタマイズできます。 ユーザーは独自のサーバーでコードをホストしますが、 Live Search サービスを使用します。

  • PLP ウィジェット
  • 検索バー

データエクスポート拡張機能

Live Search を有効にすると、データ書き出し拡張機能によってCommerce アプリケーションと Live Search の間でCommerce データが同期されます。 このプロセスにより、最新のコマース データをストアフロントで使用できるようになります。 管理者では、データ管理ダッシュボードを使用して同期ステータスを確認できます。 Commerce CLI とログを使用して、データ エクスポート プロセスの管理とトラブルシューティングを行うことができます。 詳しくは、『 データ 書き出しガイド』を参照してください。

在庫管理

Live Search コマースの 在庫管理 機能をサポートします (以前は複数出力元在庫、または MSI と呼ばれていました)。 フル サポートを有効にするには、依存関係モジュールcommerce-data-exportバージョン 102.2.0+ に更新必要があります。

Live Search は、商品がInventory management内で使用可能かどうかを示すブール値を返しますが、どのソースが在庫を持っているかに関する情報は含まれません。

価格インデクサー

Live Search のお客様は、SaaS 価格インデクサーを使用できます。これにより、価格変更の更新と同期時間が短縮されます。

価格サポート

ライブ検索ウィジェットは、Adobe Commerceでサポートされているすべての価格タイプではなく、ほとんどの価格タイプをサポートしています。

現在、基本価格がサポートされています。 サポートされていない高度な価格は次のとおりです。

  • コスト
  • 広告の最低価格

より複雑な価格計算については、API メッシュを参照してください。

価格フォーマットは、Commerce インスタンス内の次のロケール設定をサポートしています。ストア /設定/ 設定 /一般/ 一般 / ローカルオプション / ロケール

ヘッドレスストアフロントのサポート

オプションで、アプリケーションの既存のGraphQL範囲を拡張する module-data-services-graphql モジュールをインストールし、ストアフロントの行動データ収集に必要なフィールドを含める必要が生じる場合があります。

composer require magento/module-data-services-graphql

このモジュールは、GraphQL クエリにコンテキストを追加します。

  • dataServicesStorefrontInstanceContext
  • dataServicesMagentoExtensionContext
  • dataServicesStoreConfigurationContext

B2B サポート

Live Search では、追加の 制限事項を追加して 🔗B2B 機能をサポートしています。

PWA サポート

Live Search はPWA Studioで動作しますが、他のCommerceの実装と比較すると、わずかな違いがあります。 検索や製品リストのページなどの基本的な機能は Venia で機能しますが、Graphql の一部の並べ替えが正しく機能しない場合があります。 パフォーマンスの違いもあります。

  • Live Search の現在のPWA実装では、検索結果を返すのにネイティブのCommerce ストアフロントよりも多くの処理時間 Live Search 必要です。
  • PWAの Live Search は、 イベント処理をサポートしていません。 その結果、検索レポートとインテリジェントマーチャンダイジングがPWAのストアフロントで機能しません。
  • PWA Studio を使用する場合、GraphQLは description、name、short_description に対する直接フィルタリングをサポートしていませんが、これらのフィールドはより一般的なフィルターで返すことができます。

PWA Studioで Live Search を使用する場合、インテグレーターは次の要件も満たす必要があります。

  1. livesearch-storefront-utils をインストールします。

  2. storeDetails オブジェクトに environmentId を設定します。

    const storeDetails: StoreDetailsProps = {
        environmentId: <Storefront_ID>,
        websiteCode: "base",
        storeCode: "main_website_store",
        storeViewCode: "default",
        searchUnitId: searchUnitId,
        config: {
            minQueryLength: 5,
            pageSize: 8,
            currencySymbol: "$",
            },
        };
    

の Cookie

Live Search は、基本機能の一部としてユーザーインタラクションデータを収集し、このデータを保存するために cookie が使用されます。 ユーザー情報を収集する場合、ユーザーは Cookie の保存に同意する必要があります。 Live Search と Product Recommendations はデータストリームを共有するので、同じ cookie メカニズムになります。 詳しくは、Cookie 制限の処理を参照してください。

recommendation-more-help
8eedb3c4-09d2-4e4f-917b-524833fc6b4f