Migliorare il modello preaddestrato con i dati degli eventi client (v3)

Cloud Talent Solution è un servizio che integra il machine learning nella tua esperienza di ricerca di lavoro, offrendo ai candidati risultati di alta qualità che superano i limiti dei metodi tradizionali basati su parole chiave. CTS applica immediatamente modelli di pertinenza e ontologie di competenze/lavoro ai dettagli del lavoro. Puoi migliorare i risultati restituiti a chi cerca lavoro registrando gli eventi client in base all'attività di chi cerca lavoro.

Esistono due metodi per sfruttare questa funzionalità, entrambi descritti in questa guida. Ti consigliamo di utilizzare il metodo API createClientEventRequest, che aggira le sfide di autenticazione dell'invio di messaggi a Cloud Talent Solution utilizzando Cloud Pub/Sub e fornisce un insieme pulito di API per implementare il framework di analisi.

Registra gli eventi client utilizzando createClientEventRequest (opzione consigliata)

Quando un candidato esegue un'azione specifica, puoi utilizzare l'API per registrarla. Ad esempio, il candidato o un'altra entità che interagisce con il servizio ha visualizzato un'offerta di lavoro (o un elenco di offerte di lavoro) nella sua visualizzazione, ad esempio in un elenco di risultati di ricerca in un formato compresso o troncato. In questo caso, puoi inviare un evento IMPRESSION a Cloud Talent Solution per fornire il contesto dei risultati di ricerca e ciò che un candidato può vedere. Inoltre, quando il candidato fa clic su un risultato di lavoro per visualizzare la descrizione completa del lavoro, puoi inviare un evento VIEW per registrare l'interesse di questo candidato per questa posizione.

Registrare gli eventi client utilizzando Cloud Pub/Sub

Per utilizzare questo metodo, invia a Cloud Talent Solution messaggi strutturati che acquisiscano le reazioni del candidato ai risultati in base alle sue query. Questi messaggi vengono inviati a Cloud Talent Solution utilizzando Cloud Pub/Sub. A questo punto, Cloud Talent Solution analizza i messaggi del sito del tenant e li invia al modello di machine learning.

Il formato del messaggio e le richieste Pub/Sub sono descritti di seguito.

Vari scenari e workflow

Di seguito sono riportati due esempi che mostrano vari scenari di ricerca, visualizzazione e candidatura a un'offerta di lavoro da parte di un candidato.

Tieni presente che devi pubblicare SOLO nel progetto p-jobs e nell'argomento cloud-jobs-events.

Flusso di lavoro 1

