Dasar-dasar penelusuran (v3)

Dengan Cloud Talent Solution, pengguna dapat menelusuri pekerjaan yang telah Anda simpan di indeks Cloud Talent Solution. Dokumen ini akan membahas berbagai penawaran penelusuran dan penawaran terkait Cloud Talent Solution.

Permintaan penelusuran

Untuk membuat permintaan penelusuran lowongan, kirim permintaan POST ke endpoint jobs:search, dengan meneruskan data penelusuran di isi.

Kolom wajib diisi

Kolom berikut wajib diisi:

• searchMode: Menentukan jenis penelusuran lowongan yang akan melamar. Opsinya adalah:

  • JOB_SEARCH: Ini adalah mode penelusuran default dan yang direkomendasikan. Semua pekerjaan ditelusuri. Pekerjaan yang paling relevan akan ditampilkan sesuai urutan relevansi dengan kueri penelusuran.
  • FEATURED_JOB_SEARCH: Hanya menelusuri lowongan dengan promotionValue yang lebih besar dari 0. Hasil diurutkan berdasarkan promotionValue tertinggi terlebih dahulu; jika seri, relevansi digunakan untuk menentukan posisi. Lihat Pekerjaan Unggulan untuk info selengkapnya.

Kolom yang biasa digunakan

• JobQuery: Menentukan kriteria tugas yang akan dicocokkan. Hal ini mencakup lokasi, kategori pekerjaan, jenis pekerjaan, kueri teks, perusahaan, dll. Lihat Filter Penelusuran untuk informasi selengkapnya.

• requestMetadata: Berisi informasi pengguna dan sesi untuk permintaan penelusuran ini. Lihat RequestMetadata untuk mengetahui detailnya.

• jobView: Menentukan jumlah kolom yang ditampilkan untuk setiap tugas yang cocok. Dapat berupa JOB_VIEW_SMALL (default), JOB_VIEW_MINIMAL, atau JOB_VIEW_FULL. Deskripsi untuk setiap opsi ada dalam referensi JobView.

• orderBy: Urutan penyortiran untuk tugas yang ditampilkan. Lihat referensi untuk mengetahui nilai yang diizinkan. Setelan defaultnya adalah mengurutkan berdasarkan relevansi, menurun (RELEVANCE_DESC).

Nilai minimum relevansi dan perluasan lokasi/kategori

Guna menampilkan jumlah pekerjaan yang lebih tinggi untuk penelusuran Anda, dua kolom berikut melonggarkan batasan pada relevansi:

• enableBroadening: Menetapkannya ke true akan melonggarkan pembatasan lokasi dan kategori tugas permintaan penelusuran, agar dapat menampilkan lebih banyak hasil. Misalnya, jika permintaan penelusuran menentukan pekerjaan dalam radius 2 mil dari Anytown, WA, menyetel flag ini ke true juga dapat menampilkan tugas dari NextTownOver, WA.

• disableKeywordMatch: Tanda ini secara default salah. Jika tanda ini ditetapkan ke salah (false), Cloud Talent Solution dapat menambahkan lowongan yang relevan dengan kueri penelusuran ini dengan lowongan yang juga cocok dengan string kueri persis dalam judul atau deskripsi.

RequestMetadata

Setiap permintaan penelusuran dan histogram harus menyertakan objek RequestMetadata. Objek ini berisi informasi tentang pengguna yang memulai penelusuran.

Ada beberapa alasan mengapa objek ini penting:

• Konsistensi pengguna. Cloud Talent Solution menjalankan beberapa versi model dasar secara bersamaan untuk meningkatkan relevansi penelusuran. Isi kolom ini untuk memastikan pencari kerja memiliki pengalaman yang konsisten. Cloud Talent Solution memastikan bahwa pencari kerja (yang diidentifikasi berdasarkan userId, sessionId, dan domain) memiliki pengalaman yang konsisten. Catatan: Kolom ini harus di-obfuscate.

• Peningkatan penelusuran.Algoritme penyesuaian didasarkan pada informasi yang diberikan di kolom RequestMetadata bersama dengan data pencari kerja yang Anda berikan. Hal ini akan meningkatkan relevansi hasil penelusuran.

Operator penelusuran

Operator	Deskripsi
( )	Kelompokkan satu atau beberapa kata kunci bersama-sama.
DAN	Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator.
ATAU	Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator.
NOT	Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci, dalam tanda kurung, tepat setelah operator.
-	Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci yang ditambahkan ke operator.

Contoh:

• "software OR java" menampilkan tugas dengan software "software" atau "java" dalam metadatanya.

• "software" -java menampilkan tugas yang relevan dengan "software", tetapi mengecualikan tugas yang relevan dengan "java".

