Parâmetros da API Job Search: práticas recomendadas (v3)

Configurar a API

Fatores que afetam os resultados da pesquisa

Em conjunto, as opções "Empregos 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 configuração ideal é aplicar diferentes cenários de teste e avaliar os resultados durante uma fase de teste.

  1. Empregos em destaque: pode usar os empregos em destaque para atribuir valores promocionais a empregos individuais, o que lhe permite realçar empregos importantes para as necessidades da sua empresa. Consulte a documentação de Anúncios de emprego em destaque para ver as práticas recomendadas e os detalhes de implementação.

  2. disableKeywordMatch: este parâmetro permite que a API devolva correspondências de palavras-chave, além dos resultados relevantes determinados pelo algoritmo de AA. A predefinição é false. Manter a predefinição significa que a API CTS Job search devolve empregos que não foram devolvidos como relevantes pelo algoritmo de ML, mas existe uma correspondência de palavras-chave no título ou na descrição do emprego com a string de consulta do candidato. Definir este parâmetro como true desativa a correspondência de palavras-chave, pelo que são devolvidos menos trabalhos (apenas os que são considerados relevantes pela funcionalidade de ML).

  3. enableBroadening: Este parâmetro permite-lhe expandir a consulta do candidato a emprego relaxando as restrições indicadas nas categorias de localização e emprego. Por predefinição, está definida como false e é ativada quando está definida como true. É usado para aumentar o número de resultados da pesquisa devolvidos.

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 da API relacionadas com a relevância da pesquisa, 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 os trabalhos relevantes nos resultados, mas os resultados da expansão de consultas não são devolvidos.

Para devolver um número mais elevado de empregos, incluindo empregos relevantes e empregos expandidos pela consulta: Defina disableKeywordMatch como true e enableBroadening como true. A consulta do candidato a emprego é expandida para incluir categorias de emprego relacionadas e localizações próximas, 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 API Job Search 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 pressupõe que os trabalhos em destaque estão definidos como "false").
+ + Devolve um número mais elevado de empregos, incluindo empregos relevantes e empregos expandidos pela consulta (mas parta do princípio que os empregos em destaque estão definidos como "falso").
- + Devolve o número mais elevado de trabalhos (mas assume que os trabalhos em destaque estão definidos como "false").
+ - Devolve apenas os trabalhos mais relevantes (mas assume que os trabalhos em destaque estão definidos 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.

customAttributes

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

Campo de localização

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

locationFilter

Use o elemento regionCode se uma única empresa tiver várias vagas localizadas 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 dos resultados globais para essa empresa. 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

Defina request.filters.location_filters.region_code de modo a corresponder à localização geográfica que o utilizador está a pesquisar (como o Reino Unido). Defina request.filters.language_code para o código de idioma adequado para essa região (en_GB neste caso) para que a API possa usar a lógica de pesquisa localizada (por exemplo, "lorry driver" em en_GB em vez de "truck driver" nos Estados Unidos).

radiusinMiles

Este parâmetro define uma área (em milhas) em redor da localização indicada por um candidato a emprego. A API 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 a emprego introduzir uma cidade, a API 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, radiusInMiles é ignorado.

Certifique-se de que o raio em quilómetros é o mais pequeno possível. Definir a quilometragem para um intervalo maior devolve resultados que podem estar fora da localização pretendida pelo candidato, diminuindo a relevância. Por exemplo, pesquisar empregos na cidade de Nova Iorque com radiusInMiles definido para 160 km devolve resultados no norte do estado de Nova Iorque e em Nova Jersey. 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 está ativa antes de ser removida dos resultados da pesquisa. A predefinição é 30 dias após a hora de criação da tarefa no fuso horário UTC.

Job_employment_type

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

Configurar a API: classificação personalizada

Os Empregos em destaque permitem-lhe influenciar os resultados da pesquisa e realçar empregos com base numa única variável (promotionValue). Consulte a documentação dos Empregos em destaque para ver detalhes. A classificação personalizada permite-lhe influenciar os resultados com base em várias variáveis, oferecendo mais controlo sobre as classificações, independentemente da relevância. Esta funcionalidade é útil para 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 na forma como os trabalhos são classificados no topo da pontuação de relevância existente baseia-se em duas variáveis: rankingExpression e importanceLevel.

  • rankingExpression: esta variável controla a forma como as tarefas são classificadas com base nas respetivas pontuações de relevância existentes (conforme determinado pelo algoritmo da API). "rankingExpression" tem de ser definido como "filterable" para que a API indexe o parâmetro.

  • importanceLevel: este parâmetro define o nível de importância da posição de classificação de uma tarefa quando é devolvida nas pesquisas. Existem seis níveis diferentes: não especificado, NONE, LOW, MID, HIGH e EXTREME. Definir o valor como EXTREME significa que 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.

  • Empregos em destaque vs. Classificação personalizada: Empregos em destaque é mais útil para promover uma única categoria de empregos (por exemplo, empregos numa determinada empresa) acima da classificação por relevância. 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 por relevância, a classificação personalizada é uma melhor escolha.

A pesquisa de trajeto ajuda as pessoas à procura de emprego a pesquisarem empregos com base no tempo de trajeto. Para o ativar, inclua um objeto CommuteFilter adicional no campo JobQuery.commuteFilter. Este objeto permite ao candidato selecionar commuteMethod, travelDuration e startCoordinates. O candidato também pode selecionar opções como roadTraffic (TRAFFIC_FREE ou BUSY_HOUR) e departureTime ao calcular o tempo de trajeto. Consulte as páginas de implementação e instruções da pesquisa de trajetos para ver detalhes.

Gestão de dados e processamento de erros

Integridade de dados

  1. Tarefas de carregamento: os problemas de dados podem impedir o carregamento de tarefas para a API. Consulte a página Códigos de resposta HTTP para obter mais informações. 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, o que devolve um pedido inválido.

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

  2. Tarefas de indexação: a API Job Search 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.

Mecanismos de processamento de erros

O processamento de erros é fundamental para evitar um ataque DDoS autoinfligido que resulte no bloqueio dos candidatos a emprego. Os serviços API fornecidos através da Internet também 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 API. Esta nova tentativa tem de ser concebida com um comportamento adequado à rede, por exemplo, retirada exponencial.

Remoção de duplicados

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

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

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

  2. Pesquisar empregos: a API CTS Job search apresenta empregos relevantes para a consulta de pesquisa da pessoa à procura de 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.