Parâmetros de pesquisa de vagas: práticas recomendadas

Configurações da pesquisa de vagas

Nesta seção, descreve os parâmetros que podem ser usados para configurar a API Job Search. Para mais informações, consulte nosso tutorial em vídeo.

Fatores que afetam os resultados da pesquisa

Juntos, "Vagas em destaque", "Ativar ampliação" e "Desativar correspondência de palavras-chave" têm um impacto significativo no número e na relevância das vagas retornadas ao candidato. A configuração mais apropriada desses três fatores depende das necessidades da sua empresa. O melhor método para determinar a configuração ideal é aplicar diferentes cenários de teste e avaliar os resultados durante uma fase de testes. Veja nossa página de tutoriais em vídeo para mais informações sobre o uso desses parâmetros.

Pesquisa de vagas em destaque: use as pesquisas de vagas em destaque para atribuir valores promocionais a vagas individuais. Isso permite destacar vagas importantes para as necessidades da sua empresa. Consulte a documentação sobre Pesquisa de vagas em destaque para ver as práticas recomendadas e detalhes de implementação.
disableKeywordMatch: este parâmetro permite que a Pesquisa de vagas retorne correspondências com base em palavras-chave da consulta de um candidato, além de correspondências relevantes. A configuração padrão é false. Se o parâmetro for definido como true, a correspondência de palavra-chave será desativada e menos vagas (somente aquelas determinadas como relevantes pelo recurso de ML) serão retornadas.
enableBroadening: use este parâmetro para expandir a consulta do candidato diminuindo as restrições determinadas sobre local e categorias de vaga. A configuração padrão é false. Ativar esse parâmetro aumenta o número de resultados retornados na pesquisa, mas pode diminuir a relevância dos resultados gerais definidos para o candidato.

Resultados da configuração de pesquisa

Para retornar apenas as vagas mais relevantes: defina disableKeywordMatch como true e enableBroadening como false. Isso melhora as métricas de desempenho da API relacionadas à relevância, porque apenas as vagas relevantes são retornadas. No entanto, menos vagas são retornadas nos resultados da pesquisa em geral.

Para retornar um número maior de vagas, incluindo resultados relevantes e que correspondam à palavras-chave: defina disableKeywordMatch como false e enableBroadening como false. Os resultados com correspondência de palavra-chave serão listados após as vagas relevantes nos resultados. Os resultados da expansão de consulta não serão retornados.

Para retornar um número maior de vagas, incluindo vagas relevantes e com expansão de consulta: defina disableKeywordMatch como true e enableBroadening como true. A consulta do candidato será expandida para incluir categorias de vagas relacionadas e locais próximos. As outras vagas serão listadas depois dos resultados relevantes. As correspondências com base em palavras-chave não são retornadas.

Para retornar o maior número possível de vagas: defina disableKeywordMatch como false e enableBroadening como true. A pesquisa de vagas retorna as vagas mais relevantes na parte superior dos resultados da pesquisa, seguidas por vagas com correspondência de palavra-chave e com expansão de consulta (por local, categoria de vaga e assim em diante). Isso aumenta o número total de vagas retornadas.

`diasableKeywordMatch`	`enableBroadening`	Resultado
-	-	Retorna um número maior de vagas, incluindo resultados relevantes e que correspondam a palavras-chave (mas suponha que a pesquisa de vagas em destaque esteja definida como `false`).
+	+	Retorna um número maior de vagas, incluindo vagas expandidas relevantes e de consulta (mas suponha que a pesquisa de vagas em destaque esteja definida como `false`).
-	+	Retorna o número mais alto de vagas (mas suponha que a pesquisa de vagas em destaque esteja definida como `false`).
+	-	Retorna apenas as vagas mais relevantes (mas suponha que a pesquisa de vagas em destaque esteja definida como `false`).

`Request.pageSize`

Para ter um melhor desempenho e evitar latência, configure a página de resultados para exibir 20 ou menos vagas por vez. Consulte a página visão geral de pesquisa para mais informações sobre como implementar a paginação.

`customAttributes`

customAttributes oferece a flexibilidade de atribuir outros valores às vagas de acordo com as necessidades da sua empresa (por exemplo, pontuações de GPA) e usar esses valores para filtrar os resultados.

Campo "Local"

Veja uma visão geral detalhada do campo location na página Campos "Local". Fornecer o endereço da vaga em vez de coordenadas GPS no campo address ajuda a pesquisa de vagas a melhorar a detecção da localização e a relevância da pesquisa.

`locationFilter`

Use o campo regionCode se uma única empresa tiver várias vagas em diferentes regiões geográficas. A atribuição de um regionCode a cada listagem garante que uma consulta de pesquisa retorne vagas apenas no local desejado do candidato em vez dos resultados que correspondem à consulta de pesquisa. Por exemplo, uma pesquisa pela palavra-chave de local "Cambridge" sem um regionCode retorna resultados de Cambridge, Reino Unido e Cambridge, MA, EUA. Isso diminui a relevância da pesquisa.

