Parametri di ricerca lavoro: best practice (v4beta1)

Configurazioni di Ricerca lavoro

Questa sezione descrive i parametri che possono essere utilizzati per configurare l'API Job Search. Per ulteriori informazioni, guarda il nostro tutorial video.

Fattori che influiscono sui risultati di ricerca

Insieme, "Ricerca lavoro in primo piano", "Consenti ampliamento" e "Disattiva corrispondenza parola chiave" hanno un impatto significativo sul numero e sulla pertinenza dei lavori restituiti alla persona in cerca di lavoro. La configurazione più appropriata di questi tre fattori dipende dalle esigenze della tua attività. Il metodo migliore per determinare la configurazione ottimale è applicare scenari di test diversi e valutare i risultati durante una fase di test. Per ulteriori informazioni sull'utilizzo di questi parametri, consulta la pagina dei tutorial video.

  1. Ricerca lavoro in primo piano: utilizza le ricerche di lavoro in primo piano per assegnare valori promozionali a singole offerte di lavoro. In questo modo puoi mettere in evidenza le posizioni importanti per le tue esigenze aziendali. Consulta la documentazione sulla ricerca job in primo piano per conoscere le best practice e i dettagli di implementazione.

  2. disableKeywordMatch: questo parametro consente a Ricerca lavoro di restituire corrispondenze basate su parole chiave alla query di una persona in cerca di impiego, oltre a corrispondenze pertinenti. L'impostazione predefinita è false. Se questo parametro viene impostato su true, la corrispondenza delle parole chiave viene disabilitata e vengono restituiti meno job (solo quelli ritenuti pertinenti dalla funzionalità ML).

  3. enableBroadening: utilizza questo parametro per espandere la query della persona in cerca di lavoro allentando le limitazioni dichiarate sulle categorie di località e prestazioni. L'impostazione predefinita è false. L'attivazione di questo parametro aumenta il numero di risultati di ricerca restituiti, ma può diminuire la pertinenza dei risultati complessivi impostati per la persona in cerca di lavoro.

Risultati della configurazione di ricerca

Per restituire solo le offerte di lavoro più pertinenti: imposta disableKeywordMatch su true e enableBroadening su false. Ciò migliora le metriche sulle prestazioni relative alla pertinenza dell'API, poiché vengono restituiti solo i job pertinenti. Tuttavia, nei risultati di ricerca vengono restituiti meno job in totale.

Per restituire un numero maggiore di offerte di lavoro, inclusi i risultati pertinenti e con corrispondenza delle parole chiave: imposta disableKeywordMatch su false e enableBroadening su false. I risultati con corrispondenze con le parole chiave vengono elencati dopo i job pertinenti. I risultati dell'espansione della query non vengono restituiti.

Per restituire un numero maggiore di job, inclusi i job pertinenti e espansi delle query: imposta disableKeywordMatch su true e enableBroadening su true. La query di chi cerca lavoro viene espansa in modo da includere categorie di prestazioni correlate e località nelle vicinanze. Questi job aggiuntivi vengono elencati dopo i risultati pertinenti. Le corrispondenze basate sulle parole chiave non vengono restituite.

Per restituire il numero massimo possibile di job: imposta disableKeywordMatch su false e enableBroadening su true. Ricerca lavoro restituisce i job più pertinenti nella parte superiore dei risultati di ricerca, seguiti dai job corrispondenti alle parole chiave e dai job espansi nelle query (per località, categoria di prestazione e così via). Questo massimizza il numero totale di job restituiti.

diasableKeywordMatch enableBroadening Risultato
- - Restituisce un numero più elevato di offerte di lavoro, inclusi i risultati pertinenti e con corrispondenza alle parole chiave, ma supponiamo che la ricerca lavoro in primo piano sia impostata su false.
+ + Restituisce un numero maggiore di offerte di lavoro, inclusi i job pertinenti e quelli espansi con query (ma supponiamo che la ricerca di offerte di lavoro in primo piano sia impostata su false).
- + Restituisce il numero più alto di offerte di lavoro (ma supponiamo che la ricerca lavoro in primo piano sia impostata su false).
+ - Restituisce solo le offerte di lavoro più pertinenti, ma supponiamo che la ricerca di lavoro in primo piano sia impostata su false.

Request.page_size

Per ottenere prestazioni ottimali ed evitare la latenza, configura la pagina dei risultati in modo che mostri un massimo di 20 job alla volta. Consulta la pagina di panoramica della ricerca per ulteriori informazioni sull'implementazione dell'impaginazione.

customAttributes

customAttributes ti offre la flessibilità di assegnare valori aggiuntivi ai tuoi job in base alle tue esigenze aziendali (ad esempio, i punteggi GPA) e di utilizzare questi valori per filtrare i risultati.

Campo Località

Una panoramica dettagliata del campo location è disponibile nella pagina dei campi località. Specificare l'indirizzo del lavoro anziché le coordinate GPS nel campo address consente a Ricerca lavoro di migliorare il rilevamento della posizione e la pertinenza della ricerca.

locationFilter

