Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Parámetros de la API de búsqueda de trabajo: Prácticas recomendadas (v3)

Configura la API

Factores que afectan los resultados de la búsqueda

Juntos, “Trabajos destacados”, “Habilitar ampliación” e “Inhabilitar coincidencia de palabras clave” tienen un impacto significativo en la cantidad y relevancia de los trabajos que se muestran al usuario. La configuración más adecuada de estos tres factores depende de las necesidades de tu negocio. El mejor método para determinar su configuración óptima es aplicar diferentes situaciones de prueba y evaluar los resultados durante una fase de prueba.

  1. Trabajos destacados: puedes usar trabajos destacados para asignar valores promocionales a trabajos individuales, lo que te permite destacar trabajos que son importantes para las necesidades de tu empresa. Consulta la documentación sobre los 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 muestre coincidencias de palabras clave, además de los resultados relevantes que determina el algoritmo de AA. La configuración predeterminada es false. Mantener la configuración predeterminada significa que la API de búsqueda de trabajo de CTS muestra trabajos que no se mostraron como relevantes según el algoritmo de AA, pero hay una coincidencia de palabras clave en el título o la descripción del trabajo con la string de consulta del usuario. Configurar este parámetro como true inhabilita la coincidencia de palabras clave, por lo que se muestran menos trabajos (solo aquellos que son relevantes para la función de AA).

  3. enableBroadening: Este parámetro te permite expandir la consulta del usuario mediante la reducción de las restricciones indicadas en las categorías de ubicación y trabajo. Se establece en false de forma predeterminada y se habilita cuando se establece en true. Se usa para aumentar la cantidad de resultados de la búsqueda que se muestran.

Resultados de configuración de búsqueda

Para mostrar solo los trabajos más relevantes: Establece disableKeywordMatch en true y enableBroadening en false. Esto mejora las métricas de rendimiento de las API relacionadas con la relevancia de la búsqueda, ya que solo se muestran trabajos relevantes. Sin embargo, se muestran menos trabajos en general en los resultados de la búsqueda.

Para que se muestren una mayor cantidad de trabajos, incluidos los resultados relevantes y de concordancia de palabras clave, configura disableKeywordMatch como false y enableBroadening como false. Los resultados de la concordancia de palabras clave se enumeran después de los trabajos relevantes en los resultados, pero no se muestran los resultados de la expansión de consultas.

Para que se muestren una mayor cantidad de trabajos, incluidos los trabajos expandidos y relevantes, configura disableKeywordMatch como true y enableBroadening en true. La consulta del usuario se expande para incluir categorías de trabajo relacionadas y ubicaciones cercanas, enumeradas después de los resultados relevantes. No se muestran coincidencias basadas en palabras clave.

Para mostrar la mayor cantidad posible de trabajos: configura disableKeywordMatch como false y enableBroadening en true. La API de búsqueda de trabajo muestra los trabajos más relevantes en la parte superior de los resultados de la búsqueda, seguido de trabajos coincidentes por palabras clave y trabajos expandidos de palabras clave (por ubicación, categoría de trabajo, etcétera). Esto maximiza la cantidad total de los trabajos que se muestran.

diasableKeywordMatch enableBroadening Outcome
- - Muestra una mayor cantidad de trabajos, incluidos los resultados relevantes y de concordancia de palabras clave (pero supone que los trabajos destacados se configuran en "false").
+ + Muestra una mayor cantidad de trabajos, incluidos los trabajos expandidos y relevantes, pero supone que los trabajos destacados se configuran con un valor "false".
- + Muestra el número más alto de trabajos (aunque supone que los trabajos destacados se configuran en "false").
+ - Muestra solo los trabajos más relevantes (pero supone que los trabajos destacados se configuran en "false").

Request.page_size

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

customAttributes

customAttributes te brinda la flexibilidad para asignar valores adicionales a tus trabajos de acuerdo con las necesidades de tu empresa (por ejemplo, puntajes de GPA) y usar estos valores para filtrar los resultados.

Campo de ubicación

Puedes encontrar una descripción general detallada del campo Ubicación en la página Campos de ubicación. Si se proporciona la dirección de la dirección del trabajo en lugar de las coordenadas de GPS en el campo de dirección, la API podrá mejorar la detección de ubicación y la relevancia de búsqueda.

locationFilter

Usa regionCode si una sola empresa tiene varias vacantes de trabajo ubicadas en distintas regiones geográficas. Asignar un regionCode a cada lista garantiza que una búsqueda muestre trabajos solo en la ubicación deseada del usuario que busca empleo en lugar de los resultados globales para esa empresa. Por ejemplo, una búsqueda de la palabra clave de ubicación "Cambridge" sin un regionCode en su lugar muestra resultados de Cambridge, UK y Cambridge, MA, EE.UU. Esto reduce la relevancia de búsqueda.

Region_code y Language_code

Configura request.filters.location_filters.region_code para que coincida con la ubicación geográfica que busca el usuario (por ejemplo, el Reino Unido). Configura request.filters.language_code en el código de idioma adecuado para esa región (en_GB en este caso) para que la API pueda usar la lógica de búsqueda localizada (por ejemplo, "controlador principal" en en_GB. en lugar de "conductor de camiones" en Estados Unidos).

radiusinMiles

Este parámetro establece un radio (en millas) alrededor de la ubicación indicada para un usuario. La API muestra resultados dentro de este rango geográfico. La forma en que esta distancia se aplica a la geografía de los resultados de la búsqueda depende del tipo de información de ubicación ingresada. Si el usuario ingresa una dirección, la distancia de radiusInMiles se establece desde un único punto. Si el usuario se ingresa en una ciudad, la API aplica un cuadro de límite alrededor de los límites de la ciudad y calcula la distancia desde los bordes del cuadro. Si el usuario solo ingresa a un estado o país, se ignorará radiusInMiles.

