Ferramentas de gerenciamento da Cloud Talent Solution

Painel do Cloud Talent Solution

O painel do Cloud Talent Solution fornece dados visuais para você ter mais insight sobre:

  1. como seus candidatos a emprego estão se engajando na pesquisa de vagas, mostrando as principais consultas e locais por domínio;
  2. se sua pesquisa de vagas está configurada corretamente, mostrando inconsistências em sua integração;
  3. se os eventos do seu cliente estão configurados corretamente. O painel pode mostrar eventos do cliente que você precisa corrigir ou melhorar.

Para mais informações, consulte a documentação do painel.

Transmissão ao vivo do evento do cliente

Verifique se o Google recebeu as mensagens de evento que você enviou e confirme se o formato delas está correto. No Console do GCP, acesse a ferramenta de transmissão ao vivo do evento do cliente. As mensagens de evento mais recentes (até 50) são listadas. Visualize detalhes do evento selecionando qualquer um dos eventos listados. Verifique todos os eventos com o mesmo requestId clicando no botão "TODOS OS EVENTOS COM O ID DA SOLICITAÇÃO" no cabeçalho. Serão exibidos avisos na visualização detalhada nos casos em que a mensagem clientEvent foi enviada com formatos incorretos. Use as opções de filtragem para filtrar as mensagens por requestId, userId ou sessionId.

Se a mensagem não aparecer na transmissão ao vivo do evento do cliente, verifique se o requestId na mensagem do evento é válido. Mensagens de evento sem um requestId válido são descartadas pelo Cloud Talent Solution.

Consulte Como solucionar erros de validação ClientEvent para mais informações sobre mensagens de erro de evento único.

Procure todas as mensagens de evento que tenham um requestId específico. Assim como na transmissão ao vivo do evento do cliente, verifique se o Google recebeu as mensagens de evento e se elas estão bem formatadas para um determinado requestId. Use também o painel de filtro à direita para filtrar, por exemplo, mensagens bem formatadas.

Consulte Como solucionar erros de validação ClientEvent para mais informações sobre mensagens de erro de eventos agregados.

Dados de empregos e empresas

Use Empregos e empresas para:

  • Confira um resumo das vagas e empresas, dividido por tipo e categoria.

  • Pesquise detalhes de jobs específicos por nome ou ID de requisição.

  • Exportar dados de jobs, empresas ou locatários para um BigQuery no conjunto de dados.

Se você ainda não tiver configurado o console, use as instruções em Antes de começar para ter acesso.

Ver e pesquisar dados de vagas

A guia Resumo na página Vagas e empresas mostra informações agregadas sobre a contagem de vagas e empresas.

  • A tabela Último snapshot de contagem resume as contagens de jobs abertos e excluídos, além das empresas ativas do dia anterior. Esse snapshot é atualizado uma vez por dia.
  • O gráfico Contagem ao longo do tempo visualiza as contagens de jobs e empresas em um período que você selecionar. Use os filtros suspensos para selecionar tipos, locatários e duração para exibição.

A guia Metadados de vagas apresenta uma ferramenta de pesquisa para detalhes específicos da vaga. Você pode pesquisar até 10 nomes de jobs ou IDs de requisição de jobs para acessar uma tabela com os metadados disponíveis para esses jobs. Se nenhum resultado for encontrado para uma tarefa específica (por exemplo, nome ou ID inserido incorretamente), o exibe um resultado NOT_FOUND na linha da tabela referente ao nome ou ID desse job.

Exportar dados para o BigQuery

É possível exportar dados para o BigQuery por job, empresa ou locatário para mais solução de problemas.

Conceder permissões do BigQuery ao CTS conta de serviço:

  1. Na página IAM do console do Google Cloud, adicione um novo principal que atribua a função Usuário de job do BigQuery a gjobs-bq-prod@system.gserviceaccount.com.

    Consulte Conceder um único papel para saber mais sobre a concessão de papéis no BigQuery.

  2. No BigQuery, criar um conjunto de dados do BigQuery com um nome exclusivo.

    Você usará esse conjunto de dados para dados do CTS exportados.

  3. No painel Explorer, encontre o conjunto de dados que você irá exportar os dados do CTS para onde Clique em Compartilhar e permita o acesso ao gjobs-bq-prod@system.gserviceaccount.com Editor de dados do BigQuery.

    Consulte Como conceder acesso a um conjunto de dados na documentação do BigQuery para mais informações.

