Parámetros de búsqueda de trabajo: Prácticas recomendadas

Parámetros de configuración de búsqueda de Trabajo

En esta sección, se describen los parámetros que se pueden usar para configurar la API de búsqueda de trabajo. Para obtener más información, consulta nuestro video instructivo.

Factores que afectan los resultados de la búsqueda

Juntos, “Búsqueda de trabajo destacada”, “Habilitar ampliación” y “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. Consulta nuestra página de videos instructivos para obtener más información sobre el uso de estos parámetros.

Búsqueda de trabajo destacada: Usa las búsquedas de trabajo destacadas para asignar valores promocionales a trabajos individuales. Esto le permite destacar trabajos que son importantes para las necesidades de tu empresa. Consulte la documentación de búsqueda de trabajo destacada para conocer las prácticas recomendadas y los detalles de implementación.
disableKeywordMatch: Este parámetro permite que la búsqueda de trabajo muestre coincidencias basadas en palabras clave a la consulta de un usuario, además de las coincidencias relevantes. La configuración predeterminada es false. 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 característica de AA considera relevantes).
enableBroadening: Usa este parámetro para expandir la consulta del usuario mediante la disminución de la rigurosidad sus restricciones establecidas en la ubicación y las categorías de trabajo. La configuración predeterminada es false. Habilitar este parámetro aumenta la cantidad de resultados de búsqueda que se muestran, pero puede disminuir la relevancia del conjunto de resultados generales para el usuario.

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 relacionadas con la relevancia de la API, ya que solo se muestran los 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 concordancia de palabras clave se enumeran después de los trabajos relevantes en los resultados. Los resultados de la búsqueda expandida no se muestran.

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. Estos trabajos adicionales se enumeran después de los resultados relevantes. Las coincidencias basadas en palabras clave no se muestran.

Para mostrar la mayor cantidad posible de trabajos: Establece disableKeywordMatch en false y enableBroadening en true. La búsqueda de empleo muestra los trabajos más relevantes en la parte superior de los resultados de la búsqueda, seguidos de trabajos concordantes con palabras clave y trabajos de 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 mayor cantidad de trabajos, que incluyen los resultados relevantes y los de concordancia de palabras clave (pero supongamos que la búsqueda de empleo destacada se establece en `false`).
+	+	Muestra una mayor cantidad de trabajos, que incluyen los trabajos relevantes y de búsqueda expandida (pero supongamos que la búsqueda de trabajos destacados está establecida en `false`).
-	+	Muestra la mayor cantidad de trabajos (pero supongamos que la búsqueda de trabajo destacada se establece en `false`).
+	-	Muestra solo los trabajos más relevantes (pero supongamos que la búsqueda de trabajo destacada se establece en `false`).

`Request.pageSize`

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

