このページでは、メディア レコメンデーション アプリと検索アプリのアナリティクスを表示する方法について説明します。
アナリティクスにより、アプリの使用傾向、検索とレコメンデーションの品質、エンドユーザー エンゲージメントに関する分析情報が得られます。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] ページに移動します。
アナリティクスを表示するアプリの名前をクリックします。
[アナリティクス] をクリックします。
指標をフィルタするには、次のいずれかのフィルタを指定し、[更新] ボタンをクリックして適用します。
- 期間（日）。既定の期間を選択するか、利用可能な場合はカスタム期間を入力します。
- デバイスの種類。クエリが行われたデバイスタイプを選択します。
検索アナリティクスを表示する
汎用検索アプリまたはメディア検索アプリのアナリティクスを表示するには、次の手順を行います。
Google Cloud コンソールで、[Agent Builder] ページに移動します。
アナリティクスを表示するアプリの名前をクリックします。
[アナリティクス] をクリックします。
タブをクリックすると、対象の指標グループが表示されます。
- 検索ごと。指標は検索ごとにグループ化されます。
- セッションごと。指標は検索セッションごとにグループ化されます。
- 比較。ベースライン指標は、比較期間の指標とともに表示されます。ベースライン指標（前の期間）と比較指標（後の期間）の期間を選択します。これらの期間を重複させることはできません。
指標をフィルタするには、次のいずれかのフィルタを指定し、[更新] ボタンをクリックして適用します。
- 期間（日）。既定の期間を選択するか、利用可能な場合はカスタム期間を入力します。
- 検索クエリ。条件と検索クエリの値を選択します。検索クエリ フィルタは複数追加できます。[検索あたり] 指標と [比較] 指標で使用できます。
- デバイスの種類。クエリが行われたデバイスタイプを選択します。
指標の定義
次の表に、指標の定義方法を示します。
メディア レコメンデーションの指標
| 指標名 | 指標の定義 | メモ |
|---|---|---|
| おすすめの数 | おすすめの合計数 | |
| おすすめの再生回数 | おすすめのメディア アイテムが再生された回数 | |
| おすすめのクリック数 | おすすめのメディア アイテムがクリックされた回数 | |
| クリック率 | おすすめのクリック数 ÷ おすすめの数 | おすすめのクリック数は、レコメンデーションに関連付けることができるアイテム表示イベントです。 |
| おすすめのメディアの完了数 | おすすめのメディア アイテムが最後まで再生された回数 | |
| おすすめあたりの再生率 | おすすめのメディア アイテムが再生された回数 ÷ おすすめの数 | |
| 1 回の再生あたりの完全再生率 | おすすめのメディア アイテムが最後まで再生された回数 ÷ メディア アイテムが再生された回数 | |
| 1 回の再生あたりの平均総再生時間 | おすすめのメディア アイテムが再生された時間（秒）÷ おすすめのメディア アイテムが再生された回数 | |
| おすすめごとの完全再生率 | メディア アイテムが最後まで再生された回数 ÷ おすすめの数 | |
| おすすめあたりの平均総再生時間 | おすすめのメディア アイテムの再生時間（秒）÷ おすすめの数 |
検索の指標
| 指標名 | 指標の定義 | 注 |
|---|---|---|
| 検索回数 | 検索イベントの数 | 検索ログに基づく |
| 結果なし率 | 結果のない検索イベント数 ÷ 検索回数 | 検索ログに基づく |
| 検索あたりのクリック率（CTR） | 検索クリック数 ÷ 検索回数 | 検索クリックは、前の検索イベントに起因するアイテム表示イベントです。ユーザー イベントに基づく |
| 検索セッション数 | 検索セッションの数 | 検索セッションとは、少なくとも 1 つの検索イベントを含むユーザー セッションです。ユーザー セッション（訪問とも呼ばれます）は、連続した一連のユーザー イベントです。30 分間操作がないと、セッションは終了します。検索ログに基づく |
| 検索アクセスあたりのページビュー | 検索セッションでのアイテム表示イベントの数 ÷ 検索セッション数 | この指標には、Vertex AI Search に起因するものかどうかにかかわらず、検索アクセスのすべてのページビューが含まれます。ユーザー イベントに基づく |
| 直帰率 | 検索セッションでの直帰数 ÷ 検索セッション数 | 検索セッションの直帰とは、1 回の検索によるセッションとして定義されます。ここでユーザーは 1 回の検索を行った後に離れます。ユーザー イベントに基づく |