Parameter API penelusuran lowongan: Praktik terbaik (v3)

Mengonfigurasi API

Faktor yang memengaruhi hasil penelusuran

Bersama-sama, "Tugas Unggulan", "Aktifkan Perluasan", dan "Nonaktifkan Pencocokan Kata Kunci" memiliki dampak yang signifikan terhadap jumlah dan relevansi tugas yang dikembalikan kepada pencari kerja. Konfigurasi yang paling tepat dari ketiga faktor ini bergantung pada kebutuhan bisnis Anda. Metode terbaik untuk menentukan konfigurasi yang optimal adalah dengan menerapkan berbagai skenario pengujian dan mengevaluasi hasilnya selama fase pengujian.

1. Tugas Unggulan: Anda dapat menggunakan Tugas Unggulan untuk menetapkan nilai promosi ke masing-masing tugas, yang memungkinkan Anda menyoroti pekerjaan yang penting untuk kebutuhan bisnis. Lihat dokumentasi Tugas unggulan untuk mengetahui praktik terbaik dan detail implementasi.

2. disableKeywordMatch: Parameter ini memungkinkan API menampilkan kecocokan kata kunci selain hasil yang relevan yang ditentukan oleh algoritme ML. Setelan default-nya adalah false. Dengan mempertahankan setelan default, CTS Search API akan menampilkan tugas yang tidak ditampilkan secara relevan oleh algoritme ML, tetapi terdapat kecocokan kata kunci dalam judul atau deskripsi lowongan dengan string kueri pencari kerja. Menyetel parameter ini ke true akan menonaktifkan pencocokan kata kunci, sehingga lebih sedikit tugas (hanya tugas yang dianggap relevan oleh fitur ML) yang ditampilkan.

3. enableBroadening: Parameter ini memungkinkan Anda memperluas kueri pencari kerja dengan melonggarkan batasan yang dinyatakan pada kategori lokasi dan pekerjaan. Setelan ini disetel ke false secara default dan diaktifkan saat disetel ke true. Bagian ini digunakan untuk meningkatkan jumlah hasil penelusuran yang ditampilkan.

Hasil konfigurasi penelusuran

Untuk hanya menampilkan pekerjaan yang paling relevan: Tetapkan disableKeywordMatch ke true dan enableBroadening ke false. Hal ini meningkatkan metrik performa API yang terkait dengan relevansi penelusuran, karena hanya lowongan relevan yang ditampilkan. Namun, lebih sedikit pekerjaan secara keseluruhan yang ditampilkan dalam hasil penelusuran.

Untuk menampilkan jumlah tugas yang lebih tinggi termasuk hasil yang relevan dan cocok dengan kata kunci: Tetapkan disableKeywordMatch ke false dan enableBroadening ke false. Hasil yang cocok dengan kata kunci dicantumkan setelah tugas yang relevan dalam hasil, tetapi hasil perluasan kueri tidak ditampilkan.

Untuk menampilkan jumlah tugas yang lebih tinggi, termasuk tugas yang relevan dan yang diperluas kuerinya: Tetapkan disableKeywordMatch ke true dan enableBroadening ke true. Kueri pencari kerja diperluas untuk menyertakan kategori lowongan terkait dan lokasi terdekat, yang dicantumkan setelah hasil yang relevan. Kecocokan berbasis kata kunci tidak ditampilkan.

Untuk menampilkan jumlah tugas sebanyak mungkin: Tetapkan disableKeywordMatch ke false dan enableBroadening ke true. Job Search API menampilkan pekerjaan yang paling relevan di bagian atas hasil penelusuran, diikuti dengan lowongan yang cocok dengan kata kunci dan kueri pekerjaan yang diperluas (menurut lokasi, kategori pekerjaan, dll). Ini akan memaksimalkan jumlah total tugas yang ditampilkan.

diasableKeywordMatch	enableBroadening	Hasil
-	-	Menampilkan jumlah tugas yang lebih tinggi, termasuk hasil yang relevan dan cocok dengan kata kunci (tetapi asumsikan tugas unggulan ditetapkan ke `false`).
+	+	Menampilkan jumlah tugas yang lebih tinggi, termasuk tugas yang relevan dan yang diperluas kueri (tetapi asumsikan tugas unggulan ditetapkan ke `false`).
-	+	Menampilkan jumlah tugas tertinggi (tetapi asumsikan tugas unggulan ditetapkan ke `false`).
+	-	Hanya menampilkan pekerjaan yang paling relevan (tetapi asumsikan tugas unggulan ditetapkan ke `false`).

