Parâmetros de pesquisa de empregos: práticas recomendadas (v4beta1)

Configurações da pesquisa de empregos

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

Fatores que afetam os resultados da pesquisa

Em conjunto, as opções "Pesquisa de emprego em destaque", "Ativar alargamento" e "Desativar correspondência de palavras-chave" têm um impacto significativo no número e na relevância dos empregos devolvidos ao candidato a emprego. A configuração mais adequada destes três fatores depende das necessidades da sua empresa. O melhor método para determinar a sua configuração ideal é aplicar diferentes cenários de teste e avaliar os resultados durante uma fase de teste. Consulte a nossa página de tutoriais em vídeo para mais informações sobre a utilização destes parâmetros.

  1. Pesquisa de emprego em destaque: use pesquisas de emprego em destaque para atribuir valores promocionais a empregos individuais. Isto permite-lhe realçar tarefas importantes para as necessidades da sua empresa. Consulte a documentação da pesquisa de emprego em destaque para ver práticas recomendadas e detalhes de implementação.

  2. disableKeywordMatch: Este parâmetro permite que a pesquisa de empregos devolva correspondências baseadas em palavras-chave à consulta de um candidato a emprego, além de correspondências relevantes. A predefinição é false. Se definir este parâmetro como true, desativa a correspondência de palavras-chave, pelo que são devolvidos menos trabalhos (apenas os que a funcionalidade de ML determina serem relevantes).

  3. enableBroadening: Use este parâmetro para expandir a consulta do candidato a emprego, relaxando as restrições indicadas relativamente à localização e às categorias de emprego. A predefinição é false. A ativação deste parâmetro aumenta o número de resultados da pesquisa devolvidos, mas pode diminuir a relevância do conjunto de resultados geral para o candidato a emprego.

Pesquise resultados da configuração

Para devolver apenas os trabalhos mais relevantes: defina disableKeywordMatch como true e enableBroadening como false. Isto melhora as métricas de desempenho relacionadas com a relevância da API, uma vez que apenas são devolvidos os trabalhos relevantes. No entanto, são devolvidos menos trabalhos nos resultados da pesquisa.

Para devolver um número mais elevado de trabalhos, incluindo resultados relevantes e correspondentes a palavras-chave: Defina disableKeywordMatch como false e enableBroadening como false. Os resultados com correspondência de palavras-chave são apresentados após as ofertas de emprego relevantes nos resultados. Os resultados da expansão de consultas não são devolvidos.

Para devolver um número mais elevado de trabalhos, incluindo trabalhos relevantes e expandidos pela consulta: Defina disableKeywordMatch como true e enableBroadening como true. A consulta do candidato é expandida para incluir categorias de emprego relacionadas e localizações próximas. Estas tarefas adicionais são apresentadas após os resultados relevantes. Não são devolvidas correspondências baseadas em palavras-chave.

Para devolver o número mais elevado possível de trabalhos: defina disableKeywordMatch como false e enableBroadening como true. A pesquisa de emprego devolve os empregos mais relevantes na parte superior dos resultados da pesquisa, seguidos dos empregos correspondentes a palavras-chave e dos empregos expandidos por consulta (por localização, categoria de emprego, etc.). Isto maximiza o número total de trabalhos devolvidos.

diasableKeywordMatch enableBroadening Resultado
- - Devolve um número mais elevado de trabalhos, incluindo resultados relevantes e correspondentes a palavras-chave (mas suponha que a pesquisa de trabalhos em destaque está definida como false).
+ + Devolve um número mais elevado de trabalhos, incluindo trabalhos relevantes e trabalhos expandidos pela consulta (mas parta do princípio que a pesquisa de trabalhos em destaque está definida como false).
- + Devolve o número mais elevado de trabalhos (mas pressupõe que a pesquisa de trabalhos em destaque está definida como false).
+ - Devolve apenas os trabalhos mais relevantes (mas pressupõe que a pesquisa de trabalhos em destaque está definida como false).

Request.page_size

Para um melhor desempenho e para evitar a latência, configure a página de resultados para apresentar 20 ou menos trabalhos de cada vez. Consulte a página de vista geral da pesquisa para mais informações sobre a implementação da paginação.

customAttributes

customAttributes dá-lhe a flexibilidade de atribuir valores adicionais aos seus trabalhos de acordo com as necessidades da sua empresa (por exemplo, classificações de GPA) e usar estes valores para filtrar os resultados.

Campo de localização

Pode encontrar uma vista geral detalhada do campo location na página campos de localização. Indicar a morada da rua do emprego em vez das coordenadas GPS no campo address ajuda a pesquisa de emprego a melhorar a deteção da localização e a relevância da pesquisa.

locationFilter

