클라이언트 이벤트를 사용하여 검색 결과 개선(v3)

Cloud Talent Solution은 머신러닝을 채용정보 검색 환경에 적용하여 일반적인 키워드 기반 방법의 한계를 훨씬 뛰어넘는 우수한 검색결과를 구직자에게 제공하는 서비스입니다. CTS는 처음부터 관련성 모델 및 직업/기술 온톨로지를 채용정보 세부정보에 적용합니다. 구직자의 활동에 따라 클라이언트 이벤트를 기록하면 구직자에게 반환되는 결과를 개선할 수 있습니다.

이 기능을 활용하는 방법에는 두 가지가 있으며 이 빠른 시작에서 모두 설명합니다. Cloud Pub/Sub를 사용하여 Cloud Talent Solution에 메시지를 보내는 인증 문제를 무시하고 분석 프레임워크를 구현하는 간결한 API 세트를 제공하는 createClientEventRequest API 메서드를 사용하는 것이 좋습니다.

이 가이드를 마치면 클라이언트 이벤트 데이터를 게시할 수 있게 됩니다.

구직자가 특정 작업을 수행하는 경우, API를 사용하여 해당 작업을 기록할 수 있습니다. 예를 들어, 구직자 또는 서비스와 상호작용하는 다른 개체에서는 압축되거나 잘린 형식의 검색결과 목록과 같이 자신의 시각에서 렌더링된 채용정보(또는 채용정보 목록)를 가지고 있습니다. 이러한 경우 Cloud Talent Solution에 IMPRESSION 이벤트를 전송하여 검색결과의 컨텍스트 및 구직자가 볼 수 있는 내용을 제공할 수 있습니다. 뿐만 아니라 구직자가 채용정보 결과를 클릭하여 전체 세부정보를 조회하면 VIEW 이벤트를 전송하여 구직자가 해당 직책에 관심을 보인 사실을 등록할 수 있습니다.

용도

다음 예시는 API를 사용하여 Cloud Talent Solution에 메시지를 보내는 방법을 보여줍니다. 구직자 또는 서비스와 상호작용하는 다른 개체에서는 압축되거나 잘린 형식의 검색결과 목록과 같이 자신의 시각에서 렌더링된 채용정보(또는 채용정보 목록)를 가지고 있습니다. 이 이벤트는 일반적으로 구직자가 한 페이지에서 채용정보 목록을 열람하는 것과 관련이 있습니다.

자바

Cloud Talent Solution 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Talent Solution 클라이언트 라이브러리를 참조하세요.


public static void createClientEvent(String eventId, String requestId,
    List<String> relatedJobNames)
    throws IOException {
  DateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");
  String date = dateFormat.format(new Date());

  ClientEvent clientEventToBeCreated = new ClientEvent()
      .setCreateTime(date)
      .setEventId(eventId)
      .setParentEventId("NULL")
      .setJobEvent(
          new JobEvent().setJobs(relatedJobNames)
              .setType("VIEW"))
      .setRequestId(requestId);
  CreateClientEventRequest createClientEventRequest = new CreateClientEventRequest()
      .setClientEvent(clientEventToBeCreated);

  ClientEvent returnedEvent = talentSolutionClient.projects().clientEvents()
      .create(DEFAULT_PROJECT_ID, createClientEventRequest).execute();
  System.out.println(returnedEvent);
}

Python

Cloud Talent Solution 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Talent Solution 클라이언트 라이브러리를 참조하세요.

def create_client_event(client_service, event_id, request_id, related_job_names):
    now = datetime.datetime.now()
    date = now.strftime('%Y-%m-%dT%H:%M:%SZ')

    client_event_to_be_created = {
        'create_time': date,
        'event_id': event_id,
        'parent_event_id': 'NULL',
        'job_event': {
            'jobs': related_job_names,
            'type': 'VIEW'
        },
        'request_id': request_id
    }
    request = {
        'client_event': client_event_to_be_created
    }
    response = client_service.projects().clientEvents().create(
        parent=parent, body=request).execute()
    print(response)

사용 가능한 이벤트 유형의 전체 목록은 이벤트 유형을 참조하세요.

Cloud Pub/Sub를 사용하여 클라이언트 이벤트 요청 기록

요구사항

pubsub 메시지를 게시하려면 프로젝트 p-jobs 및 주제 cloud-jobs-events 메시지를 게시해야 합니다.

requestID가 포함되지 않은 pubsub 메시지는 삭제됩니다.

기본 요건

다음이 필요합니다.

이 가이드에서는 통합 안내를 통해 게시자 클라이언트를 만들고, Cloud Pub/Sub를 통해 클라이언트 이벤트를 게시하고, 정리합니다. 자바 코드를 사용하는 Cloud Talent Solution 애플리케이션에 대한 단계적 안내를 통해 통합을 보여주며, 자바 클라이언트 라이브러리를 설명하는 것보다 Cloud Talent Solution을 호출하는 방법에 초점을 맞춥니다.

Cloud Talent Solution에 클라이언트 이벤트 데이터 게시

이 섹션에서는 Cloud Talent Solution에 클라이언트 이벤트 데이터를 게시하는 방법을 안내합니다. 이를 통해 특정 비즈니스와 구직자 요구의 관련성을 높일 수 있습니다.

Google Cloud Pub/Sub 게시자 가이드를 따라 Cloud Talent Solution에 메시지를 게시합니다.

전송된 실제 메시지가 아래 설명된 패턴을 따르는지 확인하세요.

샘플 메시지

IMPRESSION 이벤트

JSON

    {
      "eventId": "857523730h91wrgkih9qpl12z8bf",
      "eventType": "IMPRESSION",
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "relatedJobNames": [
        "jobs/4000000000",
        "jobs/4000000001"
      ],
      "eventTimestampMillis": 1518200614309,
    }
    

VIEW 이벤트

JSON

    {
      "eventId": "9q9wa69qgfx1q1xzwn3zo25z",
      "eventType": "VIEW",
      "requestId": "248pla4w-8wpl-87rt-15rt-430ue8u541m8",
      "relatedJobNames": [
        "jobs/8000000000",
        "jobs/8000000001"
      ],
      "eventTimestampMillis": 1518200617426,
    }
    

Cloud Talent Solution 관리 도구를 사용하여 구현 확인

Cloud Talent Solution에서는 셀프 서비스 도구를 제공하여 API 사용자가 구현을 확인할 수 있습니다. 셀프 서비스 도구에 대해 자세히 알아보세요.