Cloud Talent Solution の管理ツール

Cloud Talent Solution のダッシュボード

Cloud Talent Solution のダッシュボードでは、視覚的なデータを表示することによって、次のことについてより詳細に理解できます。

求職者が求人検索にどのようにかかわっているか（ドメイン別に上位のクエリと場所を表示することにより示します）。
求人検索が適切に構成されているかどうか（統合の不整合を表示することにより示します）。
クライアントイベントが適切に構成されているかどうか。ダッシュボードには、修正または改善する必要があるクライアントイベントを表示できます。

クライアントイベントライブストリーム

送信したイベントメッセージを Google が受信しているかどうかを調べ、そのメッセージの形式が正しいことを確認します。GCP Console で、クライアントイベントライブストリームツールにアクセスできます。最新のイベントメッセージ（最大 50 件）が一覧表示されます。イベントの詳細を表示するには、一覧されたイベントのいずれかを選択します。ヘッダーの [すべてのイベント（リクエスト ID 別）] ボタンをクリックして、同じ requestId を持つすべてのイベントを確認します。clientEvent メッセージが誤った形式で送信された場合は、詳細ビューに警告が表示されます。フィルタオプションを使用して、requestId、userId、sessionId のいずれかによってメッセージをフィルタします。

メッセージがクライアントイベントのライブストリームに表示されない場合は、イベントメッセージの requestId が有効であることを確認してください。有効な requestId のないイベントメッセージは Cloud Talent Solution によって破棄されます。

単一イベントのエラーメッセージの詳細については、ClientEvent 検証エラーのトラブルシューティングをご覧ください。

クライアントイベントを検索

特定の requestId を持つすべてのイベントメッセージを検索します。クライアントイベントのライブストリームの場合と同様に、イベントメッセージを Google が受信したかどうか、さらにそれらのメッセージが特定の requestId に適合した適切な形式のメッセージであるかどうかを検証できます。右側のフィルタパネルを使用すると、適切な形式のメッセージなども除外できます。

集約イベントのエラーメッセージの詳細については、ClientEvent 検証エラーのトラブルシューティングをご覧ください。

ジョブと会社のデータ

ジョブと会社ページを使用して、以下の操作を行います。

ジョブと会社のカウントを種類とカテゴリ別に分類して表示します。
名前または求人 ID で特定のジョブの詳細を検索します。
ジョブ、会社、テナントのデータを BigQuery データセットにエクスポートします。

コンソールをまだ設定していない場合は、始める前にの手順に沿ってアクセスしてください。

ジョブデータの表示と検索

[ジョブと会社] ページの [概要] タブには、ジョブと会社の数に関する集計情報が表示されます。

最新のスナップショットの数の表には、募集中のジョブと削除されたジョブの数と、前日のアクティブな会社のカウントの概要が表示されます。このスナップショットは 1 日に 1 回更新されます。
時間の経過に伴うカウント数のグラフは、選択した期間におけるジョブと会社のカウントを可視化します。プルダウンフィルタを使用して、表示するタイプ、テナント、期間を選択します。

[ジョブのメタデータ] タブには、特定の求人の詳細を検索するためのツールが表示されます。最大 10 個の求人名または求人 ID を検索して、それらのジョブで使用可能なメタデータを含むテーブルを取得できます。特定の求人の結果が見つからない場合（不正な名前や ID が入力された場合など）、その求人名または ID のテーブル行には NOT_FOUND の結果が表示されます。

データを BigQuery にエクスポートする

ジョブ、会社、テナントごとにデータを BigQuery にエクスポートすると、さらにトラブルシューティングを行うことができます。

BigQuery の権限を CTS サービスアカウントに付与するには:

アプリケーションのCloud コンソール IAMページで、ロールを割り当てる新しいプリンシパル BigQuery ジョブユーザー をgjobs-bq-prod@system.gserviceaccount.com に追加します。

BigQuery でのロールの付与については、単一の役割を付与するをご覧ください。
BigQuery SQL ワークスペースで、一意の名前を使用して新しい BigQuery データセットを作成します。

このデータセットは、エクスポートされた CTS データに使用します。
BigQuery SQL ワークスペースで、CTS データをエクスポートするデータセットを見つけます。[共有] をクリックし、gjobs-bq-prod@system.gserviceaccount.com BigQuery データ編集者へのアクセス権を付与します。

