Parametri API Job Search: best practice (v3)

Configurazione dell'API

Fattori che influiscono sui risultati di ricerca

Insieme, "Offerte di lavoro in primo piano", "Abilita 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.

  1. Offerte di lavoro in primo piano: puoi utilizzare Offerte di lavoro in primo piano per assegnare valori promozionali a singoli lavori, in modo da mettere in evidenza le offerte di lavoro importanti per le esigenze della tua attività. Consulta la documentazione relativa ai job in primo piano per conoscere le best practice e i dettagli di implementazione.

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

  3. enableBroadening: questo parametro consente di espandere la query di chi cerca lavoro allentando le limitazioni dichiarate sulle categorie di località e prestazioni. Per impostazione predefinita è impostato su false ed è abilitato se è impostato su true. È utilizzato per aumentare il numero di risultati di ricerca restituiti.

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 dell'API relative alla pertinenza della ricerca, poiché vengono restituiti solo i job pertinenti. Tuttavia, nei risultati di ricerca vengono restituiti meno job complessivi.

Per restituire un numero più elevato di offerte di lavoro, inclusi i risultati pertinenti e con corrispondenza alle parole chiave: imposta disableKeywordMatch su false e enableBroadening su false. I risultati con corrispondenza delle parole chiave vengono elencati dopo le job pertinenti nei risultati, ma 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 l'impiego viene espansa in modo da includere le categorie di prestazioni e le località nelle vicinanze correlate, elencate 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. L'API Job Search restituisce le offerte di lavoro più pertinenti nella parte superiore dei risultati di ricerca, seguite dalle offerte di lavoro con corrispondenza con parole chiave e dai job espansi delle 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 corrispondenze alle parole chiave (ma supponiamo che le offerte di lavoro in primo piano siano impostate su "false").
+ + Restituisce un numero maggiore di job, inclusi i job pertinenti e quelli espansi con query (ma supponiamo che i job in primo piano siano impostati su "false").
- + Restituisce il numero più alto di offerte di lavoro (ma supponiamo che le offerte in primo piano siano impostate su "false").
+ - Restituisce solo le offerte di lavoro più pertinenti (ma supponiamo che le offerte in primo piano siano impostate 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.

customAttributes

customAttributes ti offre la flessibilità di assegnare valori aggiuntivi alle tue offerte di lavoro 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 Località è disponibile nella pagina Campi posizione. Se specifichi l'indirizzo del lavoro anziché le coordinate GPS nel campo dell'indirizzo, l'API migliora il rilevamento della posizione e la pertinenza della ricerca.

locationFilter

Utilizza regionCode se una singola azienda ha più offerte di lavoro ubicate 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 di chi cerca l'offerta di lavoro, anziché i risultati globali per l'azienda in questione. Ad esempio, una ricerca per la parola chiave della località "Cambridge" senza regionCode al suo interno restituisce risultati sia da Cambridge, Regno Unito, sia da Cambridge, MA, USA. Ciò riduce la pertinenza della ricerca.

Region_code e Language_code

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

radiusinMiles

Questo parametro imposta un raggio (in miglia) intorno alla località indicata da chi cerca un impiego. L'API restituisce i 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 di radiusInMiles viene impostata da un singolo punto. Se la persona in cerca di lavoro entra in una città, l'API applica un riquadro di delimitazione intorno ai limiti della città e calcola la distanza dai bordi dei riquadri. 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 restituisce risultati che potrebbero essere al di fuori della località desiderata per la ricerca del lavoro, diminuendo la pertinenza. Ad esempio, la ricerca di offerte di lavoro nella città di New York con il valore radiusInMiles impostato su 100 miglia restituisce risultati sia nella parte nord dello stato di New York sia nel New Jersey. Se riduci al minimo il raggio d'azione, aumenta la pertinenza dei risultati.

postingExpireTime

Questo parametro imposta il periodo di tempo in cui l'offerta di lavoro è attiva prima che venga 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_Employ_type aumenta la pertinenza dei risultati di ricerca delle offerte di lavoro.

Configurazione dell'API: ranking personalizzato

I job in primo piano ti consentono di influenzare i risultati di ricerca ed evidenziare le offerte di lavoro in base a una singola variabile (promotionValue). Per informazioni dettagliate, consulta la documentazione relativa ai offerte di lavoro in primo piano. Il ranking personalizzato ti consente di influire sui risultati in base a più variabili, offrendo un maggiore controllo sui ranking indipendentemente dalla pertinenza. Questa funzione è utile per applicazioni che richiedono il bilanciamento tra pertinenza e interessi economici, come ad esempio un sistema di abbonati basato sul costo per clic (CPC) a più livelli. L'influenza sul ranking delle offerte di lavoro rispetto al punteggio di pertinenza esistente si basa su due variabili: rankingExpression e importanceLevel.

  • rankingExpression: questa variabile controlla in che modo le offerte di lavoro vengono classificate in base ai punteggi di pertinenza esistenti (come determinato dall'algoritmo API). "rankingExpression" deve essere impostato su "filterable" affinché l'API indicizzi il parametro.

  • importanceLevel: questo parametro imposta il livello di importanza della posizione nel ranking di un lavoro quando viene restituito nelle ricerche. Esistono sei diversi livelli: Non specificato, NONE, LOW, MID, HIGH e EXTREME. Se il valore è impostato 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 della persona in cerca di lavoro anziché nei job più pertinenti.

  • Offerte di lavoro in primo piano e Ranking personalizzato: le Offerte di lavoro in primo piano sono utili soprattutto per promuovere una singola categoria di offerte di lavoro (ad esempio, offerte di lavoro presso una determinata azienda) al di sopra del ranking della pertinenza. Se hai bisogno di 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.

Ricerca basata sul tragitto giornaliero aiuta le persone in cerca di lavoro a cercare offerte di lavoro in base ai tempi di percorrenza del tragitto giornaliero. Per abilitarlo, includi un oggetto CommuteFilter aggiuntivo nel campo JobQuery.commuteFilter. Questo oggetto consente a chi cerca l'impiego di selezionare commuteMethod, travelDuration e startCoordinates. Chi cerca un lavoro può anche selezionare opzioni come roadTraffic (TRAFFIC_FREE o BUSY_HOUR) e departureTime per calcolare la durata del tragitto giornaliero. Per informazioni dettagliate, consulta le pagine relative all'implementazione e alle istruzioni per il tragitto giornaliero sulla rete di ricerca.

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. Alcuni esempi comuni:

    • Le località del job non sono corrette, pertanto la richiesta non può essere risolta.
    • I campi Company o Job non esistono e restituiscono una richiesta errata.

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

  2. Job di indicizzazione: l'API Job Search è progettata per indicizzare tutti i job caricati in un determinato periodo di tempo. Tuttavia, potresti avere dei limiti di quota. Prima di inviare job a CTS, assicurati di verificare la presenza di restrizioni sulle richieste di indicizzazione nel sistema.

Meccanismi di gestione degli errori

La gestione degli errori è fondamentale per evitare un attacco DDoS autoinflitto che provoca il blocco dell'accesso a chi cerca lavoro. I servizi API forniti tramite Internet possono inoltre presentare errori di connessione intermittente, un'interruzione prolungata, una manutenzione improvvisa del servizio e altri eventi che richiedono un'applicazione client per ritentare la richiesta API. Questo nuovo tentativo deve essere progettato con un comportamento ottimizzato per la rete, ad esempio un backoff esponenziale.

Deduplicazione

I lavori duplicati influiscono negativamente sull'esperienza di ricerca di chi cerca un impiego. 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 riceverai un errore 4xx:

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

  2. Cercare offerte di lavoro:l'API CTS Job Search mostra le offerte di lavoro pertinenti alla query di ricerca di chi è in cerca di 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.