• "(software OR java) AND (marketing)" menampilkan lowongan yang relevan dengan "software" dan "pemasaran", dan pekerjaan yang relevan dengan "java" dan "pemasaran".

Kueri pencari kerja

Istilah penelusuran juga dapat dideteksi sebagai entitas terkait pekerjaan sebenarnya. Misalnya, jika kuerinya adalah untuk 'magang', Cloud Talent Solution akan memperlakukan ini sebagai jenis pekerjaan "INTERN" dan memfilter pekerjaan yang hanya memiliki EMPLOYMENT_TYPE - INTERN. Oleh karena itu, meskipun peserta magang sudah tentu ada dalam deskripsi pekerjaan, jenis pekerjaan tersebut tidak akan ditampilkan jika jenis pekerjaan untuk lowongan itu ditetapkan ke tempat lain.

Sangat penting untuk menentukan jenis pekerjaan untuk setiap pekerjaan. Tidak melakukannya akan berdampak negatif pada pengalaman pencari kerja.

Pemecahan masalah

Setiap permintaan penelusuran menghasilkan requestID penelusuran unik dalam sistem kami yang digunakan untuk melacak parameter penelusuran tersebut serta responsnya. Hal ini sangat penting dalam memecahkan masalah yang terkait dengan penelusuran tertentu, permintaan CRUD, dan harus dicatat ke dalam log dengan tepat. requestId ditampilkan di dalam kolom ResponseMetadata di isi respons penelusuran. atau objek respons panggilan CRUD terkait.

Untuk masalah dukungan yang terkait dengan relevansi, pertanyaan penelusuran, pertanyaan pengindeksan, dll., harap ajukan tiket kepada tim dukungan kami, dan sertakan ID permintaan yang relevan atau minta sendiri ID permintaan.

Jumlah hasil

Jumlah hasil digunakan untuk mengomunikasikan jumlah hasil penelusuran kepada pencari pekerjaan. Ini tidak selalu sesuai dengan hasil histogram atau jumlah tugas sebenarnya yang ditampilkan. Penelusuran Lowongan menampilkan maksimum 5.000 tugas.

Penomoran halaman

Secara default, Penelusuran Lowongan menampilkan 100 hasil per halaman (atau kurang, jika jumlah total hasil kurang dari 100). Anda dapat menerapkan penomoran halaman menggunakan kolom yang terkait dengan fitur ini.

Catatan: Jika jumlah total hasil melebihi maksimum 5.000, semua halaman setelah halaman yang berisi hasil ke-5.000 akan kosong.

• pageSize: Jumlah hasil yang ditampilkan per halaman.
• nextPageToken: Token unik, yang ditampilkan beserta hasil setiap halaman hasil penelusuran, yang menentukan posisi awal untuk halaman hasil berikutnya. Kolom ini dibiarkan kosong jika tidak ada hasil lainnya.
• offset: Menentukan offset antara peringkat relevansi dari tugas yang ditampilkan di bagian atas halaman tertentu dan 1 (Tugas yang paling relevan yang ditampilkan). Sebagai contoh, pengguna melakukan penelusuran dan pageSize ditetapkan ke 10. Halaman pertama menampilkan tugas #1 di bagian atas sehingga nilai offset untuk halaman ini adalah 0. Halaman berikutnya menampilkan tugas #11 di bagian atas; offset untuk halaman ini adalah 10.

Setel ukuran halaman ke 20 hasil atau kurang untuk menghindari masalah latensi. Sebagai praktik terbaik, lakukan panggilan penelusuran terpisah per halaman yang dirender kepada pencari kerja. Alternatifnya, panggilan penelusuran tunggal untuk menampilkan lebih banyak tugas dan pemberian nomor halaman di sisi klien, menghambat kemampuan model machine learning untuk belajar secara akurat melalui Framework Analytics Tugas.

Pemeriksaan ejaan

Periksa ejaan adalah fitur permintaan penelusuran Cloud Talent Solution yang memperhitungkan istilah penelusuran yang berpotensi salah eja, mengoreksinya, dan menampilkan hasil berdasarkan kueri yang telah dikoreksi. Misalnya, saat fitur periksa ejaan diaktifkan, jika pencari kerja menelusuri "manaer", bukan "manager", Cloud Talent Solution akan menampilkan tugas untuk "manager". Pemeriksaan ejaan dapat diaktifkan/dinonaktifkan dengan menetapkan kolom disableSpellCheck dari JobQuery. Jika pemeriksaan ejaan diaktifkan, kueri yang telah dikoreksi dapat ditemukan dalam respons penelusuran, di kolom spellResult.