Use o campo regionCode se uma única empresa tiver várias oportunidades de emprego em diferentes regiões geográficas. A atribuição de um regionCode a cada ficha garante que uma consulta de pesquisa devolve empregos apenas na localização pretendida pelo candidato a emprego, em vez de resultados globais correspondentes à consulta de pesquisa. Por exemplo, uma pesquisa na palavra-chave de localização "Cambridge" sem um regionCode no lugar devolve resultados de Cambridge, Reino Unido, e Cambridge, MA, EUA. Isto diminui a relevância da pesquisa.

region_code e language_code

Estes dois campos permitem que a pesquisa de emprego use uma lógica de pesquisa localizada em diferentes regiões geográficas (por exemplo, "motorista de camião" em en_GB em vez de "truck driver" nos Estados Unidos). Defina request.filters.location_filters.region_code para corresponder à localização geográfica que o utilizador está a pesquisar (como o Reino Unido) erequest.filters.language_code para o código de idioma adequado para essa região (en_GB neste caso).

radiusinMiles

Este parâmetro define um raio (em milhas) em torno da localização indicada por um candidato a emprego. A pesquisa de emprego devolve resultados dentro deste intervalo geográfico. A forma como esta distância é aplicada à geografia dos resultados da pesquisa depende do tipo de informações de localização introduzidas. Se o candidato a emprego introduzir uma morada, a distância radiusInMiles é definida a partir de um único ponto. Se o candidato introduzir uma cidade, a pesquisa de emprego aplica uma caixa delimitadora em torno dos limites da cidade e calcula a distância a partir dos limites da caixa. Se o utilizador introduzir apenas um distrito ou um país, o elemento radiusInMiles é ignorado.

Certifique-se de que o raio em quilómetros é o mais pequeno possível. Definir a quilometragem para um intervalo maior faz com que a pesquisa de emprego devolva resultados que podem estar fora da localização pretendida pelo candidato, o que diminui a relevância. Por exemplo, se pesquisar empregos na cidade de Nova Iorque com radiusInMiles definido como 160 km, são devolvidos resultados em Nova Jérsia e no norte de Nova Iorque. Manter o raio o mais pequeno possível aumenta a relevância dos resultados.

postingExpireTime

Este parâmetro define o período durante o qual a publicação de emprego permanece ativa antes de ser removida dos resultados da pesquisa. Por predefinição, o CTS remove as tarefas 30 dias após a hora de criação (hora UTC).

Job_employment_type

Este campo não é obrigatório. No entanto, a utilização de job_employment_type aumenta a relevância dos resultados da pesquisa.

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

A pesquisa de emprego em destaque permite-lhe influenciar os resultados da pesquisa de um utilizador realçando empregos com base numa única variável (promotionValue). Consulte a documentação da pesquisa de emprego em destaque para ver detalhes. A classificação personalizada permite-lhe influenciar os resultados da pesquisa com base em várias variáveis, oferecendo um controlo mais detalhado sobre as classificações. Esta funcionalidade é útil em aplicações que requerem o equilíbrio entre a relevância e os interesses económicos, como um sistema de subscrição de custo por clique (CPC) de vários níveis. A influência sobre a forma como os empregos são classificados além da pontuação de relevância original baseia-se em duas variáveis: rankingExpression e importanceLevel. Consulte o nosso tutorial de vídeo para mais informações sobre a utilização de empregos em destaque e da ordenação personalizada.

  • rankingExpression: esta variável controla a forma como as tarefas são classificadas com base nas respetivas pontuações de relevância calculadas. "rankingExpression" tem de ser definido como "filterable" para que a pesquisa de emprego indexe o parâmetro.

  • importanceLevel: este parâmetro define o nível de importância da posição de classificação de uma oferta de emprego quando é devolvida nos resultados da pesquisa. Existem seis níveis possíveis: Unspecified, NONE, LOW, MID, HIGH e EXTREME. Se definir o valor como EXTREME, todos os outros fatores de relevância gerados pela API são ignorados. Por isso, use este valor com moderação. Os empregos definidos como EXTREME são devolvidos na parte superior da consulta do candidato, em vez dos empregos mais relevantes.

  • Pesquisa de empregos em destaque versus classificação personalizada: uma pesquisa de empregos em destaque é mais útil para promover uma única categoria de empregos acima da classificação por relevância, por exemplo, empregos numa determinada empresa. Se precisar de classificar os trabalhos de acordo com variáveis de CPC (custo por clique) de vários níveis, além da classificação de relevância, a classificação personalizada é uma escolha melhor.

A pesquisa de trajeto permite que os candidatos a emprego pesquisem empregos com base no tempo de trajeto. Para a ativar, inclua um objeto CommuteFilter no campo JobQuery.commuteFilter. O CommuteFilter calcula o tempo de viagem regular com base no método de viagem regular, na duração da viagem e nas coordenadas de início indicados por um candidato a emprego. Os candidatos a emprego também têm de selecionar roadTraffic (TRAFFIC_FREE ou BUSY_HOUR) ou departureTime para incluir no cálculo do tempo. Consulte as páginas de implementação e instruções da pesquisa de trajeto para ver detalhes.

