Validasi kategori
Kategori produk menggambarkan apa itu item, biasanya sebagai hierarki dari root yang luas ke daun yang spesifik — misalnya, ["Footwear", "Athletic", "Running Shoes"]. Kategori yang akurat menjaga katalog Anda tetap bersih dan memberi makan proses hilir seperti klasifikasi dan kepatuhan perdagangan, di mana item yang mis-kategorisasi dapat menghasilkan hasil yang salah.
Katalog mengumpulkan kesalahan kategori seiring waktu — dari entri manual, feed pemasok, atau migrasi antar sistem. Validasi Kategori Zonos memeriksa apakah kategori yang ditetapkan untuk item benar-benar menggambarkan item tersebut, dan ketika tidak, menyarankan kategori yang lebih baik yang diambil dari kategori yang sudah digunakan organisasi Anda.
Cara kerjanya
Validasi Kategori Zonos menggunakan AI untuk menilai apakah hierarki kategori yang Anda berikan dengan benar menggambarkan item, berdasarkan name item dan detail tambahan apa pun yang Anda berikan seperti brand, material, dan description.
Untuk setiap item, ia mengembalikan verdict dari CORRECT atau WRONG bersama dengan skor kepercayaan. Ketika verdict adalah WRONG, ia mengembalikan daftar kategori yang disarankan secara bertingkat sehingga Anda dapat memperbaiki penugasan. Saran diambil dari pohon kategori organisasi Anda — kumpulan jalur kategori yang digunakan organisasi Anda — dan kategori apa pun yang Anda kirimkan secara otomatis ditambahkan ke pohon tersebut, sehingga pohon yang terpelihara dengan baik menghasilkan saran yang lebih baik seiring waktu.
Ini adalah endpoint batch — Anda dapat memvalidasi banyak item dalam satu permintaan, dan hasilnya dikembalikan dalam urutan yang sama dengan input.
Verdict dan kepercayaan
Setiap hasil mencakup verdict:
CORRECT— item plausibel termasuk dalam kategori yang ditetapkan.WRONG— item tidak termasuk dalam kategori yang ditetapkan.
Setiap hasil juga mencakup confidenceScore antara 0.0 dan 1.0 yang menunjukkan seberapa percaya diri model terhadap verdict yang dikembalikan. Skor mencerminkan kepastian dalam verdict itu sendiri, jadi hasil WRONG yang percaya diri memiliki confidenceScore tinggi seperti halnya yang CORRECT percaya diri. Ketika verdict adalah WRONG, daftar suggestedCategories berisi hierarki kategori alternatif, masing-masing dengan nilai confidence dan diurutkan dari yang paling mungkin ke yang paling sedikit. Ketika verdict adalah CORRECT, suggestedCategories kosong.
Kami merekomendasikan menggunakan skor kepercayaan untuk memutuskan hasil mana yang akan diterima secara otomatis dan mana yang akan dialihkan untuk tinjauan manual.
Validasi kategori
Untuk memvalidasi kategori, gunakan mutasi categoriesValidate. Setiap item memerlukan name dan hierarki categories untuk divalidasi. Anda dapat secara opsional menyertakan brand, material, description, amount, currencyCode, globalTradeItemNumber, dan imageUrl untuk meningkatkan akurasi. Kirimkan beberapa item dalam satu permintaan untuk memvalidasi secara massal.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}Dalam contoh di atas, kategori item pertama dikonfirmasi sebagai CORRECT dengan kepercayaan tinggi dan tanpa saran. Item kedua dengan percaya diri ditandai WRONG, dan daftar suggestedCategories mengusulkan kategori yang lebih sesuai yang disusun berdasarkan kepercayaan.
Kelola pohon kategori Anda
Pohon kategori organisasi Anda adalah kumpulan jalur kategori yang diketahui Zonos digunakan organisasi Anda. Validasi Kategori menarik suggestedCategories dari pohon ini, jadi menjaga akurasi dan kelengkapannya secara langsung meningkatkan kualitas saran. Kategori yang Anda kirimkan ke categoriesValidate secara otomatis ditambahkan ke pohon, tetapi Anda juga dapat mengelolanya secara langsung.
Setiap kategori adalah hierarki yang disimpan sebagai array path, dari root yang luas ke daun yang spesifik — misalnya, ["Footwear", "Athletic", "Running Shoes"].
Cantumkan kategori Anda
Gunakan kueri categories untuk mengambil pohon kategori organisasi Anda. Hasil diberi halaman.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Tambahkan kategori
Gunakan mutasi categoriesCreate untuk menambahkan satu atau lebih jalur kategori ke pohon Anda. Ini berguna untuk memberi benih pohon sebelum validasi sehingga saran dapat menggambar pada taksonomi lengkap Anda.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Perbarui atau hapus kategori
Gunakan mutasi categoryUpdate untuk memperbaiki path kategori berdasarkan id nya, atau gunakan mutasi categoryDelete untuk menghapus kategori yang tidak lagi berlaku. Memangkas kategori yang ketinggalan zaman atau tidak benar menjaga saran tetap relevan.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Untuk menghapus kategori, berikan id ke mutasi categoryDelete. Ini mengembalikan SUCCESS atau FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Validasi Kategori
Periksa apakah kategori yang ditetapkan untuk item sesuai dengan produk, dan dapatkan saran kategori yang lebih baik saat tidak sesuai.