Parámetros de la API Job Search: prácticas recomendadas (v3)

Configurar la API

Factores que afectan a los resultados de búsqueda

Las opciones "Empleos destacados", "Habilitar ampliación" y "Inhabilitar concordancia de palabras clave" tienen un impacto significativo en el número y la relevancia de los empleos que se muestran a los candidatos. La configuración más adecuada de estos tres factores depende de las necesidades de tu empresa. La mejor forma de determinar la configuración óptima es aplicar diferentes escenarios de prueba y evaluar los resultados durante una fase de pruebas.

  1. Empleos destacados: puedes usar esta función para asignar valores promocionales a empleos concretos, lo que te permite destacar los que son importantes para las necesidades de tu empresa. Consulta la documentación sobre trabajos destacados para obtener información sobre las prácticas recomendadas y los detalles de implementación.

  2. disableKeywordMatch: este parámetro permite que la API devuelva coincidencias de palabras clave, además de los resultados relevantes determinados por el algoritmo de aprendizaje automático. El valor predeterminado es false. Si se mantiene la configuración predeterminada, la API de búsqueda de empleo de CTS devuelve los empleos que el algoritmo de aprendizaje automático no ha devuelto como relevantes, pero que coinciden con la cadena de consulta del candidato por palabras clave en el título o en la descripción del empleo. Si asignas el valor true a este parámetro, se inhabilitará la coincidencia de palabras clave, por lo que se devolverán menos trabajos (solo los que la función de aprendizaje automático determine que son relevantes).

  3. enableBroadening: Este parámetro te permite ampliar la consulta del solicitante de empleo relajando las restricciones que haya indicado sobre la ubicación y las categorías de empleo. Está configurada como false de forma predeterminada y se habilita cuando se configura como true. Se usa para aumentar el número de resultados de búsqueda devueltos.

Resultados de la configuración de búsqueda

Para que se devuelvan solo los trabajos más relevantes, define disableKeywordMatch como true y enableBroadening como false. De esta forma, se mejoran las métricas de rendimiento de la API relacionadas con la relevancia de las búsquedas, ya que solo se devuelven los trabajos pertinentes. Sin embargo, en los resultados de búsqueda se devuelven menos trabajos en general.

Para devolver un mayor número de empleos, incluidos los resultados relevantes y los que coinciden con las palabras clave: define disableKeywordMatch como false y enableBroadening como false. Los resultados que coinciden con las palabras clave se muestran después de los trabajos relevantes en los resultados, pero no se devuelven los resultados de la ampliación de la consulta.

Para devolver un mayor número de tareas, incluidas las relevantes y las ampliadas por la consulta: Asigna el valor true a disableKeywordMatch y a enableBroadening.true La consulta del candidato se amplía para incluir categorías de empleo relacionadas y ubicaciones cercanas, que se muestran después de los resultados pertinentes. No se devuelven coincidencias basadas en palabras clave.

Para devolver el mayor número posible de trabajos: asigna el valor disableKeywordMatch a false y el valor enableBroadening a true. La API Job Search devuelve los empleos más relevantes en la parte superior de los resultados de búsqueda, seguidos de los empleos que coinciden con las palabras clave y los empleos que se han ampliado en la consulta (por ubicación, categoría de empleo, etc.). De esta forma, se maximiza el número total de trabajos devueltos.

diasableKeywordMatch enableBroadening Resultado
- - Devuelve un número mayor de empleos, incluidos los resultados relevantes y los que coinciden con las palabras clave (pero se supone que la opción de empleos destacados está definida como `false`).
+ + Devuelve un número mayor de tareas, incluidas las relevantes y las que se han ampliado mediante la consulta (pero se supone que la opción de tareas destacadas está definida como `false`).
- + Devuelve el mayor número de empleos (pero se supone que los empleos destacados están definidos como `false`).
+ - Devuelve solo los trabajos más relevantes (pero asume que la opción de trabajos destacados está definida como `false`).

Request.page_size

Para obtener el mejor rendimiento y evitar la latencia, configura la página de resultados para que muestre 20 o menos empleos a la vez.

customAttributes

customAttributes te ofrece la flexibilidad de asignar valores adicionales a tus trabajos según tus necesidades empresariales (por ejemplo, las calificaciones medias) y usar estos valores para filtrar los resultados.

Campo de ubicación

Puedes consultar una descripción detallada del campo Location en la página Campos de ubicación. Si proporcionas la dirección postal del trabajo en lugar de las coordenadas GPS en el campo de dirección, la API podrá mejorar la detección de la ubicación y la relevancia de la búsqueda.

locationFilter

Usa regionCode si una empresa tiene varias ofertas de empleo en diferentes regiones geográficas. Si asignas un regionCode a cada ficha, te aseguras de que una consulta de búsqueda devuelva solo los empleos de la ubicación que le interese al candidato, en lugar de los resultados globales de esa empresa. Por ejemplo, si se busca la palabra clave de ubicación "Cambridge" sin un regionCode, se devuelven resultados de Cambridge (Reino Unido) y de Cambridge (Massachusetts, EE. UU.). Esto reduce la relevancia de las búsquedas.

Region_code y Language_code

Define request.filters.location_filters.region_code para que coincida con la ubicación geográfica que busca el usuario (por ejemplo, Reino Unido). Asigna el valor request.filters.language_code al código de idioma adecuado para esa región (en_GB en este caso) para que la API pueda usar una lógica de búsqueda localizada (por ejemplo, "lorry driver" en en_GB en lugar de "truck driver" en Estados Unidos).

radiusinMiles