詳細については、BigQuery ドキュメントのデータセットへのアクセス権の付与をご覧ください。

CTS からデータをエクスポートするには:

CTS コンソールで、[ジョブと会社] ページの [エクスポート] タブに移動します。
[Generate BigQuery Export] で、ジョブ、会社、テナントのうちどれをエクスポートするかを選択します。
データのエクスポート先となる既存の BigQuery テーブルを選択します。
[生成] をクリックしてデータをエクスポートします。

[データのエクスポート] タブには、進行中のエクスポートジョブが表示され、データが生成されたときに BigQuery 内のエクスポートされたデータセットへのリンクが表示されます。

サービスアカウント管理

アカウントに関連付けられている認証情報を使用して API リクエストを行うには、サービスアカウントを Cloud Talent Solution に接続する必要があります。サービスアカウント接続ツールを使用して、サービスアカウントを管理します。Google Cloud プロジェクトに関連付けられたすべてのサービスアカウントが一覧表示されます。 [接続] をクリックしてサービスアカウントを Cloud Talent Solution に関連付けます。サービスアカウントの詳細については、サービスアカウントの作成と管理をご覧ください。

`ClientEvent` 検証エラーのトラブルシューティング

単一のイベントに基づく検証

定数	UI 文字列
RELATED_JOB_ID_INVALID	`ClientEvent` メッセージに 1 つ以上の無効または誤った `relatedJobNames` があります。
EVENT_ID_REUSED	`eventId` は、Google Cloud プロジェクトに対して一意であることが必要です。この場合、メッセージには以前に Google Cloud プロジェクトによって生成された `eventId` が含まれます。一意性を確保するために、各 `eventId` になんらかの形式のタイムスタンプを組み込むことをおすすめします。
MISSING_REQUIRED_FIELDS	必須項目が欠落しています。`ClientEvent` スキーマを調べて欠落している必須項目を特定してください。
INVALID_FIELDS	メッセージの 1 つ以上の項目が不完全であるか、Cloud Talent Solution で想定されていなかったものです。`ClientEvent` スキーマを確認して必須項目と、それらのフィールドで想定される値の詳細について調べてください。
UNKNOWN_FIELDS	不明な項目を受信しました。
INVALID_FORMAT	Cloud Talent Solution の `ClientEvent` メッセージで無効な JSON 文字列を受け取りました。たとえば、中かっこがありません。

requestId による集約検証

定数	説明
NO_SEARCH_IMPRESSION	`IMPRESSION` イベントがありません。
VIEWS_FEWER_THAN_APPLY_STARTS	`VIEW` イベントの数が `APPLICATION_START` イベントの数より少なくなっています。この原因として、`VIEW` イベントが正しく Cloud Talent Solution に送信されていないか、UI の [適用] ボタンがトリガーされたものの、実際にはビューをトリガーしていないことが考えられます。これが想定された動作である（たとえば、検索結果ページに、求職者が求人の詳細を表示せずにクリックできる [適用] ボタンがある）場合、このユースケースでは、代わりに `APPLICATION_START_FROM_SERP` イベントを使用することを検討してください。
VIEWS_FEWER_THAN_APPLY_REDIRECTS	`VIEW` イベントの数が `APPLICATION_REDIRECT` イベントの数より少ないです。この原因として、`VIEW` イベントが正しく Cloud Talent Solution に送信されていないか、UI の [適用] ボタンがトリガーされたものの、実際にはビューをトリガーしていないことが考えられます。これが想定された動作である（たとえば、検索結果ページに、求職者が求人の詳細を表示せずにクリックできる [適用] ボタンがある）場合、このユースケースでは、代わりに `APPLICATION_REDIRECT_FROM_SERP` イベントを使用することを検討してください。
APPLY_STARTS_FEWER_THAN_APPLY_FINISHES	`APPLICATION_START` メッセージが一部のインスタンスで送信されていない、または `APPLICATION_FINISH` メッセージが送信されてはならない場合にインスタンスで送信される状態となっており、構成が誤っていることがこの原因として考えられます。`APPLICATION_START` メッセージの数は `APPLICATION_FINISH` メッセージの数と同じ以上であることが理想的です。