Request.page_size

Untuk mendapatkan performa terbaik dan menghindari latensi, siapkan halaman hasil untuk menampilkan 20 tugas atau kurang sekaligus.

customAttributes

customAttributes memberi Anda fleksibilitas untuk menetapkan nilai tambahan ke pekerjaan sesuai dengan kebutuhan bisnis Anda (misalnya, skor IPK) dan menggunakan nilai ini untuk memfilter hasilnya.

Catatan: Hindari menyiapkan nilai customAttributes apa pun yang terkait dengan lokasi. Filter lokasi API yang ada memiliki algoritma bawaan yang otomatis mendeteksi informasi lokasi terkait kueri penelusuran pencari kerja.

Kolom lokasi

Ringkasan mendetail tentang kolom Lokasi dapat ditemukan di halaman Kolom lokasi. Menyediakan alamat pekerjaan, bukan koordinat GPS di kolom alamat, akan membantu API meningkatkan deteksi lokasi dan relevansi penelusuran.

locationFilter

Gunakan regionCode jika sebuah perusahaan memiliki beberapa lowongan pekerjaan yang terletak di wilayah geografis yang berbeda. Menetapkan regionCode ke setiap listingan memastikan bahwa kueri penelusuran hanya menampilkan pekerjaan di lokasi yang diinginkan pencari kerja, bukan hasil global untuk perusahaan tersebut. Misalnya, penelusuran kata kunci lokasi "Cambridge" tanpa regionCode akan menampilkan hasil dari Cambridge, UK dan Cambridge, MA, USA. Hal ini akan mengurangi relevansi penelusuran.

Region_code dan Language_code

Setel request.filters.location_filters.region_code agar cocok dengan lokasi geografis yang ditelusuri pengguna (seperti Inggris Raya). Tetapkan request.filters.language_code ke kode bahasa yang sesuai untuk wilayah tersebut (dalam hal ini en_GB) sehingga API dapat menggunakan logika penelusuran yang dilokalkan (misalnya, "sopir truk" di en_GB, bukan "driver truk" di Amerika Serikat).

radiusinMiles

Parameter ini menetapkan radius (dalam mil) di sekitar lokasi yang ditunjukkan pencari kerja. API menampilkan hasil dalam rentang geografis ini. Cara penerapan jarak ini ke geografi hasil penelusuran bergantung pada jenis informasi lokasi yang dimasukkan. Jika pencari kerja memasukkan alamat, jarak radiusInMiles ditetapkan dari satu titik. Jika pencari kerja memasuki kota, API menerapkan kotak pembatas di sekitar batas kota dan menghitung jarak dari tepi kotak. Jika pengguna hanya memasukkan negara bagian atau negara, radiusInMiles akan diabaikan.

Pastikan radius jarak tempuh sekecil mungkin. Menetapkan jarak tempuh ke rentang yang lebih besar akan menampilkan hasil yang mungkin berada di luar lokasi yang diinginkan pencari kerja, sehingga akan mengurangi relevansi. Misalnya, menelusuri lowongan di kota New York dengan radiusInMiles yang ditetapkan ke 160 km akan menampilkan hasil di New York dan New Jersey bagian utara. Mempertahankan radius sekecil mungkin akan meningkatkan relevansi hasil.

postingExpireTime

Parameter ini menetapkan durasi aktif postingan lowongan sebelum dihapus dari hasil penelusuran. Setelan defaultnya adalah 30 hari setelah waktu pembuatan lowongan dalam zona waktu UTC.

Job_employment_type

Kolom ini tidak wajib diisi, tetapi penggunaan Job_Employ_type akan meningkatkan relevansi hasil penelusuran lowongan.

Mengonfigurasi API: Peringkat Kustom

Tugas Unggulan memberi Anda kemampuan untuk memengaruhi hasil penelusuran dan menandai tugas berdasarkan satu variabel (promotionValue). Lihat dokumentasi Tugas Unggulan untuk mengetahui detailnya. Peringkat Kustom memberi Anda kemampuan untuk memengaruhi hasil berdasarkan beberapa variabel, sehingga menawarkan kontrol yang lebih besar atas peringkat, terlepas dari relevansinya. Fitur ini berguna untuk aplikasi yang perlu menyeimbangkan relevansi dengan kepentingan ekonomi, seperti sistem pelanggan Biaya per Klik (CPC) multi-tingkat. Pengaruh pada cara peringkat pekerjaan diberi peringkat di atas skor relevansi yang ada didasarkan pada dua variabel: rankingExpression dan importanceLevel.

