Se usó la API de Cloud Translation para traducir esta página.

Mejora el modelo previamente entrenado con datos de eventos de clientes

Cloud Talent Solution es un servicio que lleva el aprendizaje automático a la experiencia de búsqueda de trabajo y muestra resultados de alta calidad a los usuarios, muy por encima de las limitaciones de los métodos típicos basados en palabras clave. Desde el primer momento, CTS aplica modelos de relevancia y ontologías de habilidades o trabajos a los detalles de su trabajo. Puedes mejorar los resultados que ve un usuario que busca empleo si registras los eventos del cliente según la actividad de ese usuario.

Graba eventos de clientes mediante `createClientEventRequest`

Cuando un usuario realiza una acción específica, puedes usar la Búsqueda de trabajo para registrar esa acción. Por ejemplo, si el usuario o cualquier otra entidad que interactúa con el servicio procesó un trabajo (o una lista de trabajos) en su vista, como una lista de resultados de la búsqueda en un formato comprimido o recortado. Puedes enviar un evento de IMPRESIÓN a Cloud Talent Solution para proporcionar datos sobre el contexto de la búsqueda y los resultados que puede ver el usuario. Cuando el usuario haz clic en el resultado de un trabajo para ver la descripción completa, puede enviar un evento VER que registra el interés del usuario en el puesto elegido.

El siguiente ejemplo ilustra cómo enviar un mensaje a Cloud Talent Solution mediante una API. El usuario o cualquier otra entidad que interactúa con el servicio procesó un trabajo (o una lista de trabajos) en su vista, como una lista de resultados de búsqueda en un formato comprimido o recortado. Por lo general, este evento se asocia con los usuarios que ven una lista de trabajos en una sola página.

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de CTS, consulta las bibliotecas cliente de CTS. Para obtener más información, consulta la documentación de referencia de la API de Go de CTS.

Para autenticarte en CTS, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

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

	talent "cloud.google.com/go/talent/apiv4beta1"
	"cloud.google.com/go/talent/apiv4beta1/talentpb"
	"github.com/golang/protobuf/ptypes"
)

// 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: %w", err)
	}
	defer c.Close()

	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: %w", err)
	}

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

	return resp, nil
}

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de CTS, consulta las bibliotecas cliente de CTS. Para obtener más información, consulta la API de Java de CTS documentación de referencia.

Para autenticarte en CTS, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.


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 autenticarte en CTS, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.


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 obtener información sobre cómo instalar y usar la biblioteca cliente para CTS, consulta Bibliotecas cliente de CTS. Para obtener más información, consulta la documentación de referencia de la API de Python de CTS.

Para autenticarte en CTS, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.


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


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, bytes):
        project_id = project_id.decode("utf-8")
    if isinstance(tenant_id, bytes):
        tenant_id = tenant_id.decode("utf-8")
    if isinstance(request_id, bytes):
        request_id = request_id.decode("utf-8")
    if isinstance(event_id, bytes):
        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)

Mensajes del evento

Campos obligatorios:

eventId (definido por el cliente): Todos los mensajes que se envían a Cloud Talent Solution deben tener un eventId único. Te recomendamos incluir una marca de tiempo cuando definas este campo para garantizar que no existan duplicados. La longitud máxima de este campo es de 255 caracteres.
requestId: El valor de requestId que muestra por el objeto de respuesta de búsqueda. Este valor es exclusivo de una llamada la API SearchJobsRequest determinada. Se usa para todos los mensajes que se generen a partir del evento de IMPRESSION de búsqueda original. El requestId cambia cuando se realiza una nueva llamada a la API SearchJobsRequest (por ejemplo: el buscador de trabajo pasa a la siguiente página de resultados).
createTime La marca de tiempo del evento (en formato Marca de tiempo), con precisión de nanosegundos. Debe indicar el momento en que ocurrió el evento y no el momento en que se envió el mensaje.
Los objetos event: jobEvent de campo de unión se usan con la función de búsqueda de trabajo y se emiten cuando un usuario interactúa con el servicio.

Ejemplo de mensaje de evento

La llamada a la API en el ejemplo de código anterior debería generar un mensaje JSON en el siguiente formato:

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. }

Situaciones y flujos de trabajo

A continuación, presentamos dos ejemplos de situaciones en las que un usuario busca y visualiza un trabajo, y se postula a uno.

Flujo de trabajo 1

El usuario realiza una búsqueda. Por ejemplo: Product mgr SF.

Se muestran los resultados de la búsqueda al usuario.