1. Il candidato esegue una ricerca. Ad esempio: Product mgr SF

   I risultati di ricerca vengono restituiti al candidato.

   L'oggetto risposta della ricerca di lavoro inviato al server del cliente contiene un requestId univoco (ad esempio: 8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==). Utilizza questo requestId per tutti i messaggi futuri relativi a questa particolare chiamata API SearchJobsRequest.

   Invia a Cloud Talent Solution un messaggio IMPRESSION.

   Messaggio di evento di esempio:

   {
     "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 in cerca di lavoro seleziona un risultato (un'offerta di lavoro) per visualizzare i dettagli completi del lavoro.

   Invia un messaggio a Cloud Talent Solution.VIEW

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

   Nota :un evento VIEW segue un evento IMPRESSION.

3. Il candidato fa domanda per l'offerta di lavoro visualizzata.

   a. Se il candidato viene reindirizzato a una pagina all'interno dello stesso dominio (una pagina di candidatura interna), invia a Cloud Talent Solution un messaggio APPLICATION_START.

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

   b. Se il candidato viene reindirizzato a una pagina di candidatura esterna, invia a Cloud Talent Solution un messaggio APPLICATION_REDIRECT.

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

4. Quando il candidato completa una candidatura interna, invia a Cloud Talent Solution un messaggio APPLICATION_FINISH:

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

5. Il candidato torna ai risultati di ricerca o, se non ha mai fatto clic su un'offerta di lavoro, continua alla pagina 2 dei risultati.

   Invia a Cloud Talent Solution un messaggio IMPRESSION con il successivo insieme di risultati dalla pagina 2. Nota: nella risposta della chiamata API SearchJobsRequest che genera la seconda pagina di risultati viene generato un nuovo requestId. ad esempio,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. Il candidato continua fino alla pagina 3 dei risultati di ricerca.

   Invia a Cloud Talent Solution un messaggio IMPRESSION con il successivo insieme di risultati. NOTA: è disponibile un nuovo requestId (ad esempio,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
   }
   

Workflow 2

1. Il candidato esegue una ricerca. Ad esempio: Product mgr SF

   I risultati di ricerca vengono restituiti al candidato.

   L'oggetto risposta della ricerca di lavoro contiene un requestId univoco (ad esempio: a2179a9b-cf73-413e-8076-98af08b991ad). Utilizza questo requestId per tutti i messaggi futuri relativi a questa chiamata API SearchJobsRequest.

   Invia un messaggio 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 in cerca di lavoro seleziona un risultato (un'offerta di lavoro) per visualizzare i dettagli completi del lavoro.

   Invia un messaggio a Cloud Talent Solution.VIEW

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

   Nota :un evento VIEW segue un evento IMPRESSION.

3. Il candidato esegue una candidatura con un solo clic per un lavoro, come descritto in APPLICATION_QUICK_SUBMISSION.

   Invia a Cloud Talent Solution un messaggio APPLICATION_QUICK_SUBMISSION con il prossimo insieme di risultati.

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

4. Il candidato esegue le seguenti azioni.

   a. Il candidato torna ai risultati di ricerca e fa domanda per un lavoro direttamente dalla pagina dei risultati di ricerca. La procedura di richiesta è più lunga di quella definita in APPLICATION_QUICK_SUBMISSION (ovvero è una procedura di richiesta in più passaggi).

   Invia un messaggio 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. Il candidato completa la domanda di lavoro. Invia un messaggio 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. Il candidato torna ai risultati di ricerca e fa domanda per un lavoro direttamente dalla pagina dei risultati di ricerca. La procedura di candidatura reindirizza il candidato a un altro dominio esterno al sito del tenant (candidatura esterna) da cui non è possibile monitorare l'avanzamento della candidatura.

   Invia un messaggio 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
   }
   

   Questo è diverso da APPLICATION_REDIRECT, dove chi cerca lavoro si trova nella pagina della descrizione dell'offerta di lavoro quando viene reindirizzato.

Messaggio di evento

Campi obbligatori:

• eventId (definito dal cliente): ogni messaggio inviato a Cloud Talent Solution deve avere un eventId univoco. Come best practice, incorpora il timestamp durante la definizione di questo campo per garantire la non duplicità. La lunghezza massima di questo campo è di 255 caratteri.

• requestId è il valore di requestId restituito dall'oggetto di risposta alla ricerca di lavoro. Questo valore è univoco per una determinata chiamata API SearchJobsRequest. Viene utilizzato per tutti i messaggi successivi derivanti dall'evento di ricerca IMPRESSION originale. Quando viene effettuata una nuova chiamata API SearchJobsRequest (ad esempio, un candidato va alla pagina successiva dei risultati), il valore di requestId cambia.

  Qualsiasi messaggio pub/sub che non contiene un requestId viene eliminato.

• eventType è un tipo di evento, ad esempio VIEW o IMPRESSION. (vedi EventType per un elenco completo dei valori). I campi minimi richiesti per attivare i miglioramenti del modello sono IMPRESSION, VIEW e APPLICATION_START (e/o APPLICATION_REDIRECT).

• relatedJobNames: Questi sono i valori del nome del lavoro per tutti i lavori visualizzati dal candidato al momento dell'evento. Per un evento IMPRESSION, si tratta di un elenco di tutti i job nella pagina; per un evento VIEW, si tratta del nome del job visualizzato. I valori dei nomi sono nel formato projects/project-id/jobs/12343213 e così via. (vedi Campi del job per le definizioni)

• eventTimestampMillis Il timestamp dell'evento, misurato in millisecondi dall'epoca. Questo timestamp deve riflettere il momento in cui si è verificato l'evento, non il momento in cui è stato inviato il messaggio.

Invia messaggio

Il messaggio evento deve essere inviato al servizio Cloud Pub/Sub utilizzando un ID progetto e un ID argomento specifici. Per istruzioni, consulta Guida rapida: esegui la sintonizzazione con gli eventi client di Cloud Talent Solution.