Asegúrate de que el radio de kilometraje sea lo más pequeño posible. Si estableces el kilometraje en un rango más grande, se muestran resultados que pueden estar fuera de la ubicación deseada del usuario que busca empleo, lo que reduce la relevancia. Por ejemplo, si buscas trabajos en la ciudad de Nueva York con radiusInMiles establecido en 100 millas, se muestran los resultados en el estado de Nueva York y Nueva Jersey. Mantener el radio lo más pequeño posible aumenta la relevancia de los resultados.

postingExpireTime

Este parámetro establece el tiempo que la publicación del trabajo está activa antes de quitarla de los resultados de la 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 el uso de Job_employment_type aumenta la relevancia de los resultados de la búsqueda de trabajo.

Cómo configurar la API: clasificación personalizada

Los Trabajos destacados te permiten influir en los resultados de la búsqueda y destacar los trabajos según una sola variable (promotionValue). Consulta la documentación de Trabajos destacados para obtener más detalles. La clasificación personalizada te permite influir en los resultados en función de varias variables y ofrece más control sobre las clasificaciones sin importar la relevancia. Esta función es útil para las aplicaciones que requieren equilibrio en la relevancia con los intereses económicos, como un sistema de suscriptores de costo por clic (CPC) de varios niveles. La influencia en la clasificación de los trabajos sobre la puntuación de relevancia existente se basa en dos variables: rankingExpression y importanceLevel.

  • rankingExpression: Esta variable controla cómo se clasifican los trabajos según sus puntuaciones de relevancia existentes (según lo determinado por el algoritmo de la API). “rankExpression” se debe configurar como “filterable” para que la API indexe el parámetro.

  • importanceLevel: Este parámetro establece el nivel de importancia de la posición de clasificación de un trabajo cuando se muestra en las búsquedas. Existen seis niveles diferentes: sin especificar, NONE, LOW, MID, HIGH y EXTREME. Establecer el valor en EXTREME significa que se ignoran todos los demás factores de relevancia generados por la API, así que usa este valor con moderación. Los trabajos configurados como EXTREME se muestran en la parte superior de la consulta del usuario en lugar de los trabajos más relevantes.

  • Trabajos destacados y Clasificación personalizada: los Trabajos destacados son más útiles para promocionar una sola categoría de trabajos (por ejemplo, los trabajos de una empresa) encima de la clasificación de relevancia. Si necesitas clasificar trabajos según las variables de CPC (costo por clic) de varios niveles, además de la clasificación de relevancia, la Clasificación personalizada es una mejor opción.

La búsqueda por viaje cotidiano ayuda a quienes buscan trabajo a buscar trabajo según el tiempo de viaje cotidiano. Para habilitarlo, incluye un objeto CommuteFilter adicional en el campo JobQuery.commuteFilter. Este objeto permite que el usuario que seleccione el trabajo seleccione commuteMethod, travelDuration y startCoordinates. El usuario también puede seleccionar opciones como roadTraffic (TRAFFIC_FREE o BUSY_HOUR) y departureTime cuando se calcula la duración del viaje cotidiano. Consulta las páginas implementación y instructivo de Búsqueda por viaje para obtener más detalles.

Administración de datos y manejo de errores

Integridad de los datos

  1. Carga de trabajos: los problemas de datos pueden evitar que los trabajos se suban a la API. Consulta la página Códigos de respuesta HTTP para obtener más información. Estos son algunos ejemplos comunes:

    • Las ubicaciones de los trabajos son incorrectas, por lo que la solicitud no se puede resolver.
    • No existen campos de la empresa ni del trabajo, lo que muestra una solicitud incorrecta.

    Existen tres opciones principales para solucionar problemas de carga de trabajos:

  2. Indexar trabajos: La API de búsqueda de trabajo está diseñada para indexar todos tus trabajos subidos en un período determinado. Sin embargo, es posible que tenga restricciones de cuota al final. Asegúrate de verificar tu sistema para ver las restricciones de solicitudes de indexación antes de enviar trabajos al CTS.

Mecanismo de manejo de errores

El manejo de errores es fundamental para evitar un ataque de DSD autoinfluido, que provoca que los usuarios que buscan empleo estén bloqueados. Los servicios de API proporcionados a través de Internet también pueden tener una falla de conexión intermitente, una interrupción prolongada, un mantenimiento repentino del servicio y otros eventos que requieren una aplicación cliente para reintentar la solicitud a la API. Este reintento debe diseñarse con un comportamiento adecuado para la red, por ejemplo, la retirada exponencial.

Anulación de duplicados

Los trabajos duplicados afectan de forma negativa la experiencia de búsqueda de un usuario. La API de búsqueda de trabajo incluye dos funciones para minimizar los duplicados:

  1. Crea trabajos: Si intentas crear más de 2 trabajos con los siguientes criterios, se rechazará el registro y verás un error 4xx:

    • mismo companyName, Y
    • mismo job_req_id, Y
    • misma ubicación/languageCode
  2. Buscar trabajos: La API de búsqueda de trabajo de CTS muestra trabajos que son relevantes para la búsqueda del usuario. Una característica integrada del algoritmo de relevancia se asegura de que los trabajos que se muestren se diversifican, lo que evita que los trabajos casi idénticos se muestren al lado de los demás en los resultados de la búsqueda.