Utilizza il campo regionCode se una singola azienda ha più offerte di lavoro in regioni geografiche diverse. L'assegnazione di un regionCode a ogni elenco garantisce che una query di ricerca restituisca solo i job nella località desiderata, anziché i risultati globali corrispondenti alla query di ricerca. Ad esempio, una ricerca per la parola chiave della località "Cambridge" senza regionCode restituisce risultati sia da Cambridge, UK, sia da Cambridge, MA, USA. Questo diminuisce la pertinenza nella ricerca.

region_code e language_code

Questi due campi consentono a Ricerca lavoro di utilizzare la logica di ricerca localizzata in diverse aree geografiche (ad esempio, "camionista" in en_GB anziché "camionista" negli Stati Uniti). Imposta request.filters.location_filters.region_code in modo che corrisponda alla località geografica cercata dall'utente (ad esempio, il Regno regno) e request.filters.language_code con il codice lingua appropriato per quella regione (in questo caso en_GB).

radiusinMiles

Questo parametro imposta un raggio (in miglia) intorno alla località indicata da chi cerca un impiego. Ricerca lavoro restituisce risultati all'interno di questo intervallo geografico. Il modo in cui questa distanza viene applicata all'area geografica dei risultati di ricerca dipende dal tipo di informazioni sulla località inserite. Se la persona in cerca di lavoro inserisce un indirizzo, la distanza radiusInMiles viene impostata a partire da un singolo punto. Se la persona in cerca di lavoro inserisce una città, Ricerca lavoro applica un riquadro di delimitazione intorno ai limiti della città e calcola la distanza dai bordi del riquadro. Se l'utente inserisce solo uno stato o un paese, radiusInMiles viene ignorato.

Assicurarsi che il raggio del chilometraggio sia il più ridotto possibile. L'impostazione del chilometraggio su un intervallo più ampio fa sì che Ricerca lavoro restituisca risultati che potrebbero essere al di fuori della località desiderata da chi cerca il lavoro, diminuendo la pertinenza. Ad esempio, la ricerca di offerte di lavoro a New York City con il valore radiusInMiles impostato su 100 miglia restituisce risultati sia nel New Jersey che nella zona Upstate New York. Limitare il più possibile il raggio d'azione aumenta la pertinenza dei risultati.

postingExpireTime

Questo parametro consente di impostare il periodo di tempo in cui l'offerta di lavoro rimane attiva prima di essere rimossa dai risultati di ricerca. Per impostazione predefinita, il CTS rimuove i job 30 giorni dopo l'ora di creazione (ora UTC).

Job_employment_type

Questo non è un campo obbligatorio, ma l'utilizzo di job_employment_type aumenta la pertinenza dei risultati di ricerca.

Configurazioni della ricerca lavoro: ranking personalizzato

La ricerca offerte di lavoro in primo piano ti consente di influenzare i risultati di ricerca di un utente evidenziando le offerte di lavoro in base a una singola variabile (promotionValue). Per informazioni dettagliate, consulta la documentazione sulla ricerca lavoro in primo piano. Il ranking personalizzato ti consente di influenzare i risultati di ricerca in base a più variabili, offrendo un controllo più granulare sui ranking. Questa funzione è utile in applicazioni che richiedono il bilanciamento tra pertinenza e interessi economici, come ad esempio un sistema di abbonati costo per clic (CPC) a più livelli. L'influenza sul ranking delle offerte di lavoro in base al punteggio di pertinenza originale si basa su due variabili: rankingExpression e importanceLevel. Guarda il nostro tutorial video per ulteriori informazioni sull'utilizzo di offerte di lavoro in primo piano e ranking personalizzato.

  • rankingExpression: questa variabile controlla in che modo le offerte di lavoro vengono classificate in base ai relativi punteggi di pertinenza calcolati. "rankingExpression" deve essere impostato su "filterable" affinché Ricerca job possa indicizzare il parametro.

  • importanceLevel: questo parametro imposta il livello di importanza della posizione di ranking di un job quando viene restituito nei risultati di ricerca. Esistono sei livelli possibili: Non specificato, NONE, LOW, MID, HIGH e EXTREME. L'impostazione del valore su EXTREME fa sì che tutti gli altri fattori di pertinenza generati dall'API vengano ignorati, quindi utilizza questo valore con parsimonia. I job impostati su EXTREME vengono restituiti in cima alla query di chi cerca l'impiego anziché i job più pertinenti.

  • Ricerca di lavoro in primo piano e ranking personalizzato: una ricerca di lavoro in primo piano è utile soprattutto per promuovere una singola categoria di offerte di lavoro al di sopra del ranking della pertinenza, ad esempio offerte di lavoro in una determinata azienda. Se devi classificare le offerte di lavoro in base a variabili CPC (costo per clic) multilivello oltre al ranking di pertinenza, il ranking personalizzato è una scelta migliore.

