アナリティクスを見る

このページでは、レコメンデーション アプリと検索アプリのアナリティクスを表示する方法について説明します。

アナリティクスにより、アプリの使用傾向、検索とレコメンデーションの品質、エンドユーザー エンゲージメントに関する分析情報が得られます。Agent Search コンソールには、Looker を活用したインタラクティブなダッシュボードが用意されています。

• メディア レコメンデーション アプリの場合: 公開プレビュー版。ユーザー イベントに基づくレコメンデーションごとの指標を確認できます。期間とデバイスの種類で指標をフィルタできます。
• カスタム検索アプリとメディア検索アプリの場合: 検索ログとユーザー イベントに基づいて、検索ごとの指標 と検索セッションごとの指標を確認できます。指標は、期間、クエリ、デバイスタイプでフィルタできます。
• 医療検索アプリの場合: 公開プレビュー版。検索ログに基づいて検索ごとの指標を確認できます。

指標は約 6 時間ごとに更新されるため、アプリの作成後、[アナリティクス] ページを使用できるようになるまでに数時間かかることがあります。

アナリティクス用のデータソース

このセクションでは、アプリの種類に応じたアナリティクスのデータソースについて説明します。

ユーザー イベントのアナリティクスを表示するには、ユーザー イベントの統合を完了する必要があります。

アップロードするユーザー イベントによって、生成されるアナリティクスが決まります。

メディア レコメンデーション アプリで一部の指標を表示するには、次のユーザー イベントが必要です。

• アイテム表示イベント。クリック率に必要です。
• メディア完全再生イベント。再生あたりの完全再生率とおすすめあたりの完全再生率には必須です。
• メディア再生イベント。おすすめのメディアの再生回数、再生率、再生あたりの完全再生率、再生あたりの平均総再生時間に必須です。

検索アプリで一部の指標を表示するには、次のユーザー イベントが必要です。

• 検索イベント。クリック率に必要です。
• アイテム表示イベント。クリック率に必要です。

一部のアナリティクスでは、次の情報も使用されます。

• インプレッション 。ユーザー イベントを取り込むときに、関連するアイテムを UserEvent.Documents に含めることで、Agent Search に起因するインプレッション（アイテムの表示回数またはクリック数）を提供できます。この情報は、アトリビューションと検索ごとの指標の計算に必要です。
• アトリビューション トークン 。アトリビューション トークンは、Agent Search によって生成され、検索リクエストごとに返される一意の ID です。検索の結果として得られるユーザー イベントには、そのアトリビューション トークンを UserEvent.attributionToken として配置するようにしてください。これは、API で検索サービスが提供されているかどうかを識別するために必要です。指標の計算には、Google が生成したアトリビューション トークンを含むユーザー イベントのみが使用されます。
• ユーザー エージェント。ユーザー イベントに UserInfo.userAgent を含めると、デバイスタイプでユーザー イベントの指標をフィルタできます。

検索ログ

検索アプリでは、一部の指標のデータソースとして検索ログが使用されます。

検索ログは検索リクエストに基づいています。Agent Search でユーザー セッションを 識別して、セッションごとのアナリティクスと質の高い検索結果を提供できるようにするには、オプション フィールド userPseudoIdを設定することを強くおすすめします。

検索ログやユーザー イベントがまだない場合は、すべての指標でデフォルト値が表示されます。

メディア レコメンデーションのアナリティクスを表示する

注: メディア レコメンデーションのアナリティクスは公開プレビュー版です。

メディア レコメンデーションのアナリティクスを表示する手順は次のとおりです。

1. コンソールで、[AI アプリケーション] ページに移動します。 Google Cloud

   AI Applications

2. アナリティクスを表示するアプリの名前をクリックします。

3. [アナリティクス] をクリックします。

4. 指標をフィルタするには、次のいずれかのフィルタを指定して [更新] ボタンをクリックし、適用します。

   • 期間（日）。既定の期間を選択するか、カスタム期間を入力します（利用可能な場合）。
   • デバイスの種類。クエリが行われたデバイスタイプを選択します。

検索アナリティクスを表示する

注:

• 米国と EU の複数のリージョンにあるデータストアの場合、検索アナリティクスの表示は パブリック プレビュー版です。
• 医療検索向け Agent Search は、米国のマルチリージョン（us）でのみ検索サービスを提供しているため、医療検索のアナリティクスはパブリック プレビュー版です。
• 検索アナリティクスは、グローバル データストア向けの GA です。

検索アプリのアナリティクスを表示する手順は次のとおりです。

1. コンソールで、[AI アプリケーション] ページに移動します。 Google Cloud

   AI Applications

2. アナリティクスを表示するアプリの名前をクリックします。

3. [アナリティクス] をクリックします。

4. タブをクリックすると、対象の指標グループが表示されます。

   • 検索ごと 。指標は検索ごとにグループ化されます。医療検索の場合、これが唯一の利用可能な指標グループです。
   • セッションごと 。指標は検索セッションごとにグループ化されます。
   • 比較。比較期間の指標とともにベースライン指標が表示されます。ベースライン指標（過去の期間）と比較指標（後の期間）の期間を選択します。これらの期間を重複させることはできません。