Se, por exemplo, uma listagem da empresa estiver no nível da cidade e da rua e outra no nível do estado, nenhuma aparecerá em pesquisas localizadas que correspondam às duas listagens.

`regionCode` e `languageCode`

Esses dois campos permitem que a pesquisa de vagas use a lógica de pesquisa localizada em diferentes regiões geográficas (por exemplo, "lorry driver" em en_GB em vez de "truck driver" nos Estados Unidos). Defina request.filters.locationFilters.regionCode para corresponder à localização geográfica que o usuário está pesquisando (como o Reino Unido) e request.filters.languageCode para o código de idioma apropriado para essa região (en_GB nesse caso).

`queryLanguageCode`

Recomendamos que você preencha esse campo sempre que possível. Com esse parâmetro, a Pesquisa de vagas lida com palavras inesperadas ou raras que não aparecem corretamente no idioma desejado, como nomes de empresas.

`distanceInMiles`

Esse parâmetro define um raio (em milhas) em torno do local indicado pelo candidato. A pesquisa de vagas retorna resultados dentro dessa área geográfica. A maneira como essa distância é aplicada à geografia dos resultados da pesquisa depende do tipo de informações de local inseridas. Se o candidato inserir um endereço ou CEP, a distância de distanceinMiles será definida a partir de um único ponto. Se ele inserir uma cidade, a pesquisa de vagas aplicará uma caixa delimitadora nos limites da cidade e calculará a distância a partir das bordas da caixa. Se o usuário inserir apenas um estado ou país, distanceInMiles será ignorado.

Procure definir o menor raio de milhagem possível. Caso contrário, a pesquisa de vagas retornará resultados que podem estar fora do local desejado do candidato, o que diminui a relevância. Por exemplo, uma pesquisa por vagas na cidade de Nova York com distanceInMiles definido como 100 milhas retornará resultados em Nova Jersey e região norte do estado de Nova York. Mantenha o raio o menor possível para aumentar a relevância dos resultados.

`postingExpireTime`

Este parâmetro define o tempo que a postagem da vaga permanece ativa antes de ser removida dos resultados da pesquisa. Por padrão, o CTS remove as vagas 30 dias após a hora de criação (hora UTC).

`employmentTypes`

Este não é um campo obrigatório. No entanto, o uso de employmentTypes aumenta a relevância dos resultados da pesquisa.

Configurações da pesquisa de vagas: classificação personalizada

Pesquisa de vagas em destaque permite influenciar os resultados de pesquisa de um usuário, destacando vagas com base em uma única variável (promotionValue). Consulte a documentação da pesquisa de vagas em destaque para saber detalhes. Classificação personalizada permite influenciar os resultados da pesquisa com base em diversas variáveis, oferecendo um controle mais granular sobre as classificações. Esse recurso é útil em aplicativos que requerem o equilíbrio entre relevância e interesses econômicos, como um sistema de assinantes de custo por clique (CPC) com vários níveis. Além da pontuação de relevância original, a classificação das vagas é baseada em duas variáveis: rankingExpression e importanceLevel. Veja nosso tutorial em vídeo para mais informações sobre o uso de vagas em destaque e classificação personalizada.

rankingExpression: esta variável controla como as vagas são classificadas com base nas pontuações de relevância calculadas. 'rankingExpression' precisa ser definido como 'filterable' para que a pesquisa de vagas indexe o parâmetro.
importanceLevel: este parâmetro define o nível de importância da posição de classificação de uma vaga quando ela é retornada nos resultados das pesquisas. Há seis níveis possíveis: não especificado, NONE, LOW, MID, HIGH e EXTREME. Definir o valor como EXTREME faz com que todos os outros fatores relevantes gerados pela API serão ignorados. Portanto, use esse valor com moderação. As vagas definidas como EXTREME são retornadas na parte superior da consulta do candidato em vez das vagas mais relevantes.
Pesquisa de vagas em destaque versus classificação personalizada: uma pesquisa de vagas em destaque é mais útil para promover uma única categoria de vagas acima da classificação de relevância, como vagas em uma determinada empresa. Se você precisar classificar as vagas de acordo com as variáveis de CPC (custo por clique) de vários níveis e com a classificação de relevância, a classificação personalizada será a melhor opção.

Pesquisa por deslocamento diário

