Parametri dell'API Job Search: best practice (v3)

Configurazione dell'API

Fattori che influiscono sui risultati di ricerca

Insieme, "Lavori in evidenza", "Attiva l'ampliamento" e "Disattiva la corrispondenza delle parole chiave" hanno un impatto significativo sul numero e sulla pertinenza dei lavori 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.

  1. Offerte di lavoro in evidenza: puoi utilizzare le offerte di lavoro in evidenza per assegnare valori promozionali a singole offerte di lavoro, in modo da mettere in evidenza le offerte di lavoro importanti per le esigenze della tua attività. Per informazioni sulle best practice e sui dettagli di implementazione, consulta la documentazione relativa ai annunci di lavoro in evidenza.

  2. disableKeywordMatch: questo parametro consente all'API di restituire le corrispondenze delle parole chiave oltre ai risultati pertinenti determinati dall'algoritmo di ML. L'impostazione predefinita è false. Se mantieni l'impostazione predefinita, l'API Job Search restituisce i lavori che non sono stati restituiti come pertinenti dall'algoritmo di ML, ma c'è una corrispondenza di parole chiave nel titolo o nella descrizione del lavoro con la stringa di query del candidato. Se imposti questo parametro su true, la corrispondenza della parola chiave viene disattivata, quindi vengono restituiti meno lavori (solo quelli ritenuti pertinenti dalla funzionalità ML).

  3. enableBroadening: Questo parametro ti consente di espandere la query del candidato allentando le limitazioni dichiarate per località e categorie di lavoro. È impostato su false per impostazione predefinita ed è attivo quando è impostato su true. Viene utilizzato per aumentare il numero di risultati di ricerca restituiti.

Risultati della configurazione della ricerca

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

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

Per restituire un numero maggiore di lavori, inclusi quelli pertinenti e quelli con query estesa: Imposta disableKeywordMatch su true e enableBroadening su true. La query del candidato viene espansa per includere categorie di lavoro correlate e località vicine, elencate dopo i risultati pertinenti. Le corrispondenze basate su parole chiave non vengono restituite.

Per restituire il numero più alto possibile di job: imposta disableKeywordMatch su false e enableBroadening su true. L'API Job Search restituisce i lavori più pertinenti nella parte superiore dei risultati di ricerca, seguiti dai lavori corrispondenti alle parole chiave e dai lavori con query estese (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 job, inclusi i risultati pertinenti e quelli corrispondenti alle parole chiave (ma supponi che i job in evidenza siano impostati su "false").
+ + Restituisce un numero maggiore di job, inclusi quelli pertinenti e quelli con query estesa (ma supponi che i job in evidenza siano impostati su "false").
- + Restituisce il numero più alto di job (ma supponi che i job in evidenza siano impostati su "false").
+ - Restituisce solo i job più pertinenti (ma supponi che i job in evidenza siano impostati su "false").

Request.page_size

Per ottenere prestazioni ottimali ed evitare la latenza, configura la pagina dei risultati in modo che visualizzi al massimo 20 offerte di lavoro alla volta.

customAttributes

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

Campo Posizione

Una panoramica dettagliata del campo Posizione è disponibile nella pagina Campi posizione. Fornire l'indirizzo stradale del lavoro anziché le coordinate GPS nel campo dell'indirizzo aiuta l'API a migliorare il rilevamento della posizione e la pertinenza della ricerca.

locationFilter

Utilizza regionCode se una singola azienda ha più offerte di lavoro situate 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é i risultati globali per l'azienda. Ad esempio, una ricerca sulla parola chiave per località "Cambridge" senza un regionCode restituisce risultati sia di Cambridge, Regno Unito, sia di Cambridge, MA, Stati Uniti. Ciò riduce la pertinenza della ricerca.

Region_code e Language_code

Imposta request.filters.location_filters.region_code in modo che corrisponda alla località geografica che l'utente sta cercando (ad esempio il Regno Unito). Imposta request.filters.language_code sul codice di lingua appropriato per quella regione (en_GB in questo caso) in modo che l'API possa utilizzare la logica di ricerca localizzata (ad esempio, "autista di camion" in en_GB anziché "camionista" negli Stati Uniti).

radiusinMiles

Questo parametro imposta un raggio (in miglia) intorno alla località indicata da chi cerca lavoro. L'API restituisce i risultati all'interno di questo intervallo geografico. Il modo in cui questa distanza viene applicata alla geografia dei risultati di ricerca dipende dal tipo di informazioni sulla località inserite. Se il candidato inserisce un indirizzo stradale, la distanza radiusInMiles viene impostata da un unico punto. Se il candidato inserisce una città, l'API applica unriquadro di delimitazionee 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.