`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 location en la página campos de ubicación. Proporcionar la dirección de la calle del trabajo en lugar de las coordenadas GPS en el campo address ayuda a la búsqueda de trabajo a mejorar la detección de ubicación y la relevancia de la búsqueda.

`locationFilter`

Usa el campo regionCode si una sola compañía tiene ofertas de trabajo en diferentes regiones geográficas. Asignar un regionCode a cada ficha asegura que una búsqueda muestre trabajos solo en la ubicación deseada del usuario en lugar de resultados globales que coincidan con la consulta de la búsqueda. Por ejemplo, una búsqueda en la palabra clave de la ubicación “Cambridge” sin un regionCode en su lugar muestra resultados de Cambridge, Reino Unido y Cambridge, MA, EE.UU. Esto disminuye la relevancia de la búsqueda.

Si, por ejemplo, una ficha es a nivel de ciudad y calle y otra a nivel de estado, no se mostrará ninguna de estas fichas en las búsquedas localizadas que coincidan con ambas fichas.

`regionCode` y `languageCode`

Estos dos campos permiten que la Búsqueda de trabajo use la lógica de búsqueda localizada en diferentes regiones geográficas (por ejemplo, “conductor de camión” en en_GB en lugar de “chófer de camión” en los Estados Unidos). Configura request.filters.locationFilters.regionCode para que coincida con la ubicación geográfica que busca el usuario (como el Reino Unido) y request.filters.languageCode con el código de idioma apropiado para esa región (en_GB en este caso).

`queryLanguageCode`

Te recomendamos que propagues este campo siempre que sea posible. Este parámetro permite que Job Search maneje palabras inesperadas o raras que podrían no aparecer correctamente en el idioma deseado (como nombres de empresas).

`distanceInMiles`

Este parámetro establece un radio (en kilómetros) alrededor de la ubicación que indicó un usuario. La búsqueda de trabajo muestra los 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 o un código postal, la distancia distanciaInMiles se establece desde un solo punto. Si el usuario ingresa una ciudad, Job Search aplica un cuadro delimitador 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 distanceInMiles.

Asegúrate de que el radio de kilometraje sea lo más pequeño posible. Establecer el kilometraje en un rango mayor hace que la búsqueda de trabajo muestre resultados que pueden estar fuera de la ubicación deseada del usuario, y disminuir la relevancia. Por ejemplo, buscar trabajos en la ciudad de Nueva York con distanceInMiles configurado en 100 kilómetros muestra resultados en Nueva Jersey y el norte del estado de Nueva York. 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 de trabajo permanece activa antes de que se quite de los resultados de la búsqueda. De forma predeterminada, CTS quita los trabajos 30 días después de la hora de creación (hora UTC).

`employmentTypes`

Este no es un campo obligatorio, sin embargo, usar employmentTypes aumenta la relevancia de los resultados de la búsqueda.

Parámetros de configuración de búsqueda de trabajo: clasificación personalizada

La búsqueda de trabajo destacada te permite influir en los resultados de búsqueda de un usuario si destacas los trabajos basados en una sola variable (promotionValue). Consulta la documentación de búsqueda de empleo destacada para obtener más detalles. Clasificación personalizada te permite influir en los resultados de búsqueda basados en múltiples variables y ofrecer un control más detallado sobre las clasificaciones. 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. La influencia sobre cómo se clasifican los trabajos en la parte superior del puntuación de relevancia original se basa en dos variables: rankingExpression y importanceLevel. Consulta nuestro video instructivo para obtener más información sobre el uso de trabajos destacados y la clasificación personalizada.

rankingExpression: Esta variable controla cómo se clasifican los trabajos según los puntajes de relevancia calculados. “rankingExpression” debe establecerse en “filtrable” para que la búsqueda de trabajo pueda indexar 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 los resultados de búsqueda. Existen seis niveles posibles: Sin especificar, NONE, LOW, MID, HIGH y EXTREME. Establecer el valor en EXTREME hará que todos los demás factores de relevancia generados por la API se ignoren, así que usa este valor con moderación. Los trabajos configurados en EXTREME se muestran en la parte superior de la consulta del buscador de trabajo en lugar de los trabajos más relevantes.
Búsqueda de trabajos destacados en comparación con la clasificación personalizada: La búsqueda de trabajo destacada es más útil para promover una categoría única de trabajos por encima de la clasificación de relevancia, por ejemplo, trabajos en una determinada empresa. Si necesita 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.

Búsqueda por viaje cotidiano

LaBúsqueda de trayecto diario permite a los usuarios buscar trabajos en función del tiempo de viaje. Para habilitarlo, incluye un objeto CommuteFilter en el campo JobQuery.commuteFilter. El CommuteFilter calcula el trayecto diario mediante el método de trayecto diario del usuario, la duración del viaje y las coordenadas de inicio. Los usuarios también deben seleccionar roadTraffic (TRAFFIC_FREE o BUSY_HOUR) o departureTime para incluir en el cálculo del tiempo. Consulta las páginas de implementación de búsqueda por trayecto diario y el instructivo para obtener más información.

Los resultados de la búsqueda por trayecto diario se basan en datos históricos y agregados en lugar de condiciones de tráfico en vivo. Las condiciones de tráfico departureTime se calculan a partir de las condiciones de tráfico promedio a la hora especificada del día. Las opciones BUSY_HOUR y TRAFFIC_FREE en roadTraffic son condiciones de tráfico promedio en la hora pico de la mañana y en la medianoche, de forma respectiva. Los usuarios reciben los mismos resultados de búsqueda de viaje sin importar a qué hora del día envíen una consulta.

Multiusuario (opcional)

Job Search admite usuarios como una capa organizativa intermedia entre un proyecto de Google Cloud y cualquier dato que se suba a él. Los usuarios evitan que los datos se compartan a través de los límites de los usuarios, lo que te permite aislar subconjuntos de sus datos sin la necesidad de múltiples proyectos. La función multiusuario es útil en situaciones en las que tienes varios clientes y no deseas compartir datos entre ellos, pero te gustaría mantener un solo proyecto de Google Cloud para la facturación y los informes internos. Por ejemplo:

Proveedores de sitios de trabajo que compilan estos sitios para organizaciones con varias empresas subsidiarias.
Agencias de contratación que compilan sistemas de seguimiento de candidatos para varias empresas.

A cada proyecto se le asigna un único ID de usuario predeterminado. Puedes implementar el multiusuario cuando creas más de un usuario dentro de un proyecto determinado.

Los usuarios están completamente aislados unos de otros. Todas las API solicitan un solo usuario para evitar que se consulten los datos entre varios usuarios en la misma llamada a la API. Los algoritmos de aprendizaje automático tratan de forma similar a los usuarios como unidades discretas y no cruzan los límites de los usuarios. Un proyecto puede admitir tantos usuarios como sea necesario.

Seguridad

CTS proporciona un soporte de usuario muy ligero. Eres responsable de crear usuarios, asignar ID de usuarios y proporcionar el ID de usuario correcto cuando realizas una solicitud. CTS verifica que la identificación del usuario sea propiedad de un proyecto determinado y recupere los datos del usuario que se proporcionó. Cualquier seguridad adicional para detectar el acceso no autorizado se debe administrar en tu sistema de backend.

Administración de datos y manejo de errores

Integridad de los datos

Sube trabajos: Los problemas de datos pueden evitar que los trabajos se suban a la búsqueda de trabajos. Consulta la página Códigos de respuesta HTTP para obtener una lista de códigos de error. A continuación, se muestran 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, por lo que se muestra una solicitud incorrecta.
Existen tres opciones principales para solucionar problemas de carga de trabajos:
- Verifica el registro desde tu backend.
- Verifica la herramienta de administración de CTS para el registro de datos.
- Configura la Herramienta de Stackdriver Monitoring en la consola de Cloud para recopilar datos sobre métricas, eventos y metadatos.
Indexa trabajos: La búsqueda de trabajo se diseñó para indexar todos los trabajos que se cargaron dentro de un período establecido. 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.

Ataques DSD autoinfligidos

Manejo de errores

Los servicios de API proporcionados a través de Internet pueden tener fallas de conexión intermitentes, una interrupción prolongada, mantenimiento de servicio repentino y otros eventos que requieren que una aplicación cliente vuelva a intentar la solicitud a la API. Asegúrate de diseñar el reintento con un comportamiento intuitivo de la red, por ejemplo, retroceso exponencial.

Límites de cuota

Evita enviar tráfico más alto que tu cuota aprovisionada, en especial más alta que tu cuota aprovisionada. De lo contrario, tu tráfico puede clasificarse como malicioso y, por lo tanto, se bloquea.

Anulación de duplicados

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

Crear trabajos: Si intentas crear más de 2 trabajos con los siguientes criterios, el registro se rechaza y se muestra un error 4xx:
- mismo companyName, Y
- mismo job_req_id, Y
- misma ubicación/languageCode
Buscar trabajos: La búsqueda de trabajo 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.