본문으로 건너뛰기
⌘ K
English한국어

분석

공고별 또는 워크스페이스 전체의 채용 퍼널 집계.

엔드포인트 하나가 채용 퍼널을 워크스페이스 전체 또는 공고 하나를 기준으로 건수와 중앙값으로 반환합니다. 모든 숫자는 집계값이며, 응답의 어떤 값도 특정 지원서나 사람을 가리키지 않습니다. 응답에는 잘못 읽기 쉬운 두 숫자를 어떻게 측정했는지에 대한 설명도 담겨 있습니다.

GET/analytics/hiring-funnelanalytics:read

상태별 건수, 단계별 건수, 단계별 소요 시간, 채용까지 걸린 시간, 지원서 유입 경로를 반환합니다. 파라미터가 없으면 워크스페이스의 모든 공고를 대상으로 합니다.

요청
curl https://tahoe.workonward.com/api/partner/v1/analytics/hiring-funnel \
  -H "Authorization: Bearer $TAHOE_API_KEY"
응답
{
  "object": "hiring_funnel",
  "workspace_id": "wsp_4Kd8sPm2Qx7L",
  "job_id": null,
  "status_breakdown": {
    "new": 52,
    "in_review": 41,
    "advanced": 31,
    "rejected": 20,
    "withdrawn": 2,
    "hired": 2
  },
  "funnel": [
    { "stage": "Applied", "position": 1, "count": 70 },
    { "stage": "Screen", "position": 2, "count": 41 },
    { "stage": "Interview", "position": 3, "count": 12 },
    { "stage": "Offer", "position": 4, "count": 3 },
    { "stage": "Hired", "position": 5, "count": 2 },
    { "stage": "Rejected", "position": 6, "count": 20 }
  ],
  "time_in_stage": [
    { "stage_type": "Applied", "median_days": 3.2, "applications": 68 },
    { "stage_type": "Screen", "median_days": 4.5, "applications": 41 },
    { "stage_type": "Interview", "median_days": 9.0, "applications": 12 },
    { "stage_type": "Offer", "median_days": 2.5, "applications": 3 }
  ],
  "time_to_hire": { "median_days": 31.0, "hires": 2 },
  "source_mix": { "public_board": 131, "ats:greenhouse": 17 },
  "totals": { "applications": 148, "applicants": 141, "jobs": 6 },
  "method": {
    "time_in_stage": "Median days that in-flight applications have spent in their current stage, grouped by stage type. Excludes rejected, withdrawn and hired applications.",
    "time_to_hire": "Median days from applied_at to the hire event, derived from the activity log and falling back to updated_at.",
    "aggregate_only": true
  }
}

expensive 속도 제한 등급(분당 60건)에 속합니다. 숫자는 천천히 바뀌므로, 페이지를 볼 때마다 호출하지 말고 일정 주기로 가져와 저장해 두세요.

각 숫자의 의미

필드의미
status_breakdown상태별 지원서 수입니다. new, in_review, advanced, rejected, withdrawn, hired.
funnel지금 각 파이프라인 단계에 있는 지원서 수로, 단계 순서대로 워크스페이스가 정한 단계 이름으로 표시합니다. 워크스페이스 전체를 볼 때는 여러 공고에서 이름과 위치가 같은 단계를 합산합니다.
time_in_stage진행 중인 지원서가 현재 단계에 머문 일수의 중앙값으로, 단계 유형별로 묶습니다. applications는 집계에 포함된 지원서 수입니다.
time_to_hire채용된 지원서가 지원부터 채용까지 걸린 일수의 중앙값입니다. hires는 집계에 포함된 채용 건수입니다.
source_mix유입 경로별 지원서 수로, 많은 순서대로 최대 20개 경로를 보여 줍니다. 예를 들어 Tahoe 채용 공고 게시판은 public_board, 고객사 ATS에서 가져온 지원서는 ats: 뒤에 ATS 이름을 붙인 값입니다. 경로가 기록되지 않은 지원서는 unknown으로 집계합니다.
totals지원서 수, 서로 다른 지원자 수, 지원서가 있는 서로 다른 공고 수입니다.
methodtime_in_stage와 time_to_hire를 어떻게 측정하는지 쉬운 말로 설명한 메모, 그리고 aggregate_only: true입니다.

차트로 그리기 전에 읽어 보세요

funnel의 단계 이름은 각 공고의 파이프라인에 속하므로, 두 공고의 퍼널은 같은 단계를 쓸 때만 단계별로 비교할 수 있습니다. source_mix의 키는 정해지지 않은 집합으로 다루세요. 새 경로가 언제든 나타날 수 있습니다. 한 사람이 두 번 이상 지원하면 totals.applicants가 totals.applications보다 작아지며, 이는 정상입니다.

공고 하나씩 보기

job_id를 보내면 모든 숫자가 공고 하나로 좁혀집니다. 다른 워크스페이스의 공고 핸들은 0으로 가득한 보고서가 아니라 404를 반환합니다.

요청
curl "https://tahoe.workonward.com/api/partner/v1/analytics/hiring-funnel?job_id=job_7Kd2mXq4Rp8v" \
  -H "Authorization: Bearer $TAHOE_API_KEY"

집계값은 집계값으로만 쓰세요

aggregate_only: true는 이 엔드포인트의 용도를 밝힙니다. 작은 그룹의 퍼널은 이미 가진 데이터와 결합하면 사람을 식별할 수 있습니다. 건수가 1인 단계를 지원서 목록과 맞춰 보면 특정인이 드러납니다. 숫자를 그렇게 쓰지 마세요. 같은 이유로 고용 기회 균등 및 다양성 수치는 개인별로도, 합계로도 API로 제공하지 않습니다.

관련 이벤트

분석 이벤트는 없습니다. 지원서가 바뀔 때마다 숫자가 움직이기 때문입니다. 일정 주기로, 또는 변경 피드에서 지원서 이벤트 묶음을 처리한 뒤 다시 계산하세요.