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

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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_code, Language_code

사용자가 검색중인 지리적 위치(예: 영국)와 일치하도록 request.filters.location_filters.region_code를 설정하십시오. 예를 들어 API가 미국의 '트럭 드라이버' 대신 현지화된 검색 로직(예: en_GB의 '로리 드라이버')을 사용할 수 있도록 request.filters.language_code를 해당 지역에 적합한 언어 코드(이 경우 en_GB)로 설정하십시오.

radiusinMiles

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

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

postingExpireTime

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

Job_employment_type

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

API 구성: 커스텀 순위

추천 취업정보는 검색결과에 영향을 주고 하나의 변수(promotionValue)를 기반으로 취업정보를 강조표시할 수 있는 기능을 제공합니다. 자세한 내용은 추천 취업정보를 참조하세요. 커스텀 순위는 여러 변수를 기반으로 결과에 영향을 줄 수 있는 기능을 제공하여 관련성에 관계없이 순위를 보다 효과적으로 제어할 수 있게 해줍니다. 이 기능은 다층적인 클릭당비용(CPC, Cost-per-Click) 가입자 시스템과 같이 관련성과 경제적 이익의 균형을 필요로 하는 애플리케이션에 유용합니다. 취업정보가 기존 관련성 점수의 순위를 매기는 방식에 미치는 영향은 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과 같은 옵션을 선택할 수도 있습니다. 자세한 내용은 통근 조건 검색 구현안내 페이지를 참조하세요.

데이터 관리 및 오류 처리

데이터 무결성

  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는 구직자의 검색어와 관련성 있는 취업정보를 표시합니다. 내장된 관련성 알고리즘 기능은 반환되는 취업정보를 다양화하며, 거의 동일한 취업정보가 검색결과에서 나란히 표시되지 않도록 합니다.