• rankingExpression: Variabel ini mengontrol cara peringkat tugas berdasarkan skor relevansinya yang ada (seperti yang ditentukan oleh algoritma API). 'rankingExpression' harus ditetapkan ke 'filterable' agar API dapat mengindeks parameter.

• importanceLevel: Parameter ini menetapkan tingkat kepentingan posisi peringkat pekerjaan saat ditampilkan dalam penelusuran. Ada enam tingkat yang berbeda: Tidak Ditentukan, NONE, LOW, MID, HIGH, dan EXTREME. Jika nilai ini ditetapkan ke EXTREME, semua faktor relevansi yang dihasilkan API lainnya akan diabaikan, jadi gunakan nilai ini seperlunya. Tugas yang ditetapkan ke EXTREME ditampilkan di bagian atas kueri pencari kerja, bukan tugas yang paling relevan.

• Pekerjaan Unggulan versus Peringkat Kustom: Tugas Unggulan paling berguna untuk mempromosikan satu kategori pekerjaan (misalnya, lowongan di perusahaan tertentu) di atas peringkat relevansi. Jika Anda perlu memberi peringkat lowongan berdasarkan variabel CPC (Biaya Per Klik) multilevel selain peringkat relevansi, Peringkat Kustom adalah pilihan yang lebih baik.

Penelusuran perjalanan

Penelusuran perjalanan membantu pencari kerja menelusuri pekerjaan berdasarkan waktu perjalanan. Untuk mengaktifkannya, sertakan objek CommuteFilter tambahan di kolom JobQuery.commuteFilter. Objek ini memungkinkan pencari kerja memilih commuteMethod, travelDuration, dan startCoordinates. Pencari kerja juga dapat memilih opsi seperti roadTraffic (TRAFFIC_FREE atau BUSY_HOUR) dan departureTime saat menghitung waktu perjalanan. Lihat halaman penerapan dan petunjuk Penelusuran Perjalanan untuk mengetahui detailnya.

Pengelolaan data & penanganan error

Integritas data

1. Mengupload tugas: Masalah data dapat mencegah tugas diupload ke API. Lihat halaman Kode Respons HTTP untuk informasi selengkapnya. Beberapa contoh umum:

   • Lokasi pekerjaan salah, sehingga permintaan tidak dapat diselesaikan.
   • Kolom Perusahaan atau Lowongan tidak ada, yang menampilkan permintaan buruk.

   Ada tiga opsi utama untuk memecahkan masalah terkait upload tugas:

   • Periksa logging dari backend Anda.
   • Lihat alat pengelolaan CTS untuk logging data.
   • Siapkan Alat Stackdriver Monitoring di Cloud Console untuk mengumpulkan metadata, metrik, dan peristiwa.

2. Pengindeksan tugas: API Penelusuran Lowongan dirancang untuk mengindeks semua tugas yang diupload dalam jangka waktu tertentu. Namun, Anda mungkin memiliki batasan kuota. Pastikan untuk memeriksa batasan permintaan pengindeksan pada sistem Anda sebelum mengirim tugas ke CTS.

Mekanisme penanganan error

Penanganan error sangat penting untuk menghindari serangan DDoS yang disebabkan oleh diri sendiri yang mengakibatkan pencari kerja tidak dapat bekerja. Layanan API yang disediakan melalui internet juga dapat mengalami kegagalan koneksi sesekali, pemadaman layanan berkepanjangan, pemeliharaan layanan tiba-tiba, dan peristiwa lain yang mengharuskan aplikasi klien untuk mencoba kembali permintaan API. Percobaan ulang ini harus didesain dengan perilaku yang sesuai untuk jaringan, misalnya backoff eksponensial.

Penghapusan duplikat

Pekerjaan duplikat berdampak negatif pada pengalaman penelusuran pencari kerja. API penelusuran lowongan menyertakan dua fitur untuk meminimalkan duplikat:

1. Buat tugas: Jika Anda mencoba membuat 2+ tugas dengan kriteria berikut, data akan ditolak dan Anda akan mengalami error 4xx:

   • companyName yang sama, DAN
   • job_req_id yang sama, DAN
   • lokasi yang sama/languageCode

2. Menelusuri lowongan: CTS Job search API menampilkan lowongan yang relevan dengan kueri penelusuran pencari kerja. Fitur bawaan dari algoritme relevansi memastikan bahwa setiap tugas yang ditampilkan akan terdiversifikasi, sehingga tugas yang hampir identik tidak muncul berdampingan dalam hasil penelusuran.