Ferramentas de gerenciamento da Cloud Talent Solution

Painel do Cloud Talent Solution

O painel do Cloud Talent Solution fornece dados visuais para fornecer mais informações 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 a página Vagas e empresas para:

  • Visualizar um resumo das contagens de vagas e empresas, divididas por tipo e categoria.

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

  • Exporte dados de jobs, empresas ou locatários para um conjunto de dados do BigQuery.

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

Ver e pesquisar dados de vagas

A guia Resumo da página Vagas e empresas mostra informações agregadas sobre contagens de vagas e empresas.

  • A tabela Snapshot de contagens mais recente resume as contagens de vagas abertas e excluídas e as contagens de empresas ativas do dia anterior. Esse snapshot é atualizado uma vez por dia.
  • O gráfico Contagens ao longo do tempo exibe as contagens de vagas e empresas em um período selecionado. Use os filtros do menu suspenso para selecionar tipos, locatários e duração a serem exibidas.

A guia Metadados de vagas tem uma ferramenta de pesquisa para detalhes específicos da vaga. É possível pesquisar até 10 nomes de vagas ou códigos de requisição de vagas para acessar uma tabela com metadados disponíveis para essas vagas. Se nenhum resultado for encontrado para um job específico (por exemplo, se o nome ou ID estiver incorreto), a tabela exibirá um resultado NOT_FOUND na linha da tabela para esse nome ou ID de job.

Exportar dados para o BigQuery

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

Para conceder permissões do BigQuery à conta de serviço do CTS:

  1. Na página IAM do console do Google Cloud, adicione um novo principal atribuindo o papel Usuário de jobs do BigQuery a gjobs-bq-prod@system.gserviceaccount.com.

    Consulte Conceder um único papel para mais informações sobre como fazer isso no BigQuery.

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

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

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

    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 Exportações da página Jobs e empresas.

  2. Em Gerar BigQuery Export, selecione se você quer exportar dados de jobs, empresas ou locatários.

  3. Selecione uma tabela do BigQuery para onde os dados serão exportados.

  4. Clique em Gerar para exportar os dados.

    A guia Exportação de dados exibe 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.