Mejorar el modelo preentrenado con datos de eventos de clientes (versión 3)

Cloud Talent Solution es un servicio que incorpora el aprendizaje automático a tu experiencia de búsqueda de empleo y ofrece resultados de alta calidad a las personas que buscan trabajo, sin las limitaciones de los métodos tradicionales basados en palabras clave. De forma predeterminada, CTS aplica modelos de relevancia y ontologías de empleo o habilidades a los detalles de tus empleos. Puedes mejorar los resultados que se muestran a quienes buscan empleo registrando eventos de cliente en función de su actividad.

Hay dos métodos para aprovechar esta función, que se describen en esta guía. Te recomendamos que uses el método de la API createClientEventRequest que evita los problemas de autenticación al enviar mensajes a Cloud Talent Solution con Cloud Pub/Sub y proporciona un conjunto de APIs para implementar el framework de analíticas.

Cuando un candidato realiza una acción específica, puedes usar la API para registrarla. Por ejemplo, el candidato o la otra entidad que interactúa con el servicio ha visto un empleo (o una lista de empleos) en su vista, como en una lista de resultados de búsqueda en un formato comprimido o recortado. En este caso, puedes enviar un evento IMPRESSION a Cloud Talent Solution para proporcionar el contexto de los resultados de búsqueda y lo que puede ver un candidato. Además, cuando el candidato haga clic en un resultado de empleo para ver la descripción completa, puede enviar un evento VIEW para registrar el interés del candidato en el puesto.

Registrar eventos de cliente con Cloud Pub/Sub

Para aprovechar este método, envía mensajes estructurados a Cloud Talent Solution que registren las reacciones de los candidatos a los resultados en función de sus consultas. Estos mensajes se envían a Cloud Talent Solution mediante Cloud Pub/Sub. A partir de ahí, Cloud Talent Solution analiza los mensajes del sitio del arrendatario y los envía al modelo de aprendizaje automático.

El formato de los mensajes y las solicitudes de Pub/Sub se describen a continuación.

Varios casos y flujos de trabajo

A continuación se muestran dos ejemplos de diferentes situaciones en las que un candidato busca, ve y solicita un empleo.

Ten en cuenta que SOLO debes publicar en el proyecto p-jobs y en el tema cloud-jobs-events.

Flujo de trabajo 1

  1. El candidato realiza una búsqueda. Por ejemplo: Gestor de producto de SF

    Los resultados de búsqueda se devuelven al candidato.

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

    Envía un mensaje IMPRESSION a Cloud Talent Solution.

    Mensaje de evento de ejemplo:

    {
  "eventId": "ID1",
  "eventType": "IMPRESSION",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000000", "jobs/4000000001","jobs/4000000002",
  "jobs/4000000003", "jobs/4000000004"]
  "eventTimestampMillis": 1494379614309
}

  2. La persona que busca empleo selecciona un resultado (una oferta de empleo) para ver todos los detalles del puesto.

    Envía un VIEW mensaje a Cloud Talent Solution.

    {
  "eventId": "ID2",
  "eventType": "VIEW",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000000"]
  "eventTimestampMillis": 1494379614311
}

  3. El candidato solicita el puesto de trabajo que ha visto.

    a. Si se redirige al candidato a una página del mismo dominio (una página de solicitud interna), envíe un mensaje APPLICATION_START a Cloud Talent Solution.

    {
  "eventId": "ID3",
  "eventType": "APPLICATION_START",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000000"]
  "eventTimestampMillis": 1494379614310
}

    b. Si se redirige al candidato a una página de solicitud externa, envíe un mensaje APPLICATION_REDIRECT a Cloud Talent Solution.

       {
     "eventId": "ID3",
     "eventType": "APPLICATION_REDIRECT",
     "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
     "relatedJobNames": ["jobs/4000000000"]
     "eventTimestampMillis": 1494379614310
   }

  4. Cuando el candidato complete una solicitud interna, envía un mensaje APPLICATION_FINISH a Cloud Talent Solution:

    {
  "eventId": "ID4",
  "eventType": "APPLICATION_FINISH",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000000"]
  "eventTimestampMillis": 1494379614311
}

  5. El candidato vuelve a los resultados de búsqueda (o, si no ha hecho clic en ninguna oferta de empleo, sigue en la página 1) y pasa a la página 2 de los resultados.

    Envía a Cloud Talent Solution un mensaje IMPRESSION con el siguiente conjunto de resultados de la página 2. Nota: Se genera un nuevo requestId 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==.

    {
  "eventId": "ID5",
  "eventType": "IMPRESSION",
  "requestId": "99e5b99c-f1ba-4f85-b17d-ccf878f451f9:APAb7IRESj+/Hzwa3bBd54P3qPx2yOWm5w==",
  "relatedJobNames": ["jobs/4000000005", "jobs/4000000006","jobs/4000000007",
  "jobs/4000000008", "jobs/4000000009"]
  "eventTimestampMillis": 1494379614400
}

  6. El candidato sigue en la página 3 de los resultados de búsqueda.

    Envía un mensaje a Cloud Talent Solution IMPRESSION con el siguiente conjunto de resultados. NOTA: Hay un nuevo requestId (por ejemplo,e2d2b916-78c3-4c65-aecc-d8452bc0afb0:APAb7IRvCsNPiRXYkgF8PN5e8BkbFzKOyg==).

    {
  "eventId": "ID6",
  "eventType": "IMPRESSION",
  "requestId": "e2d2b916-78c3-4c65-aecc-d8452bc0afb0:APAb7IRvCsNPiRXYkgF8PN5e8BkbFzKOyg==",
  "relatedJobNames": ["jobs/4000000010", "jobs/4000000011","jobs/4000000012",
  "jobs/400000013", "jobs/4000000014"]
  "eventTimestampMillis": 1494379614500
}

