Parametri di Job Search: best practice

Configurazioni di Ricerca di lavoro

Questa sezione illustra i parametri che possono essere utilizzati per configurare l'API Job Search. Per saperne di più, guarda il nostro video tutorial.

Fattori che influiscono sui risultati di ricerca

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

1. Ricerca di lavoro in primo piano: utilizza le ricerche di lavoro in primo piano per assegnare valori promozionali ai singoli annunci di lavoro. In questo modo, puoi evidenziare i job importanti per le esigenze della tua attività. Consulta la documentazione relativa alla ricerca di annunci in primo piano per informazioni sulle best practice e sui dettagli di implementazione.

2. disableKeywordMatch: Questo parametro consente a Ricerca di lavoro di restituire corrispondenze basate sulle parole chiave alla query di un candidato oltre alle corrispondenze pertinenti. L'impostazione predefinita è false. Se imposti questo parametro su true, la corrispondenza delle parole chiave viene disattivata, pertanto vengono restituiti meno job (solo quelli ritenuti pertinenti dalla funzionalità ML).

3. enableBroadening: utilizza questo parametro per espandere la query del candidato allentando le limitazioni dichiarate per località e categorie di lavoro. L'impostazione predefinita è false. L'attivazione di questo parametro aumenta il numero di risultati di ricerca retitrati, ma potrebbe ridurre la pertinenza del set di risultati complessivi per il candidato.

Risultati della configurazione di ricerca

Per restituire solo i job più pertinenti: imposta disableKeywordMatch su true e enableBroadening su false. In questo modo vengono migliorate le metriche sul rendimento legate alla pertinenza dell'API, poiché vengono restituiti solo i job pertinenti. Tuttavia, nel complesso vengono restituiti meno annunci nei risultati di ricerca.

Per restituire un numero maggiore di job, inclusi sia i risultati pertinenti sia quelli corrispondenti alle parole chiave: Imposta disableKeywordMatch su false e enableBroadening su false. I risultati corrispondenti alle parole chiave sono elencati dopo i job pertinenti nei risultati. I risultati dell'espansione della query non vengono restituiti.

Per restituire un numero maggiore di job, inclusi quelli pertinenti e quelli con query espansa: imposta disableKeywordMatch su true e enableBroadening su true. La query del candidato viene espansa per includere categorie di lavoro correlate e località nelle vicinanze. Questi job aggiuntivi sono elencati dopo i risultati pertinenti. Le corrispondenze basate sulle parole chiave non vengono restituite.

Per restituire il maggior numero possibile di job: imposta disableKeywordMatch su false e enableBroadening su true. La ricerca di lavoro restituisce le offerte di lavoro più pertinenti nella parte superiore dei risultati di ricerca, seguite dalle offerte corrispondenti alle parole chiave e dalle offerte ampliate per query (per località, categoria di lavoro e così via). In questo modo viene massimizzato il numero totale di job restituiti.

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

Request.pageSize

Per ottenere le migliori prestazioni ed evitare la latenza, configura la pagina dei risultati in modo da visualizzare al massimo 20 job alla volta. Per ulteriori informazioni sull'implementazione della paginazione, consulta la pagina Panoramica della ricerca.

customAttributes

customAttributes ti offre la flessibilità di assegnare valori aggiuntivi ai lavori in base alle esigenze della tua attività (ad es. i voti di rendimento accademico) e di utilizzare questi valori per filtrare i risultati.

Nota: evita di impostare valori customAttributes correlati alla località. Il filtro dei risultati per località esistente di Ricerca di lavoro ha un algoritmo integrato che consente di rilevare automaticamente le informazioni sulla località relative alla query di ricerca della persona in cerca di lavoro.

Campo Posizione

Una panoramica dettagliata del campo location è disponibile nella pagina Campi posizione. Fornendo l'indirizzo dell'offerta di lavoro anziché le coordinate GPS nel campo address la Ricerca di lavoro può 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 diverse regioni geografiche. L'assegnazione di un regionCode a ogni scheda garantisce che una query di ricerca restituisca offerte di lavoro solo nella località desiderata dal candidato, anziché risultati globali corrispondenti alla query di ricerca. Ad esempio, una ricerca sulla parola chiave posizione "Cambridge" senza un regionCode restituisce risultati sia da Cambridge, nel Regno Unito, sia da Cambridge, nel Massachusetts, negli Stati Uniti. Ciò riduce la pertinenza della ricerca.

Nota: le offerte di lavoro con più schede devono avere tutte le schede indirizzate allo stesso livello di località.

Ad esempio, se una scheda è a livello di città e strada e un'altra a livello di stato, nessuna delle due verrà visualizzata nelle ricerche localizzate che corrispondono a entrambe le schede.

