Cloud Talent Solution の管理ツール

Cloud Talent Solution のダッシュボード

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

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

詳細については、ダッシュボードのドキュメントをご覧ください。

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

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

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

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

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

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

ジョブと会社のデータ

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

  • ジョブと会社のカウントを種類とカテゴリ別に分類して表示します。

  • 名前または求人 ID で特定のジョブの詳細を検索します。

  • ジョブ、会社、テナントのデータを BigQuery データセットにエクスポートします。

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

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

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

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

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

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

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

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

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

    BigQuery でのロールの付与については、単一の役割を付与するをご覧ください。

  2. BigQuery SQL ワークスペースで、一意の名前を使用して新しい BigQuery データセットを作成します。

    このデータセットは、エクスポートされた CTS データに使用します。

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

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

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

  1. CTS コンソールで、[ジョブと会社] ページの [エクスポート] タブに移動します。

  2. [Generate BigQuery Export] で、ジョブ、会社、テナントのうちどれをエクスポートするかを選択します。

  3. データのエクスポート先となる既存の BigQuery テーブルを選択します。

  4. [生成] をクリックしてデータをエクスポートします。

    [データのエクスポート] タブには、進行中のエクスポート ジョブが表示され、データが生成されたときに 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 メッセージの数と同じ以上であることが理想的です。