Assicurati che il raggio chilometrico sia il più piccolo possibile. Se imposti il chilometraggio su un intervallo più ampio, i risultati potrebbero essere al di fuori della posizione desiderata dal candidato, riducendo la pertinenza. Ad esempio, la ricerca di lavoro a New York con radiusInMiles impostato su 160 km restituisce risultati sia nello stato di New York che nel New Jersey. Mantenere il raggio il più piccolo possibile aumenta la pertinenza dei risultati.

postingExpireTime

Questo parametro imposta il periodo di tempo durante il quale l'offerta di lavoro è attiva prima di essere rimossa dai risultati di ricerca. Il valore predefinito è 30 giorni dopo l'ora di creazione del job nel fuso orario UTC.

Job_employment_type

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

Configurazione dell'API: ranking personalizzato

Offerte di lavoro in evidenza ti consente di influenzare i risultati di ricerca ed evidenziare le offerte di lavoro in base a una singola variabile (promotionValue). Per maggiori dettagli, consulta la documentazione relativa alle offerte di lavoro in evidenza. Il ranking personalizzato ti consente di influenzare i risultati in base a più variabili, offrendo un maggiore controllo sui ranking indipendentemente dalla pertinenza. Questa funzionalità è utile per le applicazioni che richiedono di bilanciare la pertinenza con gli interessi economici, come un sistema di abbonati con costo per clic (CPC) a più livelli. L'influenza sul modo in cui i lavori vengono classificati in base al punteggio di pertinenza esistente si basa su due variabili: rankingExpression e importanceLevel.

  • rankingExpression: questa variabile controlla il ranking dei lavori in base ai loro punteggi di pertinenza esistenti (determinati dall'algoritmo dell'API). "rankingExpression" deve essere impostato su "filterable" affinché l'API possa indicizzare il parametro.

  • importanceLevel: questo parametro imposta il livello di importanza della posizione di ranking di un job quando viene restituito nelle ricerche. Esistono sei livelli diversi: 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 restituiti all'inizio della query di chi cerca lavoro anziché i job più pertinenti.

  • Lavori in evidenza e Ranking personalizzato: Lavori in evidenza è più utile per promuovere una singola categoria di lavori (ad esempio, lavori presso una determinata azienda) al di sopra del ranking per pertinenza. Se devi classificare i lavori in base a variabili CPC (costo per clic) multilivello oltre alla classificazione per pertinenza, la classificazione personalizzata è una scelta migliore.

La ricerca basata sul tragitto giornaliero aiuta le persone in cerca di lavoro a trovare impieghi in base al tempo di percorrenza. Per attivarlo, includi un oggetto CommuteFilter aggiuntivo nel campo JobQuery.commuteFilter. Questo oggetto consente al candidato di selezionare commuteMethod, travelDuration e startCoordinates. Il candidato può anche selezionare opzioni come roadTraffic (TRAFFIC_FREE o BUSY_HOUR) e departureTime per calcolare il tempo di percorrenza. Per maggiori dettagli, consulta le pagine relative all'implementazione e alle istruzioni per la ricerca dei tragitti.

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 nell'API. Per ulteriori informazioni, consulta la pagina Codici di risposta HTTP. Ecco alcuni esempi comuni:

    • Le sedi di lavoro non sono corrette, quindi la richiesta non può essere risolta.
    • I campi Azienda o Lavoro non esistono, il che restituisce una richiesta non valida.

    Esistono tre opzioni principali per risolvere i problemi di caricamento dei lavori:

  2. Job di indicizzazione:l'API Job Search è progettata per indicizzare tutti i job caricati in un determinato periodo di tempo. Tuttavia, potresti avere limitazioni di quota dalla tua parte. Prima di inviare job a CTS, assicurati di controllare il sistema per verificare la presenza di limitazioni alle richieste di indicizzazione.

Meccanismi di gestione degli errori

La gestione degli errori è fondamentale per evitare un attacco DDoS autoinflitto che impedisce ai candidati di accedere. I servizi API forniti tramite internet possono anche presentare errori di connessione intermittenti, interruzioni prolungate, manutenzione improvvisa del servizio e altri eventi che richiedono a un'applicazione client di riprovare la richiesta API. Questo nuovo tentativo deve essere progettato con un comportamento compatibile con la rete, ad esempio backoff esponenziale.

Deduplicazione

I lavori duplicati influiscono negativamente sull'esperienza di ricerca di chi cerca lavoro. L'API Job Search 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 verrà rifiutato e si verificherà un errore 4xx:

    • stesso companyName, E
    • stesso job_req_id, E
    • stessa posizione/languageCode

  2. Cerca lavoro:l'API CTS Job search mostra i lavori pertinenti alla query di ricerca della persona in cerca di occupazione. Una funzionalità integrata dell'algoritmo di pertinenza assicura che i lavori restituiti siano diversificati, impedendo che lavori quasi identici vengano visualizzati uno accanto all'altro nei risultati di ricerca.