Parameter Job Search API: Praktik terbaik (v3)

Mengonfigurasi API

Faktor yang memengaruhi hasil penelusuran

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

1. Lowongan Unggulan: Anda dapat menggunakan Lowongan Unggulan untuk menetapkan nilai promosi ke setiap lowongan, sehingga Anda dapat menyoroti lowongan yang penting bagi kebutuhan bisnis Anda. Lihat dokumentasi Lowongan 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 algoritma ML. Setelan default-nya adalah false. Jika setelan default dipertahankan, CTS Job search API akan menampilkan lowongan yang tidak ditampilkan sebagai relevan oleh algoritma ML, tetapi ada kecocokan kata kunci dalam judul atau deskripsi pekerjaan dengan string kueri pencari kerja. Menetapkan parameter ini ke true akan menonaktifkan kecocokan kata kunci, sehingga lebih sedikit tugas (hanya tugas yang ditentukan relevan oleh fitur ML) yang ditampilkan.

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

Hasil konfigurasi penelusuran

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

Untuk menampilkan lebih banyak lowongan pekerjaan, 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 pekerjaan yang lebih banyak, termasuk pekerjaan yang relevan dan pekerjaan yang diperluas kuerinya: Tetapkan disableKeywordMatch ke true dan enableBroadening ke true. Kueri pencari kerja diperluas untuk menyertakan kategori pekerjaan terkait dan lokasi terdekat, yang tercantum setelah hasil yang relevan. Kecocokan berbasis kata kunci tidak ditampilkan.

Untuk menampilkan jumlah tugas tertinggi yang mungkin: Tetapkan disableKeywordMatch ke false dan enableBroadening ke true. Job Search API menampilkan lowongan yang paling relevan di bagian atas hasil penelusuran, diikuti dengan lowongan yang cocok dengan kata kunci dan lowongan yang diperluas kuerinya (berdasarkan lokasi, kategori lowongan, dll.). Hal ini 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 bahwa tugas unggulan disetel ke `false`).
+	+	Menampilkan jumlah tugas yang lebih tinggi, termasuk tugas yang relevan dan tugas yang diperluas kuerinya (tetapi asumsikan tugas unggulan disetel ke `false`).
-	+	Menampilkan jumlah tugas tertinggi (tetapi mengasumsikan bahwa tugas unggulan disetel ke `false`).
+	-	Hanya menampilkan pekerjaan yang paling relevan (tetapi mengasumsikan pekerjaan unggulan ditetapkan ke `false`).

Request.page_size

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

customAttributes

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

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

Kolom lokasi

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

locationFilter

Gunakan regionCode jika satu perusahaan memiliki beberapa lowongan kerja yang berlokasi di wilayah geografis yang berbeda. Menetapkan regionCode ke setiap listingan memastikan bahwa kueri penelusuran hanya menampilkan lowongan di lokasi yang diinginkan pencari kerja, bukan hasil global untuk perusahaan tersebut. Misalnya, penelusuran pada kata kunci lokasi "Cambridge" tanpa regionCode di tempatnya akan menampilkan hasil dari Cambridge, Inggris Raya dan Cambridge, MA, Amerika Serikat. Hal ini mengurangi relevansi penelusuran.

Region_code dan Language_code

Tetapkan 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 (en_GB dalam kasus ini) sehingga API dapat menggunakan logika penelusuran yang dilokalkan (misalnya, "sopir truk" di en_GB, bukan "truck driver" di Amerika Serikat).

radiusinMiles

Parameter ini menetapkan radius (dalam mil) di sekitar lokasi yang ditunjukkan oleh pencari kerja. API menampilkan hasil dalam rentang geografis ini. Cara jarak ini diterapkan ke geografi hasil penelusuran bergantung pada jenis informasi lokasi yang dimasukkan. Jika pencari kerja memasukkan alamat jalan, jarak radiusInMiles ditetapkan dari satu titik. Jika pencari kerja memasukkan kota, API akan 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 mengurangi relevansi. Misalnya, menelusuri lowongan di New York City dengan radiusInMiles yang disetel ke 100 mil akan menampilkan hasil di bagian utara New York dan New Jersey. Memastikan radius sekecil mungkin akan meningkatkan relevansi hasil.

postingExpireTime