Flujo de trabajo 2

  1. El candidato realiza una búsqueda. Por ejemplo: Gestor de producto de SF

    Los resultados de búsqueda se devuelven al candidato.

    El objeto de respuesta de búsqueda de empleo contiene un requestId único (por ejemplo, a2179a9b-cf73-413e-8076-98af08b991ad). Usa este requestId en todos los mensajes futuros relacionados con esta llamada a la API SearchJobsRequest.

    Envía un mensaje a Cloud Talent Solution.IMPRESSION

    {
  "eventId": "ID1",
  "eventType": "IMPRESSION",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000000", "jobs/4000000001","jobs/4000000002",
  "jobs/4000000003", "jobs/4000000004"]
, "eventTimestampMillis": 1494379614309
}

  2. La persona que busca empleo selecciona un resultado (una oferta de empleo) para ver todos los detalles del puesto.

    Envía un VIEW mensaje a Cloud Talent Solution.

    {
  "eventId": "ID2",
  "eventType": "VIEW",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000000"]
  "eventTimestampMillis": 1494379614311
}

  3. El candidato hace clic una vez para enviar una solicitud de empleo, tal como se describe en APPLICATION_QUICK_SUBMISSION.

    Envía un mensaje APPLICATION_QUICK_SUBMISSION a Cloud Talent Solution con el siguiente conjunto de resultados.

    {
  "eventId": "ID3",
  "eventType": "APPLICATION_QUICK_SUBMISSION",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000000"]
  "eventTimestampMillis": 1494379614500
}

  4. El candidato realiza las siguientes acciones.

    a. El candidato vuelve a los resultados de búsqueda y solicita un empleo directamente desde la página de resultados de búsqueda. El proceso de solicitud es más largo que el definido en APPLICATION_QUICK_SUBMISSION (es decir, es un proceso de solicitud de varios pasos).

    Envía un mensaje a Cloud Talent Solution.APPLICATION_START_FROM_SERP

    {
  "eventId": "ID4",
  "eventType": "APPLICATION_START_FROM_SERP",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000014"]
  "eventTimestampMillis": 1494379927500
}

    b. El candidato completa la solicitud de empleo. Envía un mensaje a Cloud Talent Solution.APPLICATION_FINISH

    {
  "eventId": "ID5",
  "eventType": "APPLICATION_FINISH",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000014"]
  "eventTimestampMillis": 1494379935500

    }

  5. El candidato vuelve a los resultados de búsqueda y solicita un empleo directamente desde la página de resultados de búsqueda. El proceso de solicitud redirige al candidato a otro dominio que no pertenece al sitio del arrendatario (solicitud externa), por lo que no se puede hacer un seguimiento del progreso del candidato.

    Envía un mensaje a Cloud Talent Solution.APPLICATION_REDIRECT_FROM_SERP

    {
  "eventId": "ID6",
  "eventType": "APPLICATION_START_FROM_SERP",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000017"]
  "eventTimestampMillis": 149438807500
}

    Es diferente de APPLICATION_REDIRECT, donde un candidato se encuentra en la página de descripción del empleo cuando se le redirige.

Mensaje de evento

Campos obligatorios:

  • eventId (definido por el cliente): cada mensaje enviado a Cloud Talent Solution debe tener un eventId único. Te recomendamos que incorpores la marca de tiempo al definir este campo para asegurarte de que no haya duplicados. La longitud máxima de este campo es de 255 caracteres.

  • requestId es el valor de requestId devuelto por el objeto de respuesta de búsqueda de empleo. Este valor es único para una llamada a la API SearchJobsRequest concreta. Se usa en todos los mensajes posteriores derivados del evento de búsqueda original IMPRESSION. Cuando se hace una nueva llamada a la API SearchJobsRequest (por ejemplo, cuando un candidato pasa a la siguiente página de resultados), requestId cambia.

    Se descartará cualquier mensaje de publicación y suscripción que no contenga un requestId.

  • eventType es un tipo de evento, como VIEW o IMPRESSION. Consulta la EventType para ver una lista completa de valores. Los campos mínimos necesarios para habilitar las mejoras del modelo son IMPRESSION, VIEW y APPLICATION_START (o APPLICATION_REDIRECT).

  • relatedJobNames: son los valores del nombre de los puestos de trabajo que se muestran al candidato en el momento del evento. En el caso de un evento IMPRESSION, se trata de una lista de todos los trabajos de la página. En el caso de un evento VIEW, sería el nombre del trabajo visto. Los valores de nombre tienen el formato projects/project-id/jobs/12343213, etc. (consulta las definiciones en Campos de trabajo).

  • eventTimestampMillis Marca de tiempo del evento, medida en milisegundos desde la época. Esta marca de tiempo debe reflejar el momento en el que se produjo el evento, no el momento en el que se envió el mensaje.

Enviar mensaje

El mensaje de evento debe enviarse al servicio Cloud Pub/Sub con un ID de proyecto y un ID de tema específicos. Consulta las instrucciones en Guía de inicio rápido: Ajustar con eventos de clientes de Cloud Talent Solution.