Esta página foi traduzida pela API Cloud Translation.
Switch to English

Melhorar o modelo pré-treinado com dados de eventos do cliente

A Cloud Talent Solution é um serviço que leva o aprendizado de máquina para a experiência de procura de emprego, retornando aos candidatos resultados de alta qualidade muito além das limitações dos métodos típicos baseados em palavras-chave. Logo de início, o CTS já aplica automaticamente modelos de relevância e ontologias de vaga/competência aos detalhes da vaga. É possível melhorar os resultados retornados aos candidatos registrando os eventos do cliente com base nas atividades do candidato.

Registrar eventos do cliente usando createClientEventRequest

Quando um candidato executa uma ação específica, é possível usar a Pesquisa de vagas para registrar essa ação. Por exemplo, uma vaga (ou uma lista de vagas) foi exibida para o candidato, ou outra entidade que interage com o serviço, como em uma lista de resultados da pesquisa no formato compactado ou recortado. Envie um evento IMPRESSION para o Cloud Talent Solution para fornecer dados sobre o contexto da pesquisa e os resultados que um candidato pode ver. Quando o candidato clica em um resultado de vaga para visualizar a descrição completa, é possível enviar um evento VIEW, que registra o interesse do candidato na vaga escolhida.

No exemplo a seguir, veja como enviar uma mensagem ao Cloud Talent Solution usando uma API. Uma vaga (ou uma lista de vagas) foi processada na exibição do candidato à vaga ou outra entidade que interage com o serviço, como em uma lista de resultados de pesquisa em formato compactado ou cortado. Esse evento geralmente está associado a um candidato que visualiza uma lista de vagas em uma única página.

Go

import (
	"context"
	"fmt"
	"io"
	"time"

	talent "cloud.google.com/go/talent/apiv4beta1"
	"github.com/golang/protobuf/ptypes"
	talentpb "google.golang.org/genproto/googleapis/cloud/talent/v4beta1"
)

// createClientEvent creates a client event.
func createClientEvent(w io.Writer, projectID string, requestID string, eventID string, relatedJobNames []string) (*talentpb.ClientEvent, error) {
	ctx := context.Background()

	// Create an eventService client.
	c, err := talent.NewEventClient(ctx)
	if err != nil {
		return nil, fmt.Errorf("talent.NewEventClient: %v", err)
	}

	createTime, _ := ptypes.TimestampProto(time.Now())
	clientEventToCreate := &talentpb.ClientEvent{
		RequestId:  requestID,
		EventId:    eventID,
		CreateTime: createTime,
		Event: &talentpb.ClientEvent_JobEvent{
			JobEvent: &talentpb.JobEvent{
				Type: talentpb.JobEvent_VIEW,
				Jobs: relatedJobNames,
			},
		},
	}

	// Construct a createJob request.
	req := &talentpb.CreateClientEventRequest{
		Parent:      fmt.Sprintf("projects/%s", projectID),
		ClientEvent: clientEventToCreate,
	}

	resp, err := c.CreateClientEvent(ctx, req)
	if err != nil {
		return nil, fmt.Errorf("CreateClientEvent: %v", err)
	}

	fmt.Fprintf(w, "Client event created: %v\n", resp.GetEvent())

	return resp, nil
}

Java

Para mais informações sobre a instalação e criação de um cliente do Cloud Talent Solution, consulte Bibliotecas de cliente do Cloud Talent Solution.


import com.google.cloud.talent.v4beta1.ClientEvent;
import com.google.cloud.talent.v4beta1.CreateClientEventRequest;
import com.google.cloud.talent.v4beta1.EventServiceClient;
import com.google.cloud.talent.v4beta1.JobEvent;
import com.google.cloud.talent.v4beta1.TenantName;
import com.google.protobuf.Timestamp;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;

public class JobSearchCreateClientEvent {

