Esta página foi traduzida pela API Cloud Translation.

Melhore o modelo pré-preparado com dados de eventos do cliente (v3)

A Cloud Talent Solution é um serviço que aplica a aprendizagem automática à sua experiência de pesquisa de emprego, devolvendo resultados de alta qualidade aos candidatos a emprego muito além das limitações dos métodos típicos baseados em palavras-chave. O CTS aplica imediatamente modelos de relevância e ontologias de empregos/competências aos detalhes dos seus empregos. Pode melhorar os resultados devolvidos aos candidatos a emprego registando eventos de cliente com base na atividade do candidato a emprego.

Existem dois métodos para tirar partido desta funcionalidade, ambos descritos neste guia. Recomendamos que use o createClientEventRequest método da API, que ignora os desafios de autenticação do envio de mensagens para a Cloud Talent Solution através do Cloud Pub/Sub e fornece um conjunto simples de APIs para implementar a estrutura de estatísticas.

Registe eventos de cliente através de `createClientEventRequest` (recomendado)

Quando um candidato realiza uma ação específica, pode usar a API para registar essa ação. Por exemplo, o candidato a emprego ou outra entidade que interaja com o serviço teve um emprego (ou uma lista de empregos) apresentado na sua vista, como numa lista de resultados da pesquisa num formato comprimido ou recortado. Neste caso, pode enviar um evento IMPRESSION para o Cloud Talent Solution para fornecer o contexto dos resultados da pesquisa e o que um candidato pode ver. Além disso, quando o candidato clica num resultado de emprego para ver a descrição completa do emprego, pode enviar um evento VIEW para registar o interesse deste candidato nesta posição.

Registe eventos de cliente através do Cloud Pub/Sub

Para tirar partido deste método, envie mensagens estruturadas para a Cloud Talent Solution que capturem as reações dos candidatos a emprego aos resultados com base nas respetivas consultas. Estas mensagens são enviadas para a Cloud Talent Solution através do Cloud Pub/Sub. A partir daí, a Cloud Talent Solution analisa as mensagens do site do inquilino e envia-as para o modelo de aprendizagem automática.

O formato das mensagens e os pedidos do Pub/Sub são descritos abaixo.

Vários cenários e fluxo de trabalho

Seguem-se dois exemplos que mostram vários cenários de um candidato a emprego que pesquisa, vê e candidata-se a um emprego.

Tenha em atenção que deve publicar APENAS no projeto p-jobs e no tópico cloud-jobs-events.

Fluxo de trabalho 1

A pessoa à procura de emprego faz uma pesquisa. Por exemplo: Product mgr SF

Os resultados da pesquisa são devolvidos à pessoa à procura de emprego.

O objeto de resposta de pesquisa de emprego enviado de volta para o servidor do cliente contém um requestId único (por exemplo: 8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==). Use este requestId para todas as mensagens futuras relacionadas com esta chamada da API SearchJobsRequest específica.

Enviar uma mensagem IMPRESSION à Cloud Talent Solution.

Mensagem de evento de exemplo:
```
{
  "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
}
```

O candidato seleciona um resultado (uma oferta de emprego) para ver os detalhes completos do emprego.

Enviar uma mensagem VIEW para a Cloud Talent Solution.

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

A pessoa à procura de emprego candidata-se à oferta de emprego visualizada.

a. Se o candidato for redirecionado para uma página no mesmo domínio (uma página de candidatura interna), envie uma mensagem APPLICATION_START à Cloud Talent Solution.

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

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

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

Quando o candidato conclui uma candidatura interna, envie uma mensagem APPLICATION_FINISH para a Cloud Talent Solution:

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

O candidato volta aos resultados da pesquisa ou, se nunca clicou numa oferta de emprego, continua para a página 2 dos resultados.

Envie uma mensagem IMPRESSION à Cloud Talent Solution com o conjunto seguinte de resultados da página 2. Nota: existe 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==).
```
{
  "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
}
```

O candidato continua para a página 3 dos resultados da pesquisa.

Enviar uma mensagem IMPRESSION à Cloud Talent Solution com o conjunto seguinte de resultados. NOTA: existe um novo requestId (por exemplo,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
}

Fluxo de trabalho 2

A pessoa à procura de emprego faz uma pesquisa. Por exemplo: Product mgr SF

Os resultados da pesquisa são devolvidos à pessoa à procura de emprego.

O objeto de resposta de pesquisa de emprego contém um requestId exclusivo (por exemplo: a2179a9b-cf73-413e-8076-98af08b991ad). Use este requestId para todas as mensagens futuras relacionadas com esta chamada API SearchJobsRequest.

