Parámetros de Job Search: prácticas recomendadas

Configuraciones de búsqueda de empleo

En esta sección se describen los parámetros que se pueden usar para configurar la API Job Search. Para obtener más información, consulta nuestro videotutorial.

Factores que afectan a los resultados de búsqueda

Las opciones "Búsqueda de empleo destacada", "Habilitar ampliación" y "Inhabilitar concordancia de palabras clave" influyen significativamente en el número y la relevancia de los empleos que se devuelven al candidato. 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 situaciones de prueba y evaluar los resultados durante una fase de pruebas. Consulta nuestra página de videotutoriales para obtener más información sobre cómo usar estos parámetros.

1. Búsqueda de empleos destacados: use búsquedas de empleos destacados para asignar valores promocionales a empleos concretos. De esta forma, puedes destacar los trabajos que sean importantes para tu empresa. Consulta la documentación sobre la búsqueda de empleo destacada para conocer las prácticas recomendadas y los detalles de implementación.

2. disableKeywordMatch: Este parámetro permite que la búsqueda de empleo devuelva coincidencias basadas en palabras clave a la consulta de un candidato, además de las coincidencias relevantes. El ajuste predeterminado es false. Si asignas el valor true a este parámetro, se inhabilitará la concordancia 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: Usa este parámetro para ampliar la consulta del candidato relajando las restricciones que haya indicado sobre la ubicación y las categorías de empleo. El ajuste predeterminado es false. Si habilita este parámetro, aumentará el número de resultados de búsqueda devueltos, pero puede que disminuya la relevancia del conjunto de resultados para el candidato.

Resultados de la configuración de búsqueda

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

Para devolver un número mayor de trabajos, 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 pertinentes en los resultados. No se devuelven los resultados de la ampliación de la consulta.

Para devolver un mayor número de empleos, incluidos los relevantes y los que se han ampliado a partir de 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. Estos trabajos adicionales 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. Búsqueda de empleo 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 mayor número de empleos, incluidos los resultados relevantes y los que coinciden con las palabras clave (pero se supone que la búsqueda de empleo destacada está definida como false).
+	+	Devuelve un número mayor de empleos, incluidos los relevantes y los que se han ampliado en la consulta (pero se supone que la búsqueda de empleos destacados está definida como false).
-	+	Devuelve el mayor número de empleos (pero se supone que la búsqueda de empleo destacada está definida como false).
+	-	Devuelve solo los empleos más relevantes (pero se supone que la búsqueda de empleos destacados está definida como false).

Request.pageSize

Para obtener el mejor rendimiento y evitar la latencia, configura la página de resultados para que muestre 20 o menos trabajos a la vez. Consulta la página de resumen de la búsqueda para obtener más información sobre cómo implementar la paginación.

customAttributes

customAttributes te ofrece la flexibilidad de asignar valores adicionales a tus trabajos en función de las necesidades de tu empresa (por ejemplo, las calificaciones) 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 empleo en lugar de las coordenadas GPS en el campo address, la Búsqueda de empleo podrá mejorar la detección de la ubicación y la relevancia de la búsqueda.

locationFilter

Usa el campo regionCode si una empresa tiene varias ofertas de empleo en diferentes regiones geográficas. Al asignar un regionCode a cada ficha, se asegura de que una consulta de búsqueda devuelva solo los empleos de la ubicación deseada por el candidato, en lugar de resultados globales que coincidan con la consulta de búsqueda. Por ejemplo, si se busca la palabra clave de ubicación "Cambridge" sin el símbolo regionCode, se devuelven resultados de Cambridge (Reino Unido) y Cambridge (Massachusetts, EE. UU.). Esto reduce la relevancia de la búsqueda.

Por ejemplo, si una ficha está a nivel de ciudad y calle, y otra a nivel de estado, ninguna de ellas aparecerá en las búsquedas localizadas que coincidan con ambas fichas.

regionCode y languageCode

Estos dos campos permiten que la búsqueda de empleo use una lógica de búsqueda localizada en diferentes regiones geográficas (por ejemplo, "camionero" en en_GB en lugar de "conductor de camión" en Estados Unidos). Define request.filters.locationFilters.regionCode para que coincida con la ubicación geográfica que está buscando el usuario (por ejemplo, el Reino Unido) y request.filters.languageCode con el código de idioma adecuado para esa región (en_GB en este caso).

queryLanguageCode

Te recomendamos que rellenes este campo siempre que sea posible. Este parámetro permite que la búsqueda de empleo gestione palabras inesperadas o poco comunes que, de lo contrario, podrían no aparecer correctamente en el idioma que elijas (como nombres de empresas).

distanceInMiles

Este parámetro define un radio (en millas) alrededor de la ubicación que indica el candidato. Búsqueda de empleo 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 o un código postal, la distancia distanceInMiles se calcula desde un único punto. Si el candidato introduce una ciudad, la Búsqueda de empleo 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 distanceInMiles.

Asegúrate de que el radio de distancia sea lo más pequeño posible. Si se establece un radio mayor, la búsqueda de empleo devolverá resultados que pueden estar fuera de la ubicación deseada por el candidato, lo que reducirá la relevancia. Por ejemplo, si buscas empleos en Nueva York con distanceInMiles configurado en 160 km, se mostrarán resultados de Nueva Jersey y del norte del estado de Nueva York. 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 permanece activa antes de que se retire de los resultados de búsqueda. De forma predeterminada, CTS elimina los trabajos 30 días después de la hora de creación (hora UTC).

employmentTypes

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

Configuraciones de búsqueda de empleo: clasificación personalizada

