ドキュメントCommerceLive Search ガイド

Live Search イベント

Last update: Tue Mar 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者

Live Search はイベントを使用して、「最も多く閲覧された」、「これを閲覧し、それを閲覧した」などの検索アルゴリズムを強化します。 Commerceのサンプル Luma テーマが標準でイベントを取得する一方で、ヘッドレスやその他のカスタム実装では、独自のニーズに応じてイベントを実装する必要があります。

次の表に、Live Search が使用するイベントについて説明します ランキング戦略。

ランキング戦略
イベント
ページ
最も頻繁に閲覧された
page-view
product-view
製品詳細ページ
最も多く購入された
page-view
place-order
買い物かご/チェックアウト
買い物かごに追加済み
page-view
add-to-cart
製品詳細ページ
製品一覧ページ
買い物かご
お気に入りリスト
がこれを表示し、が表示されました
page-view
product-view
製品詳細ページ
NOTE
Live Search 用のためのデータ収集には、個人を特定できる情報（PII）は含まれません。 Cookie ID や IP アドレスなどのすべてのユーザー識別子は、厳密に匿名化されます。 詳細情報。

必須のダッシュボードイベント

一部のイベントは、 ライブ検索ダッシュボードへの入力に必要です

ダッシュボード領域
イベント
結合フィールド
ユニーク検索
page-view、search-request-sent、search-response-received
searchRequestId
ゼロ結果検索
page-view、search-request-sent、search-response-received
searchRequestId
ゼロ結果率
page-view、search-request-sent、search-response-received
searchRequestId
一般的な検索
page-view、search-request-sent、search-response-received
searchRequestId
平均 クリック位置
page-view, search-request-sent, search-response-received, search-results-view, search-product-click
searchRequestId
クリックスルー率
page-view, search-request-sent, search-response-received, search-results-view, search-product-click
searchRequestId、sku、parentSku
コンバージョン率
page-view, search-request-sent, search-response-received, search-results-view, search-product-click, product-view, add-to-cart, place-order
searchRequestId、sku、parentSku

必要なコンテキスト

すべてのイベントには、Page および Storefront コンテキストが必要です。 これは、個々のイベントを生成する場合ではなく、ページレベル/ストアフロントアプリケーションレイヤーで行う必要があります（例えば、PHP ストアフロントでは、PHP アプリケーションコンテナが実行時に設定を行います）。

使用状況

search-request-sent イベントの実装例を次に示します。

const mse = window.magentoStorefrontEvents;

/* set in application container */
// mse.context.page(pageCtx);
// mse.context.setStorefrontInstance(storefrontCtx);

/* set before firing event */
mse.context.setSearchInput(searchInputCtx);
mse.publish.searchRequestSent("search-bar");

注意事項

  • 広告ブロッカーとプライバシー設定は、イベントがキャプチャされるのを防ぎ、エンゲージメントと売上高 指標が過小報告される原因になる可能性があります。 さらに、買い物客のページからの離脱やネットワークの問題が原因で、一部のイベントが送信されない場合があります。
  • ヘッドレス実装では、インテリジェントなマーチャンダイジングを強化するためにイベンティングを実装する必要があります。
NOTE
Cookie 制限モードが有効になっている場合、買い物客が Cookie の使用を同意するまで、Adobe Commerceは行動データを収集しません。 Cookie 制限モードが無効になっている場合、Adobe Commerceはデフォルトで行動データを収集します。
recommendation-more-help
8eedb3c4-09d2-4e4f-917b-524833fc6b4f