Enviar uma mensagem IMPRESSION para a Cloud Talent Solution.
```
{
  "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
}
```

O candidato seleciona um resultado (uma oferta de emprego) para ver os detalhes completos do emprego.

Enviar uma mensagem VIEW para a Cloud Talent Solution.

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

O candidato a emprego realiza uma candidatura com um único clique a um emprego, conforme descrito em APPLICATION_QUICK_SUBMISSION.

Enviar uma mensagem APPLICATION_QUICK_SUBMISSION à Cloud Talent Solution com o conjunto seguinte de resultados.

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

O candidato realiza as seguintes ações.

a. O candidato a emprego volta aos resultados da pesquisa e candidata-se a um emprego diretamente a partir da página de resultados da pesquisa. O processo de candidatura é mais longo do que o definido em APPLICATION_QUICK_SUBMISSION (ou seja, é um processo de candidatura de vários passos).

Enviar uma mensagem APPLICATION_START_FROM_SERP para a Cloud Talent Solution.
```
{
  "eventId": "ID4",
  "eventType": "APPLICATION_START_FROM_SERP",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000014"]
  "eventTimestampMillis": 1494379927500
}
```
b. O candidato a emprego conclui a candidatura ao emprego. Enviar uma mensagem APPLICATION_FINISH para a Cloud Talent Solution.
```
{
  "eventId": "ID5",
  "eventType": "APPLICATION_FINISH",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000014"]
  "eventTimestampMillis": 1494379935500
```
}
O candidato a emprego volta aos resultados da pesquisa e candidata-se a um emprego diretamente a partir da página de resultados da pesquisa. O processo de candidatura redireciona o candidato para outro domínio que está fora do site do inquilino (candidatura externa) a partir do qual não é possível acompanhar o progresso do candidato.

Enviar uma mensagem APPLICATION_REDIRECT_FROM_SERP para a Cloud Talent Solution.
```
{
  "eventId": "ID6",
  "eventType": "APPLICATION_START_FROM_SERP",
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "relatedJobNames": ["jobs/4000000017"]
  "eventTimestampMillis": 149438807500
}
```
Isto é diferente de APPLICATION_REDIRECT, em que um candidato está na página de descrição do emprego quando é redirecionado.

Mensagem de evento

Campos obrigatórios:

eventId (Definido pelo cliente): cada mensagem enviada para a Cloud Talent Solution tem de ter um eventId único. Como prática recomendada, incorpore a data/hora ao definir este campo para garantir que não existem duplicados. O comprimento máximo deste campo é de 255 carateres.
requestId é o valor de requestId devolvido pelo objeto de resposta de pesquisa de emprego. Este valor é exclusivo de uma chamada API SearchJobsRequest específica. É usado para todas as mensagens subsequentes provenientes do evento de pesquisa original.IMPRESSION Quando é feita uma nova chamada API SearchJobsRequest (por exemplo, o candidato vai para a página seguinte de resultados), o requestId muda.

Todas as mensagens pubsub que não contenham um requestId são ignoradas.
eventType é um tipo de evento, como VIEW ou IMPRESSION. (consulte a EventType referência para uma lista completa de valores). Os campos mínimos necessários para ativar as melhorias do modelo são IMPRESSION, VIEW e APPLICATION_START (e/ou APPLICATION_REDIRECT).
relatedJobNames: estes são os valores do nome do trabalho para todos os trabalhos apresentados ao candidato no momento do evento. Para um evento IMPRESSION, esta é uma lista de todos os trabalhos na página; para um evento VIEW, seria o nome do trabalho visto. Os valores dos nomes estão no formato projects/project-id/jobs/12343213, etc. (consulte Campos de tarefas para ver as definições)
eventTimestampMillis A data/hora do evento, medida em milissegundos desde a época. Esta data/hora deve refletir o momento em que o evento ocorreu efetivamente e não o momento em que a mensagem foi enviada.

Enviar mensagem

A mensagem de evento tem de ser enviada para o serviço Cloud Pub/Sub com um ID do projeto e um ID do tópico específicos. Consulte o artigo Início rápido: ajuste com eventos de cliente do Cloud Talent Solution para receber instruções.

Melhore o modelo pré-preparado com dados de eventos do cliente (v3) Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Registe eventos de cliente através de createClientEventRequest (recomendado)

Registe eventos de cliente através do Cloud Pub/Sub

Vários cenários e fluxo de trabalho

Fluxo de trabalho 1

Fluxo de trabalho 2

Mensagem de evento

Enviar mensagem

Melhore o modelo pré-preparado com dados de eventos do cliente (v3)

Registe eventos de cliente através de `createClientEventRequest` (recomendado)