Job Search API 매개변수: 권장사항

API 구성

검색결과에 영향을 미치는 요소

'추천 취업정보', '확장 사용', '키워드 일치 사용 안 함'은 모두 구직자에게 반환되는 취업정보의 수와 관련성에 큰 영향을 미칩니다. 이 3가지 요소의 가장 적절한 구성은 비즈니스 요구사항에 따라 다릅니다. 최적의 구성을 결정하는 가장 좋은 방법은 다양한 테스트 시나리오를 적용하고 테스트 단계에서 결과를 평가하는 것입니다.

  1. 추천 취업정보: 추천 취업정보를 사용하여 개별 취업정보에 프로모션 값을 할당하면 비즈니스 요구사항에 중요한 취업정보를 강조표시할 수 있습니다. 권장사항과 구현 세부정보는 추천 취업정보 문서를 참조하세요.

  2. disableKeywordMatch: 이 매개변수를 사용하면 API가 ML 알고리즘에 따라 선별된 관련 결과 외에도 키워드 일치를 반환할 수 있습니다. 기본 설정은 false입니다. 기본 설정을 유지하면 ML 알고리즘에서 관련성이 있는 것으로 반환하지는 않았지만 제목 또는 취업정보 설명과 구직자의 쿼리 문자열에서 키워드 일치를 나타내는 취업정보를 CTS Job Search API에서 반환합니다. 이 매개변수를 true로 설정하면 키워드 일치가 사용 중지되므로 더 적은 수의 취업정보가(ML 기능에 의해 관련성이 있다고 확인된 취업정보만) 반환됩니다.

  3. enableBroadening: 이 매개변수를 사용하면 위치 및 취업정보 카테고리에 대한 명시적 제한을 완화하여 구직자의 쿼리를 확장할 수 있습니다. 기본적으로 false로 설정되고, true로 설정하면 사용 설정됩니다. 반환되는 검색결과의 수를 늘리는 데 사용합니다.

검색 구성 결과

가장 관련성 높은 취업정보만 반환하려면 disableKeywordMatchtrue로 설정하고 enableBroadeningfalse로 설정합니다. 이렇게 하면 관련성 있는 취업정보만 반환되므로 검색 관련성과 관련된 API의 성능 측정항목이 향상됩니다. 하지만 검색결과에 반환되는 전체 취업정보의 수는 감소합니다.

관련성 있고 키워드 일치 결과가 모두 포함된 더 많은 수의 취업정보를 반환하려면 disableKeywordMatchfalse로 설정하고 enableBroadeningfalse로 설정합니다. 키워드 일치 결과는 결과에서 관련성 있는 취업정보 다음에 나열되지만, 검색어 확장 결과는 반환되지 않습니다.

관련성 있고 검색어 확장 결과가 모두 포함된 더 많은 수의 취업정보를 반환하려면 disableKeywordMatchtrue로 설정하고 enableBroadeningtrue로 설정합니다. 구직자의 쿼리가 관련된 취업정보 카테고리 및 가까운 위치를 포함하도록 확장되어 관련성 있는 결과 다음에 나열됩니다. 키워드 기반 일치 항목은 반환되지 않습니다.

가능한 가장 많은 수의 취업정보를 반환하려면 disableKeywordMatchfalse로 설정하고 enableBroadeningtrue로 설정합니다. Job Search API는 검색결과의 상단에 가장 관련성 있는 취업정보를 반환하고, 그 다음에 키워드 일치 취업정보와 검색어 확장 취업정보(위치, 취업정보 카테고리 등으로)를 표시합니다. 이렇게 하면 반환되는 취업정보의 총 개수가 극대화됩니다.

diasableKeywordMatch enableBroadening 결과
- - 관련성 있고 키워드가 일치하는 결과를 모두 포함하는 많은 수의 취업정보를 반환합니다(단 추천 취업정보는 'false'로 설정된다고 가정).
+ + 관련성 있고 검색어가 확장된 취업정보를 모두 포함하여 많은 수의 취업정보를 반환합니다(단 추천 취업정보가 'false'로 설정된다고 가정).
- + 가장 많은 수의 취업정보를 반환합니다(단 추천 취업정보가 'false'로 설정된다고 가정).
+ - 가장 관련성 높은 취업정보만 반환합니다(단 추천 취업정보가 'false'로 설정된다고 가정).

Request.page_size

최고의 성능을 얻고 지연을 피하려면 한 번에 20개 이하의 취업정보를 표시하도록 결과 페이지를 설정합니다.

customAttributes

customAttributes를 사용하면 비즈니스 요구사항(예: GPA 점수)에 따라 취업정보에 값을 추가로 할당하고 이러한 값을 사용하여 결과를 필터링할 수 있습니다.

위치 필드

위치 필드의 자세한 개요는 위치 필드 페이지에서 확인할 수 있습니다. 주소 필드에 GPS 좌표 대신 직장의 주소를 제공하면 API가 위치 감지 및 검색 관련성을 향상시키는 데 도움이 됩니다.

locationFilter