Para exportar seus dados do CTS:

  1. No console do CTS, acesse a guia Exports da página Jobs and companies.

  2. Em Gerar BigQuery Export, selecione se quer exportar o job, a empresa ou dados de locatários.

  3. Selecione uma tabela do BigQuery para exportar os dados.

  4. Clique em Gerar para exportar os dados.

    A guia Exportação de dados mostra o job de exportação em andamento e um link para o conjunto de dados exportado no BigQuery quando os dados são gerados.

Gerenciamento da conta de serviço

Você precisa vincular uma conta de serviço ao Cloud Talent Solution para usar as credenciais associadas a essa conta e fazer uma solicitação de API. Use a ferramenta de conexões de contas de serviço para gerenciar suas contas de serviço. Todas as contas de serviço associadas ao projeto do Google Cloud estão listadas. Clique em "Conectar" para associar uma conta de serviço ao Cloud Talent Solution. Saiba mais sobre contas de serviço em Como criar e gerenciar contas de serviço.

Como solucionar erros de validação ClientEvent

Validações baseadas em um único evento

Constante String de IU
RELATED_JOB_ID_INVALID A mensagem ClientEvent tem um ou mais relatedJobNames inválidos ou incorretos.
EVENT_ID_REUSED Um eventId precisa ser exclusivo para um projeto do Google Cloud. Neste caso, a mensagem tem um eventId gerado anteriormente pelo seu projeto do Google Cloud. A prática recomendada é incluir algum tipo de carimbo de data/hora em cada eventId, para garantir exclusividade.
MISSING_REQUIRED_FIELDS Campo(s) obrigatório(s) não encontrado(s). Verifique o esquema ClientEvent para identificar os campos obrigatórios não informados.
INVALID_FIELDS Um ou mais campos da mensagem estavam incompletos ou não eram esperados pela Cloud Talent Solution. Consulte o esquema ClientEvent para mais informações sobre os campos obrigatórios e os valores esperados neles.
UNKNOWN_FIELDS Campo(s) desconhecido(s) recebido(s)
INVALID_FORMAT String JSON inválida recebida na mensagem ClientEvent do Cloud Talent Solution. Por exemplo, uma chave não encontrada.

Validações agregadas por requestId

Constante Descrição
NO_SEARCH_IMPRESSION Nenhum evento IMPRESSION.
VIEWS_FEWER_THAN_APPLY_STARTS O número de eventos VIEW é menor que o número de eventos APPLICATION_START. Isso pode acontecer porque os eventos VIEW não estão sendo enviados corretamente ao Cloud Talent Solution ou o botão de inscrição na IU está sendo acionado sem realmente acionar uma visualização. Se esse for o comportamento pretendido (por exemplo, se a página de resultados da pesquisa tiver um botão de inscrição em que os candidatos possam clicar sem visualizar os detalhes da vaga), use um evento APPLICATION_START_FROM_SERP.
VIEWS_FEWER_THAN_APPLY_REDIRECTS O número de eventos VIEW é menor que o número de eventos APPLICATION_REDIRECT. Isso pode acontecer porque os eventos VIEW não estão sendo enviados corretamente para o Cloud Talent Solution ou o botão "Aplicar" na IU está sendo acionado sem realmente acionar uma visualização. Se esse for o comportamento pretendido (por exemplo, se a página de resultados da pesquisa tiver um botão de inscrição em que os candidatos possam clicar sem visualizar os detalhes da vaga), use um evento APPLICATION_REDIRECT_FROM_SERP.
APPLY_STARTS_FEWER_THAN_APPLY_FINISHES A causa disso possivelmente é um erro de configuração, em que a mensagem APPLICATION_START não está sendo enviada em todas as instâncias ou a mensagem APPLICATION_FINISH está sendo enviada em instâncias quando não deveria ser. O ideal é que o número de mensagens APPLICATION_START seja maior ou igual ao número de mensagens APPLICATION_FINISH.