El objeto de respuesta de búsqueda de trabajo que se envía de vuelta al servidor del cliente contiene un requestId único (por ejemplo: 8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==). A partir de ahora, usa este requestId para todos los mensajes futuros relacionados con esta llamada específica a la API SearchJobsRequest.

Envía un mensaje de IMPRESSION a Cloud Talent Solution.

Ejemplo de mensaje de evento:
```
{
  "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"]}
}
```

El usuario selecciona un resultado (una publicación de trabajo) para ver la información completa del trabajo.

Envía un mensaje VIEW a 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"]}

}

El usuario se postula a la publicación de trabajo que visualizó.

a. Si se redirecciona al usuario a una página dentro del mismo dominio (una página de postulación interna), envía un mensaje de APPLICATION_START a Cloud Talent Solution.

{
  "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. Si se redirecciona al usuario a una página de aplicación externa, envía un mensaje APPLICATION_REDIRECT a Cloud Talent Solution un.

{
  "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"]}

}

Cuando el usuario complete una postulación interna, envía un mensaje APPLICATION_FINISH a Cloud Talent Solution:

{
  "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"]}

}

El usuario regresa a los resultados de búsqueda y continúa a la página 2 (o continúa a la página 2 sin haber hecho clic en una publicación de trabajo).

Envía un mensaje de IMPRESSION a Cloud Talent Solution, que contenga el siguiente conjunto de resultados de la página 2. Nota: Hay un nuevo requestId que se genera en la respuesta de la llamada a la API SearchJobsRequest que genera la segunda página de resultados. (Por ejemplo, 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"]}
}
```

El usuario pasa a la página 3 de los resultados de la búsqueda.

Envía a Cloud Talent Solution un mensaje de IMPRESSION, que contenga el siguiente conjunto de resultados. NOTA: Hay un nuevo requestId (por ejemplo, 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"]}
}

Flujo de trabajo 2

El usuario realiza una búsqueda. Por ejemplo: Product mgr SF.

Se muestran los resultados de la búsqueda al usuario.

El objeto de respuesta de búsqueda de trabajo contiene un requestId único (por ejemplo: a2179a9b-cf73-413e-8076-98af08b991ad). A partir de ahora, usa este requestId para todos los mensajes futuros relacionados con esta llamada a la API SearchJobsRequest.

Envía un mensaje de IMPRESSION a 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"]}
}
```

El usuario selecciona un resultado (una publicación de trabajo) para ver la información completa del trabajo.

Envía un mensaje VIEW a 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"]}
}

La persona que busca trabajo se postula a un trabajo con un solo clic, como se describe en APPLICATION_QUICK_SUBMISSION.

Envía un mensaje APPLICATION_QUICK_SUBMISSION a Cloud Talent Solution con el siguiente 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"]}
 }

El usuario realiza las siguientes acciones:

a. El usuario regresa a la página de resultados de la búsqueda y se postula a un trabajo directamente desde allí. El proceso de postulación es más extenso que el proceso que se define en APPLICATION_QUICK_SUBMISSION (es decir, es un proceso de postulación de varios pasos).

Envía un mensaje APPLICATION_START_FROM_SERP a 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. El usuario termina de postularse al trabajo. Envía un mensaje APPLICATION_FINISH a 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"]}
}

El usuario regresa a la página de resultados de la búsqueda y se postula a un trabajo directamente desde allí. El proceso de postulación redirecciona al usuario a otro dominio fuera del sitio de la instancia (postulación externa), en el cual no se puede realizar un seguimiento del progreso del postulante.

Envía un mensaje APPLICATION_REDIRECT_FROM_SERP a 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"]}
}
```
Este mensaje es distinto al de APPLICATION_REDIRECT, en el que un usuario se encuentra en la página de descripción del trabajo cuando se redirecciona.

Verifica la implementación del evento del cliente

Cloud Talent Solution te proporciona herramientas de autoservicio que puedes usar para verificar la implementación de eventos de clientes. Consulta herramientas de administración para obtener más información sobre las opciones de autoservicio disponibles.

Mejora el modelo previamente entrenado con datos de eventos de clientes

Graba eventos de clientes mediante createClientEventRequest

Go

Java

Node.js

Python

Mensajes del evento

Ejemplo de mensaje de evento

JSON

Situaciones y flujos de trabajo

Flujo de trabajo 1

Flujo de trabajo 2

Verifica la implementación del evento del cliente

Graba eventos de clientes mediante `createClientEventRequest`