La búsqueda de empleo destacada te permite influir en los resultados de búsqueda de un usuario destacando empleos en función de una sola variable (promotionValue). Consulta la documentación sobre la búsqueda de empleo destacada para obtener más información. La clasificación personalizada te permite influir en los resultados de búsqueda en función de varias variables, lo que te ofrece un control más detallado sobre las clasificaciones. Esta función es útil en 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 sobre cómo se clasifican los trabajos por encima de la puntuación de relevancia original se basa en dos variables: rankingExpression y importanceLevel. Consulta nuestro videotutorial para obtener más información sobre cómo usar los trabajos destacados y la clasificación personalizada.

• rankingExpression: esta variable controla cómo se clasifican los trabajos en función de las puntuaciones de relevancia calculadas. "rankingExpression" debe tener el valor "filterable" para que la búsqueda de empleo 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 los resultados de búsqueda. Hay seis niveles posibles: 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 muestran en la parte superior de la consulta del candidato en lugar de los empleos más relevantes.

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

Búsqueda por ruta de desplazamiento

La búsqueda por ruta de desplazamiento permite a los candidatos buscar empleos en función del tiempo de desplazamiento. Para habilitarlo, incluye un objeto CommuteFilter en el campo JobQuery.commuteFilter. La CommuteFilter calcula el tiempo de desplazamiento usando el método de desplazamiento, la duración del trayecto y las coordenadas de inicio que indica el candidato. Los candidatos también deben seleccionar roadTraffic (TRAFFIC_FREE o BUSY_HOUR) o departureTime para incluirlo en el cálculo del tiempo. Para obtener más información, consulta las páginas sobre la implementación y los procedimientos de la búsqueda de trayectos.

Los resultados de búsqueda de trayectos se basan en datos históricos y agregados, no en el estado del tráfico en tiempo real. El estado del tráfico departureTime se calcula a partir de las condiciones medias del tráfico a la hora especificada. Las opciones BUSY_HOUR/TRAFFIC_FREE de roadTraffic representan las condiciones del tráfico medio durante la hora punta de la mañana y la medianoche, respectivamente. Los usuarios reciben los mismos resultados de búsqueda de trayectos al trabajo independientemente de la hora del día en que envíen una consulta.

Multitenancy (opcional)

Búsqueda de empleo admite inquilinos como capa organizativa intermedia entre un Google Cloud proyecto y los datos que se suban a él. Los inquilinos impiden que los datos se compartan entre barreras de arrendamiento, lo que te permite aislar subconjuntos de tus datos sin necesidad de tener varios proyectos. El multitenancy es útil en situaciones en las que tienes varios clientes y no quieres compartir datos entre ellos, pero quieres mantener un soloGoogle Cloud proyecto para la facturación y los informes internos. Por ejemplo:

• Proveedores de sitios de empleo que crean sitios de empleo para organizaciones con varias filiales.
• Agencias de contratación que crean sistemas de seguimiento de candidatos para varias empresas.

A cada proyecto se le asigna un único ID de arrendatario predeterminado. Puedes implementar la arquitectura multiempresa creando más de un arrendatario en un proyecto determinado.

Los arrendatarios están completamente aislados entre sí. Todas las APIs solicitan un solo arrendatario para evitar que se consulten datos de varios arrendatarios en la misma llamada a la API. Del mismo modo, los algoritmos de aprendizaje automático tratan a los arrendatarios como unidades independientes y no cruzan las barreras de arrendamiento. Un proyecto puede admitir tantos inquilinos como sea necesario.

Seguridad

CTS ofrece una asistencia muy básica para los inquilinos. Eres responsable de crear los arrendatarios, asignar los IDs de arrendatario y proporcionar el ID de arrendatario correcto al hacer una solicitud. CTS verifica que el ID de arrendatario pertenece a un proyecto determinado y obtiene datos del arrendatario proporcionado. Cualquier medida de seguridad adicional para detectar accesos no autorizados debe gestionarse en tu sistema backend.

Gestión de datos y control de errores

Integridad de datos

1. Subida de empleos: los problemas con los datos pueden impedir que los empleos se suban a la búsqueda de empleo. Consulta la página Códigos de respuesta HTTP para ver una lista de códigos de error. Estos son algunos ejemplos:

   • Las ubicaciones de empleo son incorrectas, por lo que no se puede resolver la solicitud.
   • Los campos de empresa o de puesto no existen, por lo que se devuelve una solicitud incorrecta.

   Hay tres opciones principales para solucionar problemas al subir trabajos:

   • Consulta los registros de tu backend.
   • Consulta la herramienta de gestión del paquete de pruebas de compatibilidad (CTS) para obtener información sobre el registro de datos.
   • Configura la herramienta Stackdriver Monitoring en Cloud Console para recoger datos sobre métricas, eventos y metadatos.

2. Indexación de empleos: la Búsqueda de empleo se ha diseñado para indexar todos los empleos que subas en un periodo determinado. Sin embargo, es posible que tengas restricciones de cuota. Antes de enviar trabajos a CTS, asegúrate de que tu sistema no tenga restricciones en las solicitudes de indexación.

Ataques DDoS autoinfligidos

Gestión de errores

Los servicios de API proporcionados a través de Internet pueden sufrir fallos de conexión intermitentes, interrupciones prolongadas, mantenimiento repentino del servicio y otros eventos que requieren que una aplicación cliente vuelva a intentar la solicitud de API. Asegúrate de diseñar el reintento con un comportamiento compatible con la red, por ejemplo, tiempo de espera exponencial.

Límites de cuota

Evita enviar un volumen de tráfico superior a la cuota aprovisionada, sobre todo si es mucho mayor. De lo contrario, es posible que se clasifique como malicioso y, por lo tanto, se bloquee.

Eliminación de duplicados

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

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

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

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