📥 データ管理・分析ガイド
CSV/スプレッドシートインポート、エクスポート、月次レポート、重複検知、D&I分析、リファラル追跡を解説。
CSVインポート
既存のスプレッドシートからデータを一括移行できます。候補者・企業・求人の3種類に対応。
インポートフロー
1
ファイルをドロップ
→ファイルをドロップ
2
自動マッピング
→自動マッピング
3
手動修正
→手動修正
4
プレビュー
→プレビュー
5
実行
実行
手順:
1. 候補者/企業/求人ページの「📤 インポート」ボタンをクリック
2. CSVファイルをドラッグ&ドロップ（またはファイル選択）
3. AIが自動でカラムマッピング（日本語/英語ヘッダー両対応）
4. 違う場合はドロップダウンで手動修正。「スキップ」で不要な列を除外
5. プレビュー（先頭5件）で確認
6. 「インポート実行」→ 結果表示（成功N件・エラーN件+行番号）
プラン別上限:
・Free: 100行/回（分割すれば何回でもインポート可能）
・Starter: 1,000行/回
・Basic: 5,000行/回
・Pro: 無制限
1. 候補者/企業/求人ページの「📤 インポート」ボタンをクリック
2. CSVファイルをドラッグ&ドロップ（またはファイル選択）
3. AIが自動でカラムマッピング（日本語/英語ヘッダー両対応）
4. 違う場合はドロップダウンで手動修正。「スキップ」で不要な列を除外
5. プレビュー（先頭5件）で確認
6. 「インポート実行」→ 結果表示（成功N件・エラーN件+行番号）
プラン別上限:
・Free: 100行/回（分割すれば何回でもインポート可能）
・Starter: 1,000行/回
・Basic: 5,000行/回
・Pro: 無制限
Tips: ヘッダーは「氏名」「メール」等の日本語でも、「full_name」「email」等の英語でも自動認識されます。
📊 Googleスプレッドシートインポート
Googleスプレッドシートから直接データをインポートできます。CSVに変換する手間が不要です。
インポートフロー
1
Google認証
→Google認証
2
URL入力
→URL入力
3
タブ選択
→タブ選択
4
マッピング
→マッピング
5
実行
実行
手順:
1. 候補者/企業/求人ページの「📤 インポート」→「スプレッドシートから」を選択
2. 初回はGoogleアカウント認証（ポップアップで完了→自動で戻る）
3. スプレッドシートのURLを貼り付けて「次へ」
4. データが入っているシートタブを選択
5. スプレッドシートの列とBOXの項目を対応付け（自動推測あり）
6. プレビューで確認 →「インポート実行」
特徴:
・同じBOX項目に複数列を割り当てるとカンマ区切りで結合
・求人インポート時、企業名があれば自動で企業データも作成・紐付け
・日本語/英語ヘッダー自動認識
1. 候補者/企業/求人ページの「📤 インポート」→「スプレッドシートから」を選択
2. 初回はGoogleアカウント認証（ポップアップで完了→自動で戻る）
3. スプレッドシートのURLを貼り付けて「次へ」
4. データが入っているシートタブを選択
5. スプレッドシートの列とBOXの項目を対応付け（自動推測あり）
6. プレビューで確認 →「インポート実行」
特徴:
・同じBOX項目に複数列を割り当てるとカンマ区切りで結合
・求人インポート時、企業名があれば自動で企業データも作成・紐付け
・日本語/英語ヘッダー自動認識
Tips: システム連携ページからスプレッドシート連携を事前に設定しておくと、候補者・企業・求人を一括でインポートすることもできます。
CSVエクスポート
各ページの「📥 エクスポート」ボタンでCSVダウンロード。
対象: 候補者一覧 → candidates.csv / 企業一覧 → companies.csv / 求人一覧 → jobs.csv
内容: そのテナントの全データ（フィルタなし）
求人の媒体別エクスポート: 求人詳細ページからビズリーチ/doda/Green形式のCSVも出力可能
内容: そのテナントの全データ（フィルタなし）
求人の媒体別エクスポート: 求人詳細ページからビズリーチ/doda/Green形式のCSVも出力可能
月次レポート（Excel出力）
月次サマリをExcel(.xlsx)形式でダウンロードできます。
取得方法: GET /api/tb/report/monthly
3シート構成:
・Sheet 1「月次サマリ」: KPI 10項目（候補者数・成約率・平均日数・停滞・売上見込み等）
・Sheet 2「候補者一覧」: 全候補者（氏名・現職・年収・スキル・ステータス・登録日）
・Sheet 3「選考パイプライン」: 進行中の全選考（候補者×企業×求人×ステージ×日付）
装飾: ヘッダーにアンバー色+太字。カラム幅自動調整
3シート構成:
・Sheet 1「月次サマリ」: KPI 10項目（候補者数・成約率・平均日数・停滞・売上見込み等）
・Sheet 2「候補者一覧」: 全候補者（氏名・現職・年収・スキル・ステータス・登録日）
・Sheet 3「選考パイプライン」: 進行中の全選考（候補者×企業×求人×ステージ×日付）
装飾: ヘッダーにアンバー色+太字。カラム幅自動調整
重複検知
候補者や企業の重複を自動検出します。
候補者の重複: メールアドレス / 電話番号（ハイフン・スペース除去で正規化比較）/ 氏名の完全一致
企業の重複: 表記揺れ対応 — 「株式会社A」「(株)A」「㈱A」を同一として検出
動作: 候補者/企業の新規登録時に自動チェック。重複がある場合はレスポンスに warning + duplicates が含まれる（登録自体はブロックしない）
手動チェック: POST /api/tb/check-duplicate/candidate, POST /api/tb/check-duplicate/company
企業の重複: 表記揺れ対応 — 「株式会社A」「(株)A」「㈱A」を同一として検出
動作: 候補者/企業の新規登録時に自動チェック。重複がある場合はレスポンスに warning + duplicates が含まれる（登録自体はブロックしない）
手動チェック: POST /api/tb/check-duplicate/candidate, POST /api/tb/check-duplicate/company
D&I分析（ダイバーシティ）
候補者の性別・年齢層の分布と、選考ステージ別のバイアスを分析します。
性別分布: 男性/女性/その他/未設定の人数
年齢層分布: 20代前半/20代後半/30代前半/.../50代以上
ステージ別性別: 各選考ステージごとの性別分布（例: 書類選考で男性が多い等のバイアスを検出）
API: GET /api/tb/diversity-stats
年齢層分布: 20代前半/20代後半/30代前半/.../50代以上
ステージ別性別: 各選考ステージごとの性別分布（例: 書類選考で男性が多い等のバイアスを検出）
API: GET /api/tb/diversity-stats
活用: 特定ステージで性別偏りがある場合、選考プロセスの改善を検討するデータとして活用。
リファラル追跡
候補者の登録経路（ソース）別の成約パフォーマンスを追跡します。
ソース例: referral（紹介）/ agent（エージェント）/ direct（直接応募）/ scout（スカウト）等
表示: ソース別の候補者数・成約数・成約率
API: GET /api/tb/referral-stats
表示: ソース別の候補者数・成約数・成約率
API: GET /api/tb/referral-stats
活用: 成約率が高いソースに集中投資する判断材料に。リファラルの成約率が高ければ、紹介プログラムを強化。
統合タイムライン
候補者に関連する全イベントを1つの時系列で確認できます。
含まれるイベント:
・活動履歴（メモ・面談・電話・メール・書類送付）
・選考ステージ変更（面談設定中→書類選考中等）
・面接（日時・結果・確認ステータス）
API: GET /api/tb/candidates/{id}/timeline
ソート: 全イベントを時系列（新しい順）で統合表示
・活動履歴（メモ・面談・電話・メール・書類送付）
・選考ステージ変更（面談設定中→書類選考中等）
・面接（日時・結果・確認ステータス）
API: GET /api/tb/candidates/{id}/timeline
ソート: 全イベントを時系列（新しい順）で統合表示