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

Configuración de 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 los trabajos destacados para asignar valores promocionales a trabajos individuales. Esto te permite destacar los trabajos que son importantes para las necesidades de tu empresa. Consulta la documentación de Trabajos destacados para conocer 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 determinados por el algoritmo de AA. La configuración predeterminada es false. Con la configuración predeterminada, la API de Job Search de CTS muestra los trabajos que el algoritmo de AA no mostró como relevantes, pero que tienen una coincidencia de palabras clave en el título o la descripción del trabajo con la string de consulta del usuario que busca empleo. Cuando se establece este parámetro en true, se inhabilita la coincidencia de palabras clave, por lo que se muestran menos trabajos (solo aquellos que la función de AA considera relevantes).

  3. enableBroadening: Este parámetro te permite expandir la consulta del usuario mediante la flexibilización de las restricciones establecidas en las categorías de ubicación y trabajo. La configuración predeterminada es false y se habilita cuando se establece en true. Se usa para aumentar la cantidad de resultados de 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 mostrar una mayor cantidad de trabajos, incluidos los resultados relevantes y los de concordancia de palabras clave: Establece disableKeywordMatch en false y enableBroadening en 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 búsqueda expandida.

Para mostrar una mayor cantidad de trabajos, incluidos los trabajos relevantes y búsqueda expandida: Establece disableKeywordMatch en true y enableBroadening en true. La consulta del usuario se expande para incluir categorías de trabajo relacionadas y ubicaciones cercanas, las cuales aparecen después de los resultados relevantes. No se muestran coincidencias basadas en palabras clave.

Para mostrar la mayor cantidad posible de trabajos: Establece disableKeywordMatch en false y enableBroadening en true. La API de Job Search muestra los trabajos más relevantes en la parte superior de los resultados de la búsqueda, seguidos de los trabajos con concordancias de palabras clave y los trabajos de la búsqueda expandida (por ubicación, categoría de trabajo, etc.). Esto maximiza la cantidad total de los trabajos que se muestran.