Parameter ini menetapkan jangka waktu postingan lowongan aktif sebelum dihapus dari hasil penelusuran. Nilai defaultnya adalah 30 hari setelah waktu pembuatan tugas di zona waktu UTC.

Job_employment_type

Ini bukan kolom wajib diisi, tetapi menggunakan Job_employment_type akan meningkatkan relevansi hasil penelusuran lowongan.

Mengonfigurasi API: Peringkat Kustom

Featured Jobs memberi Anda kemampuan untuk memengaruhi hasil penelusuran dan menandai lowongan berdasarkan satu variabel (promotionValue). Lihat dokumentasi Featured Jobs untuk mengetahui detailnya. Peringkat Kustom memberi Anda kemampuan untuk memengaruhi hasil berdasarkan beberapa variabel, sehingga menawarkan lebih banyak kontrol atas peringkat terlepas dari relevansinya. Fitur ini berguna untuk aplikasi yang memerlukan penyeimbangan relevansi dengan kepentingan ekonomi, seperti sistem pelanggan Biaya per Klik (CPC) bertingkat. Pengaruh terhadap cara pekerjaan diurutkan di atas skor relevansi yang ada didasarkan pada dua variabel: rankingExpression dan importanceLevel.

• rankingExpression: Variabel ini mengontrol cara peringkat tugas berdasarkan skor relevansi yang ada (sebagaimana ditentukan oleh algoritma API). 'rankingExpression' harus disetel ke 'filterable' agar API mengindeks parameter.

• importanceLevel: Parameter ini menetapkan tingkat kepentingan posisi peringkat tugas saat ditampilkan dalam penelusuran. Ada enam tingkat yang berbeda: Tidak ditentukan, NONE, LOW, MID, HIGH, dan EXTREME. Menyetel nilai ke EXTREME berarti semua faktor relevansi yang dihasilkan API lainnya diabaikan, jadi gunakan nilai ini dengan hemat. Lowongan yang disetel ke EXTREME ditampilkan di bagian atas kueri pencari kerja, bukan lowongan yang paling relevan.

• Lowongan Unggulan vs. Peringkat Kustom: Lowongan Unggulan paling berguna untuk mempromosikan satu kategori pekerjaan (misalnya, pekerjaan di perusahaan tertentu) di atas peringkat relevansi. Jika Anda perlu memberi peringkat pekerjaan berdasarkan variabel CPC (Biaya Per Klik) multi-level selain peringkat relevansi, Peringkat Kustom adalah pilihan yang lebih baik.

Penelusuran perjalanan

Penelusuran perjalanan membantu pencari kerja menelusuri lowongan 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 cara penggunaan 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 mengetahui informasi selengkapnya. Beberapa contoh umum:

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

   Ada tiga opsi utama untuk memecahkan masalah penguploadan tugas:

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

2. Tugas pengindeksan: Job Search API dirancang untuk mengindeks semua lowongan yang Anda upload dalam jangka waktu tertentu. Namun, Anda mungkin memiliki batasan kuota di pihak Anda. Pastikan untuk memeriksa sistem Anda terkait pembatasan pada permintaan pengindeksan sebelum mengirimkan tugas ke CTS.

Mekanisme penanganan error

Penanganan error sangat penting untuk menghindari serangan DDoS yang dilakukan sendiri yang mengakibatkan pencari kerja tidak dapat mengakses. Layanan API yang disediakan melalui internet juga dapat mengalami kegagalan koneksi yang tidak teratur, pemadaman layanan yang berkepanjangan, pemeliharaan layanan yang tiba-tiba, dan peristiwa lain yang mengharuskan aplikasi klien mencoba lagi permintaan API. Pencobaan ulang ini harus dirancang dengan perilaku yang sesuai untuk jaringan, misalnya backoff eksponensial.

Menghapus duplikat

Lowongan duplikat berdampak negatif pada pengalaman penelusuran pencari kerja. Job search API menyertakan dua fitur untuk meminimalkan duplikat:

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

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

2. Menelusuri lowongan: CTS Job Search API menampilkan lowongan yang relevan dengan kueri penelusuran pencari kerja. Fitur bawaan algoritma relevansi memastikan bahwa semua lowongan yang ditampilkan beragam, sehingga mencegah lowongan yang hampir identik muncul berdekatan dalam hasil penelusuran.