  public static void createClientEvent() throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "your-project-id";
    String tenantId = "your-tenant-id";
    String requestId = "your-req-id-from-response-metadata";
    String eventId = "your-unique-identifier-id";
    createClientEvent(projectId, tenantId, requestId, eventId);
  }

  // Creates a client event.
  public static void createClientEvent(
      String projectId, String tenantId, String requestId, String eventId) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
      TenantName parent = TenantName.of(projectId, tenantId);

      // The timestamp of the event as seconds of UTC time since Unix epoch
      // For more information on how to create google.protobuf.Timestamps
      // See:
      // https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto
      long seconds = 3L;
      Timestamp createTime = Timestamp.newBuilder().setSeconds(seconds).build();

      // The type of event attributed to the behavior of the end user
      JobEvent.JobEventType type = JobEvent.JobEventType.VIEW;

      // List of job names associated with this event
      String jobsElement = "projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]";
      String jobsElement2 = "projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]";

      List<String> jobs = Arrays.asList(jobsElement, jobsElement2);
      JobEvent jobEvent = JobEvent.newBuilder().setType(type).addAllJobs(jobs).build();
      ClientEvent clientEvent =
          ClientEvent.newBuilder()
              .setRequestId(requestId)
              .setEventId(eventId)
              .setCreateTime(createTime)
              .setJobEvent(jobEvent)
              .build();
      CreateClientEventRequest request =
          CreateClientEventRequest.newBuilder()
              .setParent(parent.toString())
              .setClientEvent(clientEvent)
              .build();
      ClientEvent response = eventServiceClient.createClientEvent(request);
      System.out.println("Created client event. ");
      System.out.println(response.toString());
    }
  }
}

Node.js

Para mais informações sobre a instalação e criação de um cliente no Cloud Talent Solution, consulte a Bibliotecas de clientes do Cloud Talent Solution.


const talent = require('@google-cloud/talent').v4;

/**
 * Creates a client event
 *
 * @param projectId {string} Your Google Cloud Project ID
 * @param tenantId {string} Identifier of the Tenant
 * @param requestId {string} A unique ID generated in the API responses.
 * Value should be set to the request_id from an API response.
 * @param eventId {string} A unique identifier, generated by the client application
 */
function sampleCreateClientEvent(projectId, tenantId, requestId, eventId) {
  const client = new talent.EventServiceClient();
  // const projectId = 'Your Google Cloud Project ID';
  // const tenantId = 'Your Tenant ID (using tenancy is optional)';
  // const requestId = '[request_id from ResponseMetadata]';
  // const eventId = '[Set this to a unique identifier]';
  const formattedParent = client.tenantPath(projectId, tenantId);

  // The timestamp of the event as seconds of UTC time since Unix epoch
  // For more information on how to create google.protobuf.Timestamps
  // See: https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto
  const seconds = 0;
  const createTime = {
    seconds: seconds,
  };

  // The type of event attributed to the behavior of the end user
  const type = 'VIEW';

  // List of job names associated with this event
  const jobsElement = 'projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]';
  const jobsElement2 =
    'projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]';
  const jobs = [jobsElement, jobsElement2];
  const jobEvent = {
    type: type,
    jobs: jobs,
  };
  const clientEvent = {
    requestId: requestId,
    eventId: eventId,
    createTime: createTime,
    jobEvent: jobEvent,
  };
  const request = {
    parent: formattedParent,
    clientEvent: clientEvent,
  };
  client
    .createClientEvent(request)
    .then(responses => {
      const response = responses[0];
      console.log('Created client event');
      console.log(`Response: ${response}`);
    })
    .catch(err => {
      console.error(err);
    });
}

Python

Para mais informações sobre a instalação e criação de um cliente no Cloud Talent Solution, consulte a Bibliotecas de clientes do Cloud Talent Solution.


from google.cloud import talent
from google.cloud.talent import enums
import six