regionCode e languageCode

Questi due campi consentono a Ricerca di lavoro di utilizzare la logica di ricerca localizzata in regioni geografiche diverse (ad esempio, "camionista" in en_GB rispetto a "camionista" negli Stati Uniti). Imposta request.filters.locationFilters.regionCode in modo che corrisponda alla posizione geografica cercata dall'utente (ad esempio il Regno Unito) e request.filters.languageCode al codice lingua appropriato per la regione (in questo caso en_GB).

queryLanguageCode

Ti consigliamo di compilare questo campo, se possibile. Questo parametro consente a Ricerca di lavoro di gestire parole inaspettate o rare che altrimenti potrebbero non essere visualizzate correttamente nella lingua desiderata (ad esempio i nomi delle aziende).

distanceInMiles

Questo parametro imposta un raggio (in miglia) intorno alla località indicata da chi cerca lavoro. La Ricerca di lavoro restituisce risultati all'interno di questo intervallo geografico. La modalità di applicazione di questa distanza alla geografia dei risultati di ricerca dipende dal tipo di informazioni sulla posizione inserite. Se il candidato inserisce un indirizzo o un codice postale, la distanza in miglia viene impostata da un singolo punto. Se il candidato inserisce una città, Ricerca di lavoro applica un riquadro delimitante ai confini della città e calcola la distanza dai bordi del riquadro. Se l'utente inserisce solo uno stato o un paese, distanceInMiles viene ignorato.

Assicurati che il raggio di chilometri sia il più piccolo possibile. Se imposti la distanza su un intervallo più ampio, la Ricerca di lavoro restituisce risultati che potrebbero essere al di fuori della località desiderata da chi cerca lavoro, diminuendo la pertinenza. Ad esempio, la ricerca di offerte di lavoro a New York con distanceInMiles impostato su 100 miglia restituisce risultati sia nel New Jersey che nell'Upstate New York. Mantieni il raggio il più piccolo possibile per aumentare la pertinenza dei risultati.

postingExpireTime

Questo parametro imposta il periodo di tempo per cui l'annuncio di lavoro rimane attivo prima di essere rimosso dai risultati di ricerca. Per impostazione predefinita, CTSrimuove i job 30 giorni dopo la data e l'ora di creazione (ora UTC).

employmentTypes

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

Configurazioni di Ricerca di lavoro: ranking personalizzato

La ricerca di annunci di lavoro in primo piano ti consente di influenzare i risultati di ricerca di un utente mettendo in evidenza le offerte di lavoro in base a una singola variabile (promotionValue). Per maggiori dettagli, consulta la documentazione relativa alla ricerca di annunci di 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 funzionalità è utile nelle applicazioni che richiedono di bilanciare la pertinenza con gli interessi economici, ad esempio un sistema di abbonati basato sul costo per clic (CPC) a più livelli. L'influenza sul ranking delle offerte oltre al punteggio di pertinenza originale si basa su due variabili: rankingExpression e importanceLevel. Per saperne di più sull'utilizzo delle offerte in primo piano e del ranking personalizzato, consulta il nostro tutorial video.

• rankingExpression: questa variabile controlla il modo in cui i job vengono classificati in base ai relativi punteggi di pertinenza calcolati. "rankingExpression" deve essere impostato su 'filterable' affinché Ricerca di lavoro indicizzi il parametro.

• importanceLevel: questo parametro imposta il livello di importanza della posizione del ranking di un job quando viene restituito nei risultati di ricerca. Esistono sei possibili livelli: Non specificato, NONE, LOW, MID, HIGH e EXTREME. Se imposti il valore su EXTREME, tutti gli altri fattori di pertinenza generati dall'API vengono ignorati, quindi utilizza questo valore con parsimonia. I job impostati su EXTREME vengono riportati nella parte superiore della query di chi cerca lavoro anziché i job più pertinenti.

• Ricerca di annunci di lavoro in primo piano rispetto al ranking personalizzato: la ricerca di annunci di lavoro in primo piano è più utile per promuovere una singola categoria di annunci di lavoro al di sopra del ranking per pertinenza, ad esempio gli annunci di lavoro di una determinata azienda. Se devi classificare i job in base a variabili CPC (costo per clic) a più livelli, oltre al ranking per pertinenza, il ranking personalizzato è una scelta migliore.

Ricerca basata sul tragitto giornaliero