Os resultados da pesquisa de trajeto baseiam-se em dados históricos e agregados, em vez de condições de trânsito em tempo real. As departureTimecondições de trânsito são calculadas a partir das condições de trânsito médias na hora do dia especificada. As opções BUSY_HOUR/TRAFFIC_FREE em roadTraffic representam as condições médias de trânsito na hora de ponta da manhã e à meia-noite, respetivamente. Os utilizadores recebem os mesmos resultados de pesquisa de trajeto, independentemente da hora do dia em que enviam uma consulta.

Multi-tenancy (opcional)

A Pesquisa de emprego suporta inquilinos como uma camada organizacional intermédia entre um Google Cloud projeto e quaisquer dados carregados para o mesmo. Os inquilinos impedem a partilha de dados entre barreiras de arrendamento, o que lhe permite isolar subconjuntos dos seus dados sem precisar de vários projetos. A multilocação é útil em situações em que tem vários clientes e não quer partilhar dados entre eles, mas quer manter um únicoGoogle Cloud projeto para faturação e relatórios internos. Por exemplo:

  • Fornecedores de sites de emprego que criam sites de emprego para organizações com várias empresas subsidiárias.
  • Agências de recrutamento que criam sistemas de acompanhamento de candidatos para várias empresas.

É atribuído a cada projeto um único ID do inquilino predefinido. Pode implementar a multilocação criando mais do que um inquilino num determinado projeto.

Os inquilinos estão totalmente isolados uns dos outros. Todas as APIs pedem apenas um único inquilino para evitar que os dados sejam consultados em vários inquilinos na mesma chamada API. Da mesma forma, os algoritmos de aprendizagem automática tratam os inquilinos como unidades discretas e não ultrapassam as barreiras de arrendamento. Um projeto pode suportar tantos inquilinos quantos os necessários.

Segurança

O CTS oferece suporte de inquilino muito leve. É responsável por criar inquilinos, atribuir IDs de inquilinos e fornecer o ID de inquilino correto quando faz um pedido. O CTS verifica se o ID do inquilino é detido por um determinado projeto e obtém dados do inquilino fornecido. Qualquer segurança adicional para detetar acesso não autorizado tem de ser gerida no seu sistema de back-end.

Gestão de dados e processamento de erros

Integridade de dados

  1. Carregar empregos: os problemas de dados podem impedir o carregamento de empregos para a Pesquisa de empregos. Consulte a página Códigos de resposta HTTP para ver uma lista de códigos de erro. Seguem-se alguns exemplos comuns:

    • As localizações de emprego estão incorretas e, por isso, não é possível resolver o pedido.
    • Os campos Company ou Job não existem, pelo que é devolvido um pedido inválido.

    Existem três opções principais para resolver problemas de carregamento de trabalhos:

  2. Indexação de empregos: a Pesquisa de empregos foi concebida para indexar todos os empregos carregados num período definido. No entanto, pode ter restrições de quota da sua parte. Certifique-se de que verifica se existem restrições no seu sistema relativamente a pedidos de indexação antes de enviar tarefas para o CTS.

Ataques DDoS autoinfligidos

Processamento de erros

Os serviços de API fornecidos através da Internet podem ter falhas de ligação intermitentes, uma indisponibilidade prolongada, manutenção súbita do serviço e outros eventos que exigem que uma aplicação cliente tente novamente o pedido de API. Certifique-se de que concebe a nova tentativa com um comportamento compatível com a rede, por exemplo, a retirada exponencial.

Limites de quota

Evite enviar tráfego superior à quota aprovisionada, especialmente muito superior à quota aprovisionada. Caso contrário, o seu tráfego pode ser classificado como malicioso e, por isso, bloqueado.

Remoção de duplicados

Os empregos duplicados afetam negativamente a experiência de pesquisa de uma pessoa à procura de emprego. A Pesquisa de emprego inclui duas funcionalidades para minimizar os duplicados:

  1. Criar tarefas: se tentar criar 2 ou mais tarefas com os seguintes critérios, o registo é rejeitado e é devolvido um erro 4xx:

    • mesmo companyName, E
    • mesmo job_req_id, E
    • mesma localização/languageCode

  2. Pesquisar empregos: a Pesquisa de emprego apresenta empregos relevantes para a consulta de pesquisa do candidato a emprego. Uma funcionalidade integrada do algoritmo de relevância garante que os trabalhos devolvidos são diversificados, impedindo que trabalhos quase idênticos sejam apresentados lado a lado nos resultados da pesquisa.