このページは Cloud Translation API によって翻訳されました。

分析情報を表示

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

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

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

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

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

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

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

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

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

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

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

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

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

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

検索ログ

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

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

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

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

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

Google Cloud コンソールで、[Agent Builder] ページに移動します。

Agent Builder
アナリティクスを表示するアプリの名前をクリックします。
[アナリティクス] をクリックします。
指標をフィルタするには、次のいずれかのフィルタを指定し、[更新] ボタンをクリックして適用します。
- 期間（日）。既定の期間を選択するか、利用可能な場合はカスタム期間を入力します。
- デバイスの種類。クエリが行われたデバイスタイプを選択します。

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

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

Google Cloud コンソールで、[Agent Builder] ページに移動します。

Agent Builder
アナリティクスを表示するアプリの名前をクリックします。
[アナリティクス] をクリックします。
タブをクリックすると、対象の指標グループが表示されます。
- 検索ごと。指標は検索ごとにグループ化されます。
- セッションごと。指標は検索セッションごとにグループ化されます。
- 比較。ベースライン指標は、比較期間の指標とともに表示されます。ベースライン指標（前の期間）と比較指標（後の期間）の期間を選択します。これらの期間は重複できません。
指標をフィルタするには、次のいずれかのフィルタを指定し、[更新] ボタンをクリックして適用します。
- 期間（日）。既定の期間を選択するか、利用可能な場合はカスタム期間を入力します。
- 検索クエリ。条件と検索クエリの値を選択します。検索クエリフィルタは複数追加できます。[検索あたり] 指標と [比較] 指標で使用できます。
- デバイスの種類。クエリが行われたデバイスタイプを選択します。

指標の定義

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

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

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

検索の指標

指標名	指標の定義	注
検索回数	検索イベントの数	検索ログに基づく
結果なし率	結果のない検索イベント数 ÷ 検索回数	検索ログに基づく
検索あたりのクリック率（CTR）	検索クリック数 ÷ 検索回数	検索クリックは、前の検索イベントに起因するアイテム表示イベントです。ユーザーイベントに基づく
検索セッション数	検索セッションの数	検索セッションとは、少なくとも 1 つの検索イベントを含むユーザーセッションです。ユーザーセッション（訪問とも呼ばれます）は、連続した一連のユーザーイベントです。30 分間操作がないと、セッションは終了します。検索ログに基づく
検索アクセスあたりのページビュー	検索セッションでのアイテム表示イベントの数 ÷ 検索セッション数	この指標には、Vertex AI Search に起因するものかどうかにかかわらず、検索アクセスのすべてのページビューが含まれます。ユーザーイベントに基づく
直帰率	検索セッションでの直帰数 ÷ 検索セッション数	検索セッションの直帰とは、1 回の検索によるセッションとして定義されます。ここでユーザーは 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
}'

このコマンドは、検索アナリティクスデータを収集しないアプリを作成します。