한 회사에 서로 다른 지역의 여러 취업정보가 있는 경우 regionCode를 사용합니다. 각 목록에 regionCode를 할당하면 검색어가 해당 회사의 글로벌 결과 대신 구직자가 원하는 위치의 취업정보만 반환합니다. 예를 들어 regionCode 없이 위치 키워드 '캠브리지'를 검색하면 영국의 캠브리지와 미국 메사추세츠주의 캠브리지라는 결과가 반환됩니다. 이 경우 검색 관련성이 감소합니다.

Region_codeLanguage_code

사용자가 검색하는 지리적 위치(예: 영국)와 일치하도록 request.filters.location_filters.region_code를 설정합니다. request.filters.language_code를 해당 지역(이 경우 en_GB)의 적절한 언어 코드로 설정하여 API가 현지화된 검색 로직(예: 미국은 'truck driver'이지만 en_GB은 'lorry driver')을 사용하도록 합니다.

radiusinMiles

이 매개변수는 구직자가 표시한 위치를 중심으로 반경(마일 단위)을 설정합니다. API는 이 지리적 범위 안의 결과를 반환합니다. 이 거리가 검색결과의 위치에 적용되는 방식은 입력한 위치 정보의 유형에 따라 다릅니다. 구직자가 주소를 입력한 경우 radiusInMiles 거리는 단일 지점으로부터 설정됩니다. 구직자가 도시를 입력한 경우에는 API가 도시 경계 주변에 경계 상자를 적용하고 상자 가장자리에서 거리를 계산합니다. 사용자가 주 또는 국가만 입력한 경우에는 radiusInMiles가 무시됩니다.

마일 반경을 최대한 작게 설정하세요. 마일리지를 더 큰 범위로 설정하면 구직자가 원하는 위치를 벗어난 결과를 얻을 수 있으므로 관련성은 줄어 듭니다. 예를 들어 radiusInMiles가 100마일로 설정된 뉴욕 시에서 취업정보를 검색하면 뉴욕 북부와 뉴저지의 결과가 모두 반환됩니다. 반경을 최대한 작게 유지하면 결과의 관련성이 높아집니다.

postingExpireTime

이 매개변수는 취업정보가 검색결과에서 삭제되기 전에 활성 상태인 시간을 설정합니다. 기본값은 UTC 시간대에서 취업정보 생성 시간 이후 30일입니다.

Job_employment_type

필수 필드는 아니지만 Job_employment_type을 사용하면 취업정보 검색결과의 관련성이 높아집니다.

API 구성: 커스텀 순위

추천 취업정보는 검색결과에 영향을 주고 단일 변수(promotionValue)를 기반으로 취업정보를 강조표시할 수 있는 기능을 제공합니다. 자세한 내용은 추천 취업정보 문서를 참조하세요. 커스텀 순위는 여러 변수를 기반으로 결과에 영향을 줄 수 있는 기능을 제공하여 관련성에 관계없이 순위를 보다 효과적으로 제어할 수 있게 해줍니다. 이 기능은 다층적인 클릭당비용(CPC, Cost-per-Click) 가입자 시스템과 같이 관련성과 경제적 이익의 균형을 필요로 하는 애플리케이션에 유용합니다. 기존 관련성 점수 외에도 2개의 변수 rankingExpressionimportanceLevel로 취업정보의 순위가 지정되는 방식에 영향을 미칠 수 있습니다.

  • rankingExpression: 이 변수는 API 알고리즘에 의해 결정된 기존의 관련성 점수에 따라 취업정보의 순위가 결정되는 방식을 제어합니다. API가 매개변수의 색인을 생성하려면 'rankingExpression'이 'filterable'로 설정되어야 합니다.

  • importanceLevel: 이 매개변수는 취업정보가 검색에서 반환될 때 취업정보 순위의 중요도 수준을 설정합니다. 미지정, NONE, LOW, MID, HIGH, EXTREME 등 6가지 수준이 있습니다. 값을 EXTREME으로 설정하면 API에서 생성된 다른 모든 관련도 요소가 무시되므로 이 값은 되도록 사용하지 마세요. 구직자의 쿼리 상단에 가장 관련성이 높은 취업정보 대신 EXTREME으로 설정된 취업정보가 반환됩니다.

  • 추천 취업정보커스텀 순위 비교: 추천 취업정보는 단일 카테고리의 취업정보(예: 특정 회사의 취업정보)를 관련성 순위보다 더 높게 승급하는 데 가장 유용합니다. 관련성 순위 외에 여러 수준의 클릭당비용(CPC, Cost Per Click) 변수에 따라 취업정보의 순위를 지정해야 하는 경우에는 커스텀 순위를 사용하는 것이 더 낫습니다.

