Dasar-dasar penelusuran (v3)

Cloud Talent Solution memungkinkan pengguna menelusuri lowongan yang telah Anda simpan di indeks Cloud Talent Solution. Dokumen ini memandu Anda mempelajari berbagai 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 dalam isi.

Kolom wajib diisi

Kolom berikut wajib diisi:

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

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

Kolom yang biasa digunakan

• JobQuery: Menentukan kriteria tugas yang akan dicocokkan. Filter ini mencakup lokasi, kategori pekerjaan, jenis pekerjaan, kueri teks, perusahaan, dll. Lihat Filter Penelusuran untuk mengetahui 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 pengurutan untuk tugas yang ditampilkan. Lihat referensi untuk mengetahui nilai yang diizinkan. Secara default, pengurutan dilakukan berdasarkan relevansi, menurun (RELEVANCE_DESC).

Batas relevansi dan perluasan lokasi/kategori

Untuk menampilkan lebih banyak lowongan untuk penelusuran Anda, dua kolom berikut akan melonggarkan batasan relevansi:

• enableBroadening: Menetapkan ini ke true akan melonggarkan pembatasan pada lokasi dan kategori lowongan permintaan penelusuran, untuk menampilkan lebih banyak hasil. Misalnya, jika permintaan penelusuran menentukan lowongan dalam radius 3,2 km dari Anytown, WA, menetapkan tanda ini ke true juga dapat menampilkan lowongan dari NextTownOver, WA.

• disableKeywordMatch: Flag ini bernilai salah secara default. Menetapkan tanda ini ke salah memungkinkan Cloud Talent Solution menambahkan lowongan yang relevan dengan kueri penelusuran ini dengan lowongan yang juga cocok dengan string kueri yang tepat 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 pentingnya objek ini:

• Konsistensi pengguna. Cloud Talent Solution menjalankan beberapa versi model yang mendasarinya secara bersamaan dalam upaya untuk meningkatkan relevansi penelusuran. Isi kolom ini untuk memastikan pencari kerja memiliki pengalaman yang konsisten. Cloud Talent Solution memastikan bahwa pencari kerja (diidentifikasi oleh 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 beserta data pencari kerja yang Anda berikan. Hal ini akan meningkatkan relevansi hasil penelusuran.

Operator penelusuran

Operator	Deskripsi
( )	Mengelompokkan satu atau beberapa kata kunci.
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 salah satu "software" atau "java" dalam metadata-nya.

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

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

Kueri pencari kerja

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

Sangat penting untuk menentukan jenis pekerjaan untuk setiap lowongan. Jika tidak dilakukan, pengalaman pencari kerja akan terpengaruh secara negatif.

Pemecahan masalah

Setiap permintaan penelusuran menghasilkan requestID penelusuran unik di sistem kami yang digunakan untuk melacak parameter penelusuran tersebut serta responsnya. Hal ini sangat penting dalam memecahkan masalah terkait penelusuran tertentu, permintaan CRUD, dan harus dicatat 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, dsb., harap ajukan tiket kepada tim dukungan kami, dan sertakan ID permintaan yang relevan atau permintaan itu sendiri.

Jumlah hasil

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

Penomoran halaman

Secara default, Penelusuran Lowongan menampilkan 100 hasil per halaman (atau lebih sedikit, jika jumlah total hasil kurang dari 100). Anda dapat menerapkan pempaginan 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 dengan hasil setiap halaman hasil penelusuran, yang menentukan posisi awal untuk halaman hasil berikutnya. Kolom ini dibiarkan kosong jika tidak ada lagi hasil.
• offset: Menentukan offset antara peringkat relevansi tugas yang ditampilkan di bagian atas halaman tertentu dan 1 (Tugas yang paling relevan ditampilkan). Misalnya, pengguna melakukan penelusuran dan pageSize ditetapkan ke 10. Halaman pertama menampilkan pekerjaan #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.

Tetapkan ukuran halaman ke 20 hasil atau kurang untuk menghindari masalah latensi. Sebagai praktik terbaik, buat panggilan penelusuran terpisah per halaman yang dirender kepada pencari kerja. Alternatifnya, satu panggilan penelusuran untuk menampilkan sejumlah besar tugas dan membuat penomoran halaman di sisi klien, akan menghambat kemampuan model machine learning untuk belajar secara akurat melalui Framework Analisis Tugas.

Pemeriksaan ejaan

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