Este parámetro define un radio (en millas) alrededor de la ubicación que indica el candidato. La API devuelve resultados dentro de este intervalo geográfico. La forma en que se aplica esta distancia a la geografía de los resultados de búsqueda depende del tipo de información de ubicación que se haya introducido. Si el candidato introduce una dirección, la radiusInMiles distancia se establece desde un único punto. Si el candidato introduce una ciudad, la API aplica un cuadro delimitador alrededor de los límites de la ciudad y calcula la distancia desde los bordes del cuadro. Si el usuario solo introduce un estado o un país, se ignora radiusInMiles.

Asegúrate de que el radio de distancia sea lo más pequeño posible. Si se establece un radio mayor, se obtendrán resultados que pueden estar fuera de la ubicación deseada por el candidato, lo que reducirá la relevancia. Por ejemplo, si buscas empleo en la ciudad de Nueva York y estableces radiusInMiles en 100 millas, se mostrarán resultados del norte del estado de Nueva York y de Nueva Jersey. Si el radio es lo más pequeño posible, los resultados serán más relevantes.

postingExpireTime

Este parámetro define el tiempo que la oferta de empleo está activa antes de que se elimine de los resultados de búsqueda. El valor predeterminado es 30 días después de la hora de creación del trabajo en la zona horaria UTC.

Job_employment_type

Este campo no es obligatorio, pero si lo usa, aumentará la relevancia de los resultados de búsqueda de empleo.

Configurar la API: ranking personalizado

Empleos destacados te permite influir en los resultados de búsqueda y destacar empleos en función de una sola variable (promotionValue). Consulta la documentación de Empleos destacados para obtener más información. Ranking personalizado te permite influir en los resultados en función de varias variables, lo que te ofrece más control sobre las clasificaciones, independientemente de la relevancia. Esta función es útil para las aplicaciones que requieren equilibrar la relevancia con los intereses económicos, como un sistema de suscriptores de coste por clic (CPC) de varios niveles. La influencia en la forma en que se clasifican los trabajos por encima de la puntuación de relevancia actual se basa en dos variables: rankingExpression y importanceLevel.

  • rankingExpression: esta variable controla cómo se clasifican los trabajos en función de sus puntuaciones de relevancia (determinadas por el algoritmo de la API). "rankingExpression" debe tener el valor "filterable" para que la API indexe el parámetro.

  • importanceLevel: Este parámetro define el nivel de importancia de la posición de un empleo en el ranking cuando se devuelve en las búsquedas. Hay seis niveles diferentes: Sin especificar, NONE, LOW, MID, HIGH y EXTREME. Si asigna el valor EXTREME, se ignorarán todos los demás factores de relevancia generados por la API, por lo que debe usar este valor con moderación. Los empleos definidos como EXTREME se devuelven en la parte superior de la consulta del candidato en lugar de los empleos más relevantes.

  • Empleos destacados frente a Clasificación personalizada: la opción Empleos destacados es la más útil para promocionar una sola categoría de empleos (por ejemplo, empleos en una empresa concreta) por encima de la clasificación por relevancia. Si necesitas clasificar los trabajos según variables de CPC (coste por clic) de varios niveles, además de la clasificación por relevancia, Clasificación personalizada es una mejor opción.

La búsqueda por ruta de desplazamiento ayuda a los candidatos a buscar empleo en función del tiempo de desplazamiento. Para habilitarlo, incluye un objeto CommuteFilter adicional en el campo JobQuery.commuteFilter. Este objeto permite al candidato seleccionar commuteMethod, travelDuration y startCoordinates. El candidato también puede seleccionar opciones como roadTraffic (TRAFFIC_FREE o BUSY_HOUR) y departureTime al calcular el tiempo de desplazamiento. Para obtener más información, consulta las páginas sobre la implementación y las instrucciones de la búsqueda de trayectos.

Gestión de datos y control de errores

Integridad de datos

  1. Subida de trabajos: los problemas con los datos pueden impedir que los trabajos se suban a la API. Consulta más información en la página Códigos de respuesta HTTP. Estos son algunos ejemplos:

    • Las ubicaciones de empleo son incorrectas, por lo que no se puede resolver la solicitud.
    • No existen los campos Company o Job, lo que devuelve una solicitud incorrecta.

    Hay tres opciones principales para solucionar problemas al subir trabajos:

  2. Indexación de empleos: la API de búsqueda de empleo se ha diseñado para indexar todos los empleos que hayas subido en un periodo determinado. Sin embargo, es posible que tengas restricciones de cuota. Asegúrate de comprobar si tu sistema tiene restricciones en las solicitudes de indexación antes de enviar trabajos a CTS.

Mecanismos de gestión de errores

La gestión de errores es fundamental para evitar un ataque DDoS autoinfligido que provoque que los solicitantes de empleo no puedan acceder. Los servicios de API proporcionados a través de Internet también pueden sufrir fallos de conexión intermitentes, interrupciones prolongadas, mantenimiento repentino del servicio y otros eventos que requieran que una aplicación cliente vuelva a intentar la solicitud de API. Este reintento debe diseñarse con un comportamiento compatible con la red, como el tiempo de espera exponencial.

Eliminación de duplicados

Las ofertas de empleo duplicadas afectan negativamente a la experiencia de búsqueda de los candidatos. La API de búsqueda de empleo incluye dos funciones para minimizar los duplicados:

  1. Crear tareas: si intentas crear dos o más tareas con los siguientes criterios, el registro se rechazará y se producirá un error 4xx:

    • mismo companyName, Y
    • mismo job_req_id, Y
    • misma ubicación/languageCode

  2. Buscar empleo: la API de búsqueda de empleo de CTS muestra los empleos que son relevantes para la consulta de búsqueda del solicitante de empleo. Una función integrada del algoritmo de relevancia se asegura de que los trabajos devueltos sean diversos, lo que evita que se muestren trabajos casi idénticos uno al lado del otro en los resultados de búsqueda.