def create_client_event(project_id, tenant_id, request_id, event_id):
    """
    Creates a client event

    Args:
      project_id Your Google Cloud Project ID
      tenant_id Identifier of the Tenant
      request_id A unique ID generated in the API responses.
      Value should be set to the request_id from an API response.
      event_id A unique identifier, generated by the client application
    """

    client = talent.EventServiceClient()

    # project_id = 'Your Google Cloud Project ID'
    # tenant_id = 'Your Tenant ID (using tenancy is optional)'
    # request_id = '[request_id from ResponseMetadata]'
    # event_id = '[Set this to a unique identifier]'

    if isinstance(project_id, six.binary_type):
        project_id = project_id.decode("utf-8")
    if isinstance(tenant_id, six.binary_type):
        tenant_id = tenant_id.decode("utf-8")
    if isinstance(request_id, six.binary_type):
        request_id = request_id.decode("utf-8")
    if isinstance(event_id, six.binary_type):
        event_id = event_id.decode("utf-8")
    parent = f"projects/{project_id}/tenants/{tenant_id}"

    # The timestamp of the event as seconds of UTC time since Unix epoch
    # For more information on how to create google.protobuf.Timestamps
    # See:
    # https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto
    seconds = 0
    create_time = {"seconds": seconds}

    # The type of event attributed to the behavior of the end user
    type_ = enums.JobEvent.JobEventType.VIEW

    # List of job names associated with this event
    jobs_element = "projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]"
    jobs_element_2 = "projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]"
    jobs = [jobs_element, jobs_element_2]
    job_event = {"type": type_, "jobs": jobs}
    client_event = {
        "request_id": request_id,
        "event_id": event_id,
        "create_time": create_time,
        "job_event": job_event,
    }

    response = client.create_client_event(parent=parent, client_event=client_event)
    print(response)

Mensagens de evento