La ricerca basata sul tragitto giornaliero consente a chi cerca lavoro di cercare offerte di lavoro in base ai tempi di percorrenza del tragitto giornaliero. Per abilitarlo, includi un oggetto CommuteFilter nel campo JobQuery.commuteFilter. L'CommuteFilter calcola il tempo di percorrenza del tragitto giornaliero utilizzando il metodo di lavoro indicato da chi cerca un lavoro, la durata del viaggio e le coordinate di partenza. Chi cerca un lavoro deve anche selezionare roadTraffic (TRAFFIC_FREE o BUSY_HOUR) oppure departureTime da includere nel calcolo del tempo. Consulta le pagine sull'implementazione e sulle istruzioni per il tragitto giornaliero sulla rete di ricerca.

I risultati di ricerca relativi al tragitto giornaliero si basano su dati storici e aggregati anziché sulle condizioni del traffico in tempo reale. Le condizioni del traffico in departureTime vengono calcolate in base alle condizioni medie del traffico all'ora del giorno specificata. Le opzioni BUSY_HOUR/TRAFFIC_FREE in roadTraffic corrispondono alle condizioni di traffico medie rispettivamente all'ora di punta della mattina e a mezzanotte. Gli utenti ricevono gli stessi risultati di ricerca relativi al tragitto giornaliero a prescindere dall'ora del giorno in cui inviano una query.

Multitenancy (facoltativo)

Job Search supporta i tenant come livello organizzativo intermedio tra un progetto Google Cloud e qualsiasi dato caricato al suo interno. I tenant impediscono la condivisione dei dati oltre le barriere di tenancy, consentendoti di isolare sottoinsiemi di dati senza la necessità di più progetti. L'architettura multi-tenancy è utile in situazioni in cui hai più clienti e non vuoi condividere dati tra loro, ma vorresti mantenere un singolo progetto Google Cloud per la fatturazione e il reporting interni. Ad esempio:

  • Fornitori di siti di lavoro che creano siti per le organizzazioni con più società controllate.
  • Agenzie che si occupano della creazione di sistemi di monitoraggio dei candidati per più attività.

A ogni progetto viene assegnato un singolo ID tenant predefinito. È possibile implementare l'architettura multi-tenancy creando più di un tenant all'interno di un determinato progetto.

Gli inquilini sono completamente isolati l'uno dall'altro. Tutte le API richiedono un solo tenant per impedire l'esecuzione di query sui dati in più tenant nella stessa chiamata API. Allo stesso modo, gli algoritmi di machine learning considerano i tenant come unità discrete e non attraversano barriere di cross-tenancy. Un progetto può supportare tutti i tenant necessari.

Sicurezza

CTS offre un supporto molto leggero. Sei responsabile della creazione dei tenant, dell'assegnazione degli ID tenant e della fornitura dell'ID tenant corretto quando effettui una richiesta. Il CTS verifica che l'ID tenant sia di proprietà di un determinato progetto e recupera i dati dal tenant fornito. Eventuali misure di sicurezza aggiuntive per rilevare gli accessi non autorizzati devono essere gestite nel sistema di backend.

Gestione dei dati e gestione degli errori

Integrità dei dati

  1. Caricamento dei job: i problemi relativi ai dati possono impedire il caricamento dei job in Ricerca job. Consulta la pagina Codici di risposta HTTP per un elenco dei codici di errore. Ecco alcuni esempi comuni:

    • Le località del job non sono corrette, pertanto la richiesta non può essere risolta.
    • I campi Azienda o Lavoro non esistono, pertanto viene restituita una richiesta errata.

    Esistono tre opzioni principali per la risoluzione dei problemi di caricamento dei job:

  2. Job di indicizzazione: Ricerca lavoro è progettata per indicizzare tutti i job caricati entro un determinato periodo di tempo. Tuttavia, potresti avere dei limiti di quota. Prima di inviare job a CTS, assicurati di controllare la presenza di restrizioni sulle richieste di indicizzazione nel sistema.

Attacchi DDoS autoinflitti

Gestione degli errori

I servizi API forniti su internet possono avere un errore di connessione intermittente, un'interruzione prolungata, una manutenzione improvvisa del servizio e altri eventi che richiedono a un'applicazione client di riprovare a eseguire la richiesta API. Assicurati di progettare la ripetizione con un comportamento ottimizzato per la rete, ad esempio con un backoff esponenziale.

Limiti di quota

Evita di inviare traffico superiore alla quota di cui hai eseguito il provisioning, in particolare molto superiore rispetto alla quota di cui è stato eseguito il provisioning. In caso contrario, il tuo traffico potrebbe essere classificato come dannoso e quindi bloccato.

Deduplicazione

I lavori duplicati influiscono negativamente sull'esperienza di ricerca di chi cerca un impiego. Ricerca lavoro include due funzionalità per ridurre al minimo i duplicati:

  1. Crea job: se provi a creare più di due job con i seguenti criteri, il record viene rifiutato e viene restituito un errore 4xx:

    • stessa companyName E
    • stessa job_req_id E
    • stessa località/languageCode

  2. Cerca offerte di lavoro: Ricerca lavoro mostra le offerte di lavoro pertinenti alla query di ricerca di chi cerca lavoro. Una funzionalità integrata dell'algoritmo di pertinenza assicura che tutti i job restituiti siano diversificati, impedendo la visualizzazione di job quasi identici uno accanto all'altro nei risultati di ricerca.