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 検証エラーのトラブルシューティングをご覧ください。

求人のエクスポート

求人のエクスポート ツールを使用して、求人データをエクスポートし、Cloud Talent Solution によってインデックス登録された求人の JSON ファイルを生成します。 表示する求人項目を選択するためのオプションは 3 つあります。

  1. デフォルトの項目: namedistributorIdrequisitionId などがあります
  2. 選択した項目: 含める項目を最大 10 個選択します。
  3. すべての項目: このオプションでは、項目の上部に示されているタイムスタンプの時点でのスナップショットに基づいて JSON が生成されます。

オプションを選択し、「生成」を選択して JSON ファイルを作成します。これでエクスポートのレコードを表に表示できます。ダウンロード リンクをクリックしてファイルをダウンロードします。

システム内に 3,000,000 件を超える求人があり、ALL_FIELDS 以外のオプションを選択している場合、最近作成された 3,000,000 件の求人のみが返されます。

パフォーマンスの問題がこれ以上発生しないように、ファイルが大きすぎる場合、Google ではこのオプションを無効にします。

サービス アカウント管理

アカウントに関連付けられている認証情報を使用して 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 メッセージの数と同じ以上であることが理想的です。