Campos obrigatórios:

  • eventId (definido pelo cliente): cada mensagem enviada ao Cloud Talent Solution precisa ter um eventId exclusivo. Recomenda-se incorporar o carimbo de data/hora ao definir esse campo, para garantir a não duplicidade. O comprimento máximo desse campo tem 255 caracteres.

  • requestId: o valor de requestId retornado pelo objeto de resposta da pesquisa. Este valor é exclusivo para uma chamada de API SearchJobsRequest específica. Ele é usado em todas as mensagens subsequentes provenientes do evento de pesquisa IMPRESSION original. Quando uma nova chamada de API SearchJobsRequest é realizada (por exemplo: o candidato avança para a próxima página de resultados), o requestId é alterado.

  • createTime O registro de data e hora do evento (no formato Registro de data e hora, com precisão de nanossegundos. Esse carimbo precisa corresponder ao momento em que o evento realmente ocorreu, e não ao que a mensagem foi enviada.

  • Campo de união event: os objetos jobEvent são usados com o recurso Pesquisa de vagas e são emitidos quando um candidato interage com o serviço.

Mensagem do evento de amostra

A chamada da API no exemplo de código acima deve gerar uma mensagem JSON no formato a seguir:

JSON

{
  "requestId": string,
  "eventId": string,
  "createTime": string,
  "eventNotes": string,

// Union field event can be only be a jobEvent: "jobEvent": { object (JobEvent) }, // End of list of possible types for union field event. }

Cenários e fluxos de trabalho

Estes são dois exemplos de cenários com um candidato que procura, visualiza e se candidata a uma vaga.

Fluxo de trabalho 1

  1. O candidato realiza uma pesquisa. Por exemplo: Grt produto SF

    Os resultados da pesquisa são retornados para o candidato.

    O objeto de resposta da pesquisa de vagas retornado ao servidor do cliente contém um requestId exclusivo (por exemplo, 8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==). Use esse requestId para todas as futuras mensagens relacionadas a essa chamada de API SearchJobsRequest específica.

    Envie uma mensagem IMPRESSION para o Cloud Talent Solution.

    Mensagem do evento de amostra:

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID1",
      "createTime": "2018-12-19T16:39:57-08:00",
      "jobEvent":
      {"type":"IMPRESSION",
      "jobs":["jobs/4000000000", "jobs/4000000001","jobs/4000000002",
      "jobs/4000000003", "jobs/4000000004"]}
    }
    
  2. O candidato seleciona um resultado (uma postagem de vaga) para visualizar os detalhes completos.

    Envie uma mensagem VIEW para o Cloud Talent Solution.

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID2",
      "createTime": "2018-12-19T16:40:57-08:00",
      "jobEvent":
      {"type":"VIEW",
      "jobs":["jobs/4000000000"]}
    
    }
    
  3. A pessoa se candidata à vaga da postagem visualizada.

    a. Caso o candidato seja redirecionado para uma página dentro do mesmo domínio (uma página de aplicativo interno), envie ao Cloud Talent Solution uma mensagem APPLICATION_START.

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID3",
      "createTime": "2018-12-19T16:41:57-08:00",
      "jobEvent":
      {"type":"APPLICATION_START",
    "jobs":["jobs/4000000000"]}
    }
    

    b. Se o candidato for redirecionado para uma página de aplicativo externa, envie ao Cloud Talent Solution uma mensagem APPLICATION_REDIRECT.

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID3",
      "createTime": "2018-12-19T16:41:57-08:00",
      "jobEvent":
      {"type":"APPLICATION_REDIRECT",
      "jobs":["jobs/4000000000"]}
    
    }
    
  4. Quando a pessoa concluir uma candidatura interna, envie à Cloud Talent Solution uma mensagem APPLICATION_FINISH:

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID4",
      "createTime": "2018-12-19T16:43:57-08:00",
      "jobEvent":
      {"type":"APPLICATION_FINISH",
      "jobs":["jobs/4000000000"]}
    
    }
    
  5. O candidato volta aos resultados da pesquisa e continua na página 2 (ou continua na página 2 sem ter clicado em um anúncio de vaga).

    Envie ao Cloud Talent Solution uma mensagem IMPRESSION com o próximo conjunto de resultados da segunda página. Observação: há um novo requestId que é gerado na resposta da chamada da API SearchJobsRequest que gera a segunda página de resultados. (por exemplo, 99e5b99c-f1ba-4f85-b17d-ccf878f451f9:APAb7IRESj+/Hzwa3bBd54P3qPx2yOWm5w==).

    {
      "requestId": "99e5b99c-f1ba-4f85-b17d-ccf878f451f9:APAb7IRESj+/Hzwa3bBd54P3qPx2yOWm5w==",
      "eventId": "ID5",
      "createTime": "2018-12-19T18:39:57-08:00",
      "jobEvent":
      {"type":"IMPRESSION",
      "jobs":["jobs/4000000005", "jobs/4000000006","jobs/4000000007",
      "jobs/4000000008", "jobs/4000000009"]}
    }
    
  6. O candidato avança à página 3 dos resultados da pesquisa.

    Envie ao Cloud Talent Solution uma mensagem IMPRESSION com o próximo conjunto de resultados. OBSERVAÇÃO: há um novo requestId (por exemplo, e2d2b916-78c3-4c65-aecc-d8452bc0afb0:APAb7IRvCsNPiRXYkgF8PN5e8BkbFzKOyg==).

    {
      "requestId": "e2d2b916-78c3-4c65-aecc-d8452bc0afb0:APAb7IRvCsNPiRXYkgF8PN5e8BkbFzKOyg==",
      "eventId": "ID6",
      "createTime": "2018-12-19T16:41:57-08:00",
      "jobEvent":
      {"type":"IMPRESSION",
      "jobs":["jobs/4000000010", "jobs/4000000011","jobs/4000000012",
      "jobs/400000013", "jobs/4000000014"]}
    }
    