통근 조건 검색은 구직자가 통근 시간을 기준으로 취업정보를 찾는 데 유용합니다. 이 기능을 사용하려면 JobQuery.commuteFilter 필드에 추가 CommuteFilter 객체를 포함하세요. 이 객체를 사용하면 구직자가 commuteMethod, travelDuration, startCoordinates를 선택할 수 있습니다. 구직자는 통근 시간을 계산할 때 roadTraffic(TRAFFIC_FREE 또는 BUSY_HOUR)과 departureTime 같은 옵션을 선택할 수도 있습니다. 자세한 내용은 통근 조건 검색 구현안내 페이지를 참조하세요.

다중 테넌시(선택사항)

Cloud Talent Solution은 테넌트를 Google Cloud Platform 프로젝트와 업로드된 데이터 사이의 중간 조직 계층으로 지원합니다. 테넌트는 테넌시 장벽을 넘는 데이터 공유를 방지하여 여러 프로젝트가 없어도 데이터를 격리합니다. 다중 테넌시는 2명 이상의 고객을 지원하지만 고객들 간의 데이터 공유를 원하지 않고, 내부 결제 및 보고에 단일 GCP 프로젝트를 사용하려는 경우에 유용합니다. 예를 들면 다음과 같습니다.

  • 여러 자회사가 있는 조직의 취업정보 사이트를 빌드하는 취업정보 사이트 제공업체
  • 여러 기업을 대상으로 지원자 추적 시스템을 빌드하는 채용 대행업체

기본적으로 각 프로젝트에 하나의 테넌트 ID가 할당됩니다. 다중 테넌시를 구현하려면 지정된 프로젝트 내에서 테넌트를 2개 이상 만들어 기본값을 변경할 수 있습니다.

테넌트는 서로 완전히 격리되어 있습니다. 모든 API는 단일 테넌트만 요청하여 한 번의 API 호출로 여러 테넌트 사이에서 데이터를 쿼리하지 못하도록 합니다. 이와 비슷하게 머신러닝은 테넌트를 개별 단위로 취급하며 테넌시 장벽을 넘지 않습니다. 한 프로젝트에서 필요한 수만큼 테넌트를 지원할 수 있습니다.

보안

CTS의 테넌트 지원 수준은 매우 낮습니다. 따라서 요청 시 테넌트를 만들고, 테넌트 ID를 할당하고, 정확한 테넌트 ID를 제공하는 책임은 사용자에게 있습니다. CTS는 테넌트 ID가 지정된 프로젝트의 소유인지 확인한 후 제공된 테넌트에서 데이터를 검색합니다. 무단 액세스를 포착하는 추가 보안 기능은 백엔드 시스템에서 관리해야 합니다.

데이터 관리 및 오류 처리

데이터 무결성

  1. 취업정보 업로드: 데이터 문제로 인해 취업정보가 API로 업로드되지 않을 수 있습니다. 자세한 내용은 HTTP 응답 코드 페이지를 참조하세요. 일반적인 예는 다음과 같습니다.

    • 취업정보의 위치가 잘못되어 요청을 해결할 수 없습니다.
    • 회사 또는 취업정보 필드가 존재하지 않으므로 잘못된 요청이 반환됩니다.

    취업정보 업로드 문제를 해결하기 위한 3가지 기본 옵션이 있습니다.

    • 백엔드에서 로깅을 확인합니다.
    • 데이터 로깅을 위한 CTS 관리 도구를 확인합니다.
    • Cloud Console에서 Stackdriver Monitoring 도구를 설정하여 메타데이터, 측정항목, 이벤트를 수집합니다.
  2. 취업정보 색인 생성: Job Search API는 일정 기간 동안 업로드된 모든 취업정보의 색인을 생성하도록 설계되었습니다. 하지만 사용자측에 할당량 제한이 있을 수 있습니다. 취업정보를 CTS로 보내기 전에 요청의 색인 생성에 대한 제한이 있는지 시스템을 확인하세요.

오류 처리 메커니즘

오류 처리는 구직자가 차단되는 결과를 초래하는 셀프 DDoS 공격을 방지하기 위해 중요합니다. 인터넷을 통해 제공되는 API 서비스도 간헐적인 연결 실패, 장시간의 정전, 갑작스러운 서비스 유지관리, 클라이언트 애플리케이션이 API 요청을 다시 시도해야 하는 기타 이벤트를 경험할 수 있습니다. 이러한 재시도는 네트워크 친화적인 동작(예: 지수 백오프)을 수반하도록 설계되어야 합니다.

중복 제거

중복된 취업정보는 구직자의 검색 경험에 부정적인 영향을 줍니다. Job Search API에는 중복을 최소화하는 2가지 기능이 포함되어 있습니다.

  1. 취업정보 생성: 다음 기준을 사용하여 2개 이상의 취업정보를 생성하려고 시도하면 레코드가 거부되고 4xx 오류가 발생합니다.

    • 동일한 companyName
    • 동일한 job_req_id
    • 동일한 위치/languageCode
  2. 취업정보 검색: CTS Job Search API는 구직자의 검색어와 관련성 있는 취업정보를 표시합니다. 내장된 관련성 알고리즘 기능은 반환되는 취업정보를 다양화하며, 거의 동일한 취업정보가 검색결과에서 나란히 표시되지 않도록 합니다.