Pesquisa por deslocamento permite que os candidatos procurem vagas com base no tempo de deslocamento. Para habilitá-lo, inclua um objeto CommuteFilter no campo JobQuery.commuteFilter. CommuteFilter calcula o tempo de deslocamento usando o método de deslocamento indicado, a duração da viagem e as coordenadas de partida de um candidato. Os candidatos também precisam selecionar roadTraffic (TRAFFIC_FREE ou BUSY_HOUR) ou departureTime para incluir no cálculo do tempo. Para mais detalhes, consulte as páginas de implementação e do guia de instruções da pesquisa por deslocamento.

Os resultados da pesquisa de deslocamento são baseados em dados históricos e agregados, e não em condições de trânsito ao vivo. As condições de trânsito departureTime são calculadas das médias das condições de trânsito na hora do dia especificada. As opções BUSY_HOUR/TRAFFIC_FREE em roadTraffic são condições médias de trânsito no horário de pico matinal e à meia-noite, respectivamente. Os usuários recebem os mesmos resultados de pesquisa de deslocamento, independentemente do horário em que enviam uma consulta.

Multilocação (opcional)

A Pesquisa de vagas é compatível com locatários como uma camada organizacional intermediária entre um projeto do Google Cloud e todos os dados enviados a ele. Os locatários impedem que os dados sejam compartilhados através das barreiras de locação, permitindo que você isole subconjuntos de dados sem precisar vários projetos. A multilocação é útil em situações em que você tem vários clientes e não quer compartilhar dados entre eles, mas quer manter um único projeto do Google Cloud para faturamento e relatórios internos. Exemplo:

Provedores de sites de vagas que montam sites para organizações com várias subsidiárias.
Agências de recrutamento que criam sistemas de rastreamento de candidatos para várias empresas.

Cada projeto recebe um único ID de locatário padrão. É possível implementar a multilocação criando mais de um locatário em um determinado projeto.

Os locatários são totalmente isolados um do outro. Todas as APIs solicitam apenas um único locatário, impedindo que os dados sejam consultados em vários locatários na mesma chamada de API. Os algoritmos de machine learning também tratam os locatários como unidades isoladas e não ultrapassam barreiras de locação. Um projeto pode ter quantos locatários forem necessários.

Segurança

O CTS oferece suporte muito leve para os locatários. Você é responsável por criar locatários, atribuir IDs de locatário e fornecer o ID de locatário correto ao fazer uma solicitação. O CTS verifica se o ID de locatário é de propriedade de um determinado projeto e recupera dados do locatário fornecido. Qualquer segurança extra para conseguir acesso não autorizado precisa ser gerenciada em seu sistema de back-end.

Gerenciamento de dados e tratamento de erros

Integridade dos dados

Upload de vagas: problemas de dados podem impedir o upload de vagas para a pesquisa de vagas. Consulte a página Códigos de resposta HTTP para ver uma lista dos códigos de erro. São exemplos comuns:
- Os locais da vaga estão incorretos, portanto, a solicitação não pode ser resolvida.
- Os campos "Empresa" ou "Vaga" não existem, então é retornada uma solicitação incorreta.
Há três opções principais para solucionar problemas de upload de vagas:
- Verifique a geração de registros do back-end.
- Verifique a ferramenta de gestão do CTS para geração de registros de dados.
- Configure a ferramenta Stackdriver Monitoring no Console do Cloud para coletar dados sobre métricas, eventos e metadados.
Indexação de vagas: a pesquisa de vagas foi feita para indexar todas as vagas com upload dentro de um período definido. No entanto, é possível que você tenha restrições de cota. Verifique seu sistema quanto a restrições nas solicitações de indexação antes de enviar vagas para o CTS.

Ataques DDoS autoinfligidos

Tratamento de erros

Os serviços de API fornecidos pela Internet podem ter falha de conexão intermitente, interrupção prolongada, manutenção de serviço repentina e outros eventos que exigem que um aplicativo cliente tente executar novamente a solicitação de API. Certifique-se de projetar a tentativa com um comportamento amigável para a rede, por exemplo, com a retirada exponencial.

Limites de cota

Evite enviar mais tráfego do que sua cota provisionada, especialmente se ele estiver muito acima da cota provisionada. Caso contrário, o tráfego pode ser classificado como malicioso e, portanto, bloqueado.

Deduplicação

As vagas duplicadas afetam negativamente a experiência de pesquisa de um candidato. A pesquisa de vagas inclui dois recursos para minimizar duplicatas:

Criar vagas: se você tentar criar mais de duas vagas com os critérios a seguir, o registro será rejeitado e um erro 4xx será retornado:
- mesmo companyName, E
- mesmo job_req_id, E
- mesmo local/languageCode
Pesquisa de vagas: a pesquisa de vagas mostra as vagas relevantes para a consulta de pesquisa do candidato. Um recurso integrado do algoritmo de relevância garante que todas as vagas retornadas sejam diversificadas, evitando que vagas quase idênticas apareçam lado a lado nos resultados da pesquisa.