5. 指標をフィルタするには、フィルタを指定して [更新] ボタンをクリックし、適用します。

   メディアアプリとカスタム検索アプリでは、次のフィルタを使用できます。

   • 期間（日） 。既定の期間を選択するか、カスタム期間を入力します（利用可能な場合）。
   • 検索クエリ。条件と検索クエリの値を選択します。複数の検索クエリ フィルタを追加できます。[検索ごと] 指標と [比較] 指標で使用できます。
   • デバイスの種類。クエリが行われたデバイスタイプを選択します。

   医療検索アプリでは、次のフィルタを使用できます。

   • 期間（日） 。既定の期間を選択するか、カスタム期間を入力します（利用可能な場合）。カスタム期間に特定の日付を選択すると、その日付は UTC -08:00 タイムゾーンで検索が行われた日付になります。
   • 検索クエリ 。条件と検索クエリの値を選択します。複数の検索クエリ フィルタを追加できます。
   • ユーザーの現在地 。検索リクエストで設定された病院、クリニック、医療サービス プロバイダの場所を選択します。このフィルタは、検索リクエストで設定されている場合にのみ使用できます。
   • ユーザー役割 。検索リクエストを送信したユーザーの職種を選択します。このフィルタは、検索リクエストで設定されている場合にのみ使用できます。
   • ユーザー設定 。検索リクエストで設定された医療設定（入院、外来、ハイブリッド治療など）を選択します。このフィルタは、検索リクエストで設定されている場合にのみ使用できます。

指標の定義

次の表に、指標の定義を示します。

メディア レコメンデーションの指標

指標名	指標の定義	メモ
おすすめの数	おすすめの合計数
おすすめの再生回数	おすすめのメディア アイテムが再生された回数
おすすめのクリック数	おすすめのメディア アイテムがクリックされた回数
クリック率	おすすめのクリック数 ÷ おすすめの数	おすすめのクリック数は、レコメンデーションに関連付けることができるアイテム表示イベントです。
おすすめのメディア完全再生数	おすすめのメディア アイテムが最後まで再生された回数
おすすめあたりの再生率	おすすめのメディア アイテムが再生された回数 ÷ おすすめの数
1 回の再生あたりの完全再生率	おすすめのメディア アイテムが最後まで再生された回数 ÷ メディア アイテムが再生された回数
1 回の再生あたりの平均総再生時間	おすすめのメディア アイテムが再生された時間（秒）÷ おすすめのメディア アイテムが再生された回数
おすすめごとの完全再生率	メディア アイテムが最後まで再生された回数 ÷ おすすめの数
おすすめあたりの平均総再生時間	おすすめのメディア アイテムの再生時間（秒）÷ おすすめの数

メディア検索とカスタム検索の指標

指標名	指標の定義	注
検索回数	検索イベントの数	検索ログに基づく。
結果なし率	結果のない検索イベント数 ÷ 検索回数	検索ログに基づく。
検索あたりのクリック率（CTR）	検索クリック数 ÷ 検索回数	検索クリック数は、前の検索イベントに起因するアイテム表示イベントです。ユーザー イベントに基づく。
フィードバックの高評価と低評価の数	高評価と低評価の数	アプリのユーザーから送信された高評価/低評価のフィードバック レスポンスの記録。
フィードバックの低評価の理由の内訳	低評価の理由の割合	生成された回答にユーザーが低評価を付けた場合は、低評価の理由を複数選択できます。 割合は、各理由が選択された頻度を示します。
検索セッション数	検索セッションの数	検索セッションとは、少なくとも 1 つの検索イベントを含むユーザー セッションです。ユーザー セッション（アクセスとも呼ばれます）は、連続したユーザー イベントのセットです。30 分間操作がないと、セッションは終了します。検索ログに基づく。
検索アクセスあたりのページビュー	検索セッションでのアイテム表示イベントの数 ÷ 検索セッション数	この指標には、Agent Search に起因するものかどうかにかかわらず、検索アクセスのすべてのページビューが含まれます。 ユーザー イベントに基づく。
直帰率	検索セッションでの直帰数 ÷ 検索セッション数	検索セッションの直帰とは、1 回の検索によるセッションとして定義されます。ここでユーザーは 1 回の検索を行った後に離れます。ユーザー イベントに基づく。

医療検索の指標

非推奨: 医療検索向け Agent Search は非推奨となり、2027 年 5 月 15 日以降はご利用いただけなくなります。

医療検索アプリでは、次の検索指標を使用できます。

指標名	指標の定義	注
検索回数	検索イベントの数
結果なし数	結果のない検索イベントの数
検索あたりの結果なし率	検索あたりの結果のない検索イベントの数
患者数	検索が行われた患者 ID の数	これは検索ユーザーごとに重複排除されますが、患者ごとには重複排除されません。たとえば、ユーザー 1 が患者 A と患者 B を検索し、ユーザー 2 が患者 B のみを検索した場合、カウントは 3 になります。
お客様の検索セッション数	検索ユーザー定義セッションの数	検索でセッション ID を送信できます。 詳細については、 see session をご覧ください。
検索ユーザー数	検索リクエストを送信したユーザーの数	ユーザーは に基づいて userInfo フィールドカウントされます。
合成検索セッション数	Google 定義の検索セッションの数	検索セッションとは、少なくとも 1 つの検索イベントを含むユーザー セッションです。ユーザー セッション（アクセスとも呼ばれます）は、連続したユーザー イベントのセットです。30 分間操作がないと、セッションは終了します。

アナリティクスをオフにする

既存のアプリのアナリティクスをオフにすることはできませんが、アプリを作成するときにアナリティクスをオフにして作成できます。

アナリティクス データを収集しない検索アプリを作成するには:

1. 検索アプリを作成するの REST の手順に沿って、curl コマンドに以下を追加します。

      "disableAnalytics": true
   

   コマンドの例

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "App without analytics",
     "dataStoreIds": ["my-data-store"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "searchEngineConfig": {
        "searchTier": "SEARCH_TIER_ENTERPRISE",
        "searchAddOns": ["SEARCH_ADD_ON_LLM"]
      },
     "disableAnalytics": true
   }'
   
       

   このコマンドを実行すると、検索アナリティクス データを収集しないアプリが作成されます。