Fluxo de trabalho 2

  1. O candidato realiza uma pesquisa. Por exemplo: Grt produto SF

    Os resultados da pesquisa são retornados para o candidato.

    O objeto de resposta da pesquisa de vaga contém um requestId exclusivo (por exemplo, a2179a9b-cf73-413e-8076-98af08b991ad). Use este requestId em todas as futuras mensagens relacionadas a esta chamada de API SearchJobsRequest.

    Envie uma mensagem IMPRESSION para o Cloud Talent Solution.

    {
      "requestId": "a2179a9b-cf73-413e-8076-98af08b991ad",
      "eventId": "ID1",
      "createTime": "2018-12-19T16:39:57-08:00",
      "jobEvent":
      {"type":"IMPRESSION",
      "jobs":["jobs/4000000000", "jobs/4000000001","jobs/4000000002",
      "jobs/4000000003", "jobs/4000000004"]}
    }
    
  2. O candidato seleciona um resultado (uma postagem de vaga) para visualizar os detalhes completos.

    Envie uma mensagem VIEW para o Cloud Talent Solution.

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID2",
      "createTime": "2018-12-19T16:40:57-08:00",
      "jobEvent":
      {"type":"VIEW",
      "jobs":["jobs/4000000000"]}
    }
    
  3. A pessoa se candidata à vaga clicando uma única vez, conforme descrito em APPLICATION_QUICK_SUBMISSION.

    Envie ao Cloud Talent Solution uma mensagem APPLICATION_QUICK_SUBMISSION com o próximo conjunto de resultados.

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID3",
      "createTime": "2018-12-19T16:41:57-08:00",
      "jobEvent":
      {"type":"APPLICATION_QUICK_SUBMISSION",
      "jobs":["jobs/4000000000"]}
     }
    
  4. O candidato realiza as ações a seguir.

    a. A pessoa volta aos resultados da pesquisa e se candidata a uma vaga diretamente na página de resultados da pesquisa. O processo de candidatura é um processo mais longo do que o definido em APPLICATION_QUICK_SUBMISSION (ou seja, trata-se de um processo de candidatura em várias etapas).

    Envie uma mensagem APPLICATION_START_FROM_SERP para o Cloud Talent Solution.

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID4",
      "createTime": "2018-12-19T16:43:57-08:00",
      "jobEvent":
      {"type":"APPLICATION_START_FROM_SERP",
      "jobs":["jobs/4000000000"]}
    }
    

    b. A pessoa conclui a candidatura à vaga. Envie uma mensagem APPLICATION_FINISH para o Cloud Talent Solution.

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID5",
      "createTime": "2018-12-19T16:44:57-08:00",
      "jobEvent":
      {"type":"APPLICATION_FINISH",
      "jobs":["jobs/4000000000"]}
    }
    
  5. A pessoa volta aos resultados da pesquisa e se candidata a uma vaga diretamente na página de resultados da pesquisa. O processo de candidatura redireciona a pessoa para outro domínio que esteja fora do site do locatário (aplicativo externo) em que o progresso do candidato não pode ser rastreado.

    Envie uma mensagem APPLICATION_REDIRECT_FROM_SERP para o Cloud Talent Solution.

    {
      "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
      "eventId": "ID6",
      "createTime": "2018-12-19T16:45:57-08:00",
      "jobEvent":
      {"type":"APPLICATION_START_FROM_SERP",
      "jobs":["jobs/4000000001"]}
    }
    

    Isso é diferente de APPLICATION_REDIRECT, em que um candidato está na página de descrição da vaga quando reencaminhado.

Verificar a implementação do evento de cliente

O Cloud Talent Solution oferece ferramentas de autoatendimento que podem ser usadas para verificar a implementação de eventos do cliente. Consulte ferramentas de gerenciamento para mais informações sobre as opções de autoatendimento disponíveis.