La ricerca basata sul tragitto giornaliero consente ai candidati di cercare offerte di lavoro in base al tempo di percorrenza. Per attivarla, includi un oggetto CommuteFilter nel campo JobQuery.commuteFilter. CommuteFilter calcola il tempo di percorrenza utilizzando il metodo di tragitto giornaliero, la durata del viaggio e le coordinate di partenza indicati da un candidato. I cercatori di lavoro devono anche selezionare roadTraffic (TRAFFIC_FREE o BUSY_HOUR) o departureTime da includere nel calcolo del tempo. Per maggiori dettagli, consulta le pagine relative all'implementazione e alle procedure di ricerca per i tragitti giornalieri.

I risultati di ricerca relativi ai percorsi giornalieri si basano su dati storici e aggregati anziché sulle condizioni del traffico in tempo reale. Le condizioni di traffico departureTime vengono calcolate in base alle condizioni di traffico medie all'ora specificata del giorno. Le opzioni BUSY_HOUR/TRAFFIC_FREE in roadTraffic corrispondono alle condizioni di traffico medio rispettivamente all'ora di punta mattutina e a mezzanotte. Gli utenti ricevono gli stessi risultati di ricerca per i tragitti giornalieri indipendentemente dall'ora del giorno in cui inviano una query.

Multitenancy (facoltativo)

Ricerca di lavoro supporta i tenant come livello organizzativo intermedio tra un Google Cloud progetto e tutti i dati caricati al suo interno. I tenant impediscono la condivisione dei dati tra i confini dei tenant, consentendoti di isolare sottoinsiemi di dati senza la necessità di più progetti. La multitenancy è utile in situazioni in cui hai più clienti e non vuoi condividere i dati tra loro, ma vuoi gestire un unico progetto per la fatturazione e i report interni.Google Cloud Ad esempio:

• Fornitori di siti di annunci di lavoro che creano siti di annunci di lavoro per organizzazioni con più società controllate.
• Agenzie di reclutamento che creano sistemi di monitoraggio dei candidati per più attività.

A ogni progetto viene assegnato un singolo ID tenant predefinito. Puoi implementare la multitenancy creando più di un tenant all'interno di un determinato progetto.

Gli utenti sono completamente isolati l'uno dall'altro. Tutte le API richiedono un solo tenant per impedire la query dei dati su più tenant nella stessa chiamata API. Analogamente, gli algoritmi di machine learning trattano gli utenti come unità discrete e non superano le barriere tra tenant. Un progetto può supportare tutti i tenant necessari.

Sicurezza

CTS fornisce un supporto molto ridotto per i tenant. È tua responsabilità creare i tenant, assegnare gli ID tenant e fornire l'ID tenant corretto quando effettui una richiesta. CTS verifica che l'ID tenant sia di proprietà di un determinato progetto e recupera i dati dal tenant fornito. Qualsiasi misura di sicurezza aggiuntiva per rilevare gli accessi non autorizzati deve essere gestita 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 lavoro. Per un elenco dei codici di errore, consulta la pagina Codici di risposta HTTP. Ecco alcuni esempi comuni:

   • Le località dei job non sono corrette, pertanto la richiesta non può essere risolta.
   • I campi Azienda o Job non esistono, quindi viene restituita una richiesta non valida.

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

   • Controlla i log dal tuo backend.
   • Controlla lo strumento di gestione CTS per il logging dei dati.
   • Configura lo strumento di monitoraggio Stackdriver nella Console Cloud per raccogliere dati su metriche, eventi e metadati.

2. Job di indicizzazione: la Ricerca di lavoro è progettata per indicizzare tutti i job caricati in un determinato periodo di tempo. Tuttavia, potresti avere limitazioni di quota. Assicurati di verificare se il tuo sistema presenta limitazioni per le richieste di indicizzazione prima di inviare i job a CTS.

Attacchi DDoS autoindotti

Gestione degli errori

I servizi API forniti tramite internet possono presentare interruzioni intermittenti della connessione, interruzioni prolungate, manutenzione improvvisa del servizio e altri eventi che richiedono all'applicazione client di riprovare la richiesta API. Assicurati di progettare il nuovo tentativo con un comportamento adatto alla rete, ad esempio il backoff esponenziale.

Limiti di quota

Evita di inviare traffico superiore alla quota assegnata, soprattutto se molto superiore. In caso contrario, il tuo traffico potrebbe essere classificato come dannoso e quindi bloccato.

Deduplicazione

I job duplicati influiscono negativamente sull'esperienza di ricerca di chi cerca lavoro. Ricerca di 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:

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

2. Cerca offerte di lavoro: la Ricerca di Jobs mostra le offerte di lavoro pertinenti alla query di ricerca del candidato. Una funzionalità integrata dell'algoritmo di pertinenza garantisce che gli annunci restituiti siano diversificati, impedendo che annunci quasi identici vengano visualizzati uno accanto all'altro nei risultati di ricerca.