AI 検索 での AI 検索 使用のイベントログとアクションログ 推奨アクション

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:5分
  • AI 検索イベントログとアクションログは、ユーザーのインタラクションと検索アクティビティをキャプチャし、AI 検索アナリティクスダッシュボードにデータを提供します。

    イベントおよびアクションログを検索

    検索システム内の検索関連イベントのログ記録では、検索クエリ、結果、およびユーザーインタラクションが分析目的でさまざまなテーブルにどのように記録されるかに焦点を当てています。
    • 検索イベントのログ記録:イベントをキューに入れて専用のテーブルに処理することで、検索クエリ、結果、ユーザーアクションなどの検索イベントのログ記録を行います。検索イベントは、最初に [キューに入れられたシグナルイベント] テーブルでキューに入れられ、処理されると検索イベントテーブルに移動されます。
    • イベントログ記録トリガー:検索イベント、検索ソースイベント、および検索シグナルイベントテーブルは、クエリの変更、結果のソース、適用されたファセットフィルターなどの詳細をキャプチャします。ログ記録は、検索が行われたときだけでなく、フィルター、ファセット、またはソートが適用されたときにも行われ、検索機能とのユーザーインタラクションを包括的にキャプチャします。

      イベントはキューに入れられ、次のテーブルに処理されます。

      • 検索イベントテーブル [sys_search_event]:検索クエリ、ユーザー情報、および結果ステータスをログに記録します。
      • 検索ソースイベントテーブル [sys_search_source_event]:クエリの作成元 (カタログアイテムなど) をキャプチャします。
      • 検索シグナルイベントテーブル [sys_search_signal_event]:ログファセットフィルターは、検索クエリとソースマッピングの結果に適用されるファセットフィルターをフィルタリングします。

      上記のテーブルの詳細については、「 Search Suggestions tables」を参照してください。

    • 検索結果アクションのログ記録:通常の結果アクションと Genius 結果アクションの区別を含む、検索結果のクリックとアクションを記録するための個別のテーブルが存在し、単一のソースで複数のアクションに対して複数のエントリがあります。リンクのクリックやアクションの実行など、検索結果を操作すると、これらのアクションが記録されます。プレビューエクスペリエンスでは、重複を避けるためにドリルダウンなどのアクションが自動的にログに記録されます。このデータは、事前に構築されたアナリティクスダッシュボードまたはカスタムのアナリティクスダッシュボードに入力するために使用され、検索結果とのインタラクションを効果的に追跡および分析できます。

      カスタムガイダンスの場合は、アクション関連のデータを含む適切なペイロード構造を使用してログ検索結果イベントを発行する必要があります。ペイロードでのアクションの詳細の発行はオプションです。これがない場合、イベントは引き続きログに記録されますが、特定のアクション情報が欠落しているため、一意のアクション ID を使用して重複が防止されます。カスタムガイダンスアクションでは、指定されたペイロード構造を持つイベントを発行してアクションの詳細をログに記録する必要がありますが、すぐに利用可能なガイダンスはこれを自動的に処理します。ペイロード構造については、「 カスタムアクションログペイロード構造」を参照してください。

      • 検索結果イベントテーブル [sys_search_signal_result_event]:選択した検索結果のシグナルデータを保存します。
      • 検索結果イベントアクションテーブル [sys_search_signal_result_event_action]:検索結果とのユーザーインタラクションのシグナルデータを保存します。
      • Genius 結果アクションテーブル [sys_search_genius_result_event_action]:Genius 結果回答カードとのユーザーインタラクションのシグナルデータを保存します。

      上記のテーブルの詳細については、「 Search signal tables」を参照してください。

    • AI 検索アナリティクス:ログに記録されたデータは、事前構築済みまたはカスタムの AI 検索アナリティクスダッシュボードに入力するために使用され、検索結果とのインタラクションを効果的に追跡および分析できます。AI 検索アナリティクスダッシュボードの詳細については、「 AI Search analytics dashboard」を参照してください。右上のアプリケーションドロップダウンで [[CSM AIS] 構成可能ワークスペースの検索構成オプションを選択すると、AI 検索 アナリティクスダッシュボードの 推奨アクション 内で CSM ワークスペース関連のAI 検索使用状況を表示できます。

    カスタムアクションログペイロード構造

    カスタムアクションログ記録の場合、つまりガイダンスプレビューエクスペリエンスで作成するアクションの場合、アクション関連のデータを含むペイロード構造を持つイベントを発行する必要があります。適用されたフィルターやビューなどのその他の一般的なフィールドは、システムによって処理されます。ペイロードが空の場合、イベントはログに記録されますが、アクションの詳細は利用できません。この構造化されたペイロードは、カスタムアクションとのユーザーインタラクションに関する特定の情報を提供するため、詳細なアナリティクスダッシュボードを構築するために重要です。

    api.emit(LOG_SEARCH_RESULT_EVENT, {actionData: {actionName: actionId}})

    カスタムアクションのペイロードを構成する方法の詳細については、「 UI ビルダー でのガイダンスプレビューエクスペリエンスのカスタマイズ」を参照してください。