diasableKeywordMatch enableBroadening Outcome
- - Muestra una cantidad mayor de trabajos, incluidos los resultados relevantes y los de concordancia de palabras clave (se supone que los trabajos destacados están configurados en "false").
+ + Muestra una cantidad mayor de trabajos, que incluyen los trabajos relevantes y los de la búsqueda expandida (se supone que los trabajos destacados están configurados en "false").
- + Muestra la mayor cantidad de trabajos (se supone que los trabajos destacados están configurados en "false").
+ - Muestra solo los trabajos más relevantes (se supone que los trabajos destacados están configurados 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. Proporcionar la dirección de la calle del trabajo en lugar de las coordenadas de GPS en el campo de dirección ayuda a la API a 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 trabajo ubicadas en regiones geográficas diferentes. Asignar un regionCode a cada ficha asegura que una búsqueda muestre trabajos solo en la ubicación deseada del usuario 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 muestra resultados de Cambridge, Reino Unido y Cambridge, MA, EE.UU. Esto disminuye la relevancia de la 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 (como el Reino Unido). Configura request.filters.language_code en el código de idioma adecuado para esa región (en_GB en este caso) a fin de que la API pueda usar la lógica de búsqueda localizada (por ejemplo, “conductor de furgones” en en_GB, en lugar de “chofer de camiones” en los Estados Unidos).

radiusinMiles

Este parámetro establece un radio (en kilómetros) alrededor de la ubicación que indicó un usuario. La API muestra resultados dentro de este rango geográfico. La forma en que se aplica esta distancia a la geografía de los resultados de la búsqueda depende del tipo de información de ubicación que se ingresó. Si el usuario ingresa una dirección, la distancia radiusInMiles se establece desde un punto único. Si el usuario ingresa a 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 ingresa solo un estado o país, se ignora radiusInMiles.

Asegúrate de que el radio de kilometraje sea lo más pequeño posible. Establecer el kilometraje en un rango mayor muestra resultados que pueden estar fuera de la ubicación deseada del usuario, lo que disminuye la relevancia. Por ejemplo, si se buscan trabajos en la ciudad de Nueva York con radiusInMiles configurado en 161 kilómetros, se mostrarán resultados en el norte del estado de Nueva York y Nueva Jersey. Si se mantiene el radio lo más pequeño posible, la relevancia de los resultados será mayor.

postingExpireTime

Este parámetro establece el tiempo en que la publicación de trabajo está activa antes de que se quite de los resultados de la búsqueda. El valor predeterminado es de 30 días después de la 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.

Configuración de la API: Clasificación personalizada

Los Trabajos destacados te permiten influenciar los resultados de la búsqueda y destacar trabajos en función de una sola variable (promotionValue). Consulta la documentación de Trabajos destacados para obtener más detalles. La Clasificación personalizada te permite influenciar los resultados de acuerdo con diversas variables, lo que te da más control sobre las clasificaciones sin importar la relevancia. Esta característica es útil en aplicaciones que requieren un equilibrio entre la relevancia y los intereses económicos, como un sistema de suscriptor de costo por clic (CPC) de varios niveles. El modo en que se influencia la clasificación de los trabajos por 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 las puntuaciones de relevancia existentes (como lo que determina el algoritmo de la API). Se debe configurar la “rankingExpression” como “filtrable” 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 implica que todos los demás factores de relevancia generados por la API se ignoran, por lo que debes usar este valor con moderación. Los trabajos configurados como EXTREME se muestran en la parte superior de la consulta del usuario en lugar de entre los trabajos más relevantes.

  • Uso de los trabajos destacados o la clasificación personalizada: Los trabajos destacados son más útiles para ver una sola categoría de trabajos (por ejemplo, trabajos de una empresa específica) por encima de la clasificación de relevancia. Si necesitas clasificar los trabajos de acuerdo con las variables de CPC (costo por clic) de varios niveles, además de la clasificación de relevancia, la mejor opción es laclasificación personalizada.

Labúsqueda por viaje diario ayuda a los usuarios a buscar trabajos en función del tiempo o los horarios de viaje diario. Para habilitarla, incluye un objeto CommuteFilter adicional en el campo JobQuery.commuteFilter. Este objeto permite que el usuario seleccione commuteMethod, travelDuration y startCoordinates. El usuario también puede seleccionar opciones como roadTraffic (TRAFFIC_FREE o BUSY_HOUR) y departureTime cuando calcula el tiempo de viaje diario. Consulta las páginas de implementación y el instructivo de la búsqueda por viaje diario para obtener más información.

Administración de datos y manejo de errores

Integridad de los datos

  1. Carga de trabajos: Los problemas de datos pueden impedir que se suban los trabajos a la API. Consulta la página Códigos de respuesta HTTP para obtener más información. A continuación, hay algunos ejemplos comunes:

    • Las ubicaciones de los trabajos son incorrectas, por lo que la solicitud no se puede resolver.
    • Los campos Empresa o Trabajo no existen, lo que muestra una solicitud incorrecta.

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

  2. Indexación de trabajos: La API de Job Search está diseñada para indexar todos los trabajos que se subieron en un período determinado. Sin embargo, es posible que tengas restricciones de cuota de tu parte. Asegúrate de verificar tu sistema para ver las restricciones en las solicitudes de indexación antes de enviar trabajos a CTS.

Mecanismo de manejo de errores

El manejo de errores es fundamental para evitar un ataque de DSD autoinfligido que haga que se bloquee al usuario. Los servicios de API proporcionados a través de Internet también pueden tener fallas de conexión intermitentes, una interrupción prolongada, mantenimiento de servicio repentino y otros eventos que requieran que una aplicación cliente vuelva a intentar la solicitud a la API. Este reintento debe diseñarse con un comportamiento intuitivo de 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 Job Search incluye dos funciones para minimizar los duplicados:

  1. Creación de trabajos: Si intentas crear más de 2 trabajos 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. Búsqueda de trabajos: La API de Job Search de CTS muestra trabajos que son relevantes para la búsqueda del usuario. Una característica incorporada del algoritmo de relevancia asegura que cualquier trabajo que se muestra se diversifique y evita que los trabajos que son casi idénticos aparezcan uno al lado del otro en los resultados de la búsqueda.