Cara Mengontrol Metafield Produk yang Dapat Digunakan Shoply

Asisten Belanja AI Anda dirancang untuk membantu pelanggan dengan membaca informasi produk Anda, menjawab pertanyaan, dan memberikan rekomendasi.

Namun, tidak semua data produk ditujukan untuk pelanggan. Beberapa metafield produk mungkin berisi informasi internal (seperti margin keuntungan), detail pemasok, atau atribut lain yang harus tetap privat. Dalam kasus seperti ini, Anda mungkin memilih agar Shoply tidak menggunakan metafield tersebut saat menjawab pertanyaan pelanggan.

Shoply menggunakan AI untuk secara otomatis menentukan metafield mana yang dapat digunakan saat menjawab pertanyaan pelanggan. Namun, untuk memberi Anda kendali penuh, Shoply memungkinkan Anda menetapkan blacklist (pengecualian) untuk metafield produk tertentu atau seluruh namespace metafield.

Panduan ini menjelaskan mengapa hal ini berguna dan cara mengaturnya.

Di mana menemukan Advanced Settings?

Buka bagian “Settings” di konsol admin aplikasi, lalu gulir ke bawah ke bagian “Advanced Settings”. Di bagian ini, Anda dapat memberikan objek JSON untuk mengonfigurasi berbagai pengaturan.

Untuk kebijakan data yang lebih luas, lihat informasi apa saja yang dapat digunakan Shoply.

Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide. Click the screenshot to view it at full size.

Pengaturan Blacklist

Gunakan pengaturan ini untuk mencegah Shoply menggunakan metafield produk tertentu saat menjawab pertanyaan pelanggan.

Untuk menyembunyikan seluruh item alih-alih field individual, kecualikan seluruh produk dari pengindeksan.

`blacklist_product_fields`

Daftar key metafield yang persis sama (nama field) yang ingin Anda kecualikan. Nama field harus sama persis dengan key metafield sebagaimana muncul di dalam Shopify.

Contoh key metafield:

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

Catatan: jika Anda tidak ingin menampilkan vendor produk, Anda perlu menambahkan “brand” ke blacklist, karena Shoply menggunakan metafield brand untuk menyimpan informasi vendor karena alasan kompatibilitas lama.

`blacklist_display_filters`

Daftar key metafield yang persis sama untuk disembunyikan hanya dari UI filter/facet. Berbeda dengan blacklist_product_fields, field-field ini tetap tersedia untuk AI untuk menjawab pertanyaan pelanggan — hanya saja tidak ditampilkan sebagai filter yang dapat dipilih di antarmuka pencarian.

Untuk latar belakang tentang atribut mana yang ditampilkan, lihat bagaimana Shoply menghasilkan filter produk.

Ini berguna ketika sebuah metafield berisi informasi produk berharga yang sebaiknya diketahui AI, tetapi tidak masuk akal sebagai filter yang ditujukan untuk pelanggan.

Contoh:

warehouse_region — konteks yang membantu untuk AI, tetapi bukan filter yang berguna bagi pelanggan
care_instructions — baik untuk jawaban AI, tetapi bukan kategori filter yang bermakna

`blacklist_namespaces`

Daftar namespace secara keseluruhan yang ingin Anda abaikan oleh AI.

Contoh:

RenterInfo

Jika sebuah metafield termasuk dalam namespace yang di-blacklist, semua field dalam namespace tersebut akan dikecualikan secara otomatis.

Ini berguna ketika seluruh namespace bersifat internal atau sensitif.

Tips untuk Blacklist

Direkomendasikan untuk di-blacklist:

Kode pemasok
Detail gudang / inventaris
Catatan pemenuhan internal
Metafield yang digunakan oleh aplikasi lain
Field apa pun yang tidak boleh terlihat oleh pelanggan

Hindari mem-blacklist field seperti:

Judul produk
Deskripsi
Bahan
Ukuran, dimensi, atau spesifikasi
Bahan-bahan
Petunjuk perawatan
Nama/opsi varian

(Ini membantu AI memberikan jawaban yang lebih baik.)

Memperkaya Data Produk dari Tag

`split_tag_to_metafield_by`

Tag Shopify adalah cara yang praktis untuk memberi label pada produk, tetapi tag disimpan sebagai daftar string datar dan tidak dapat digunakan sebagai filter terstruktur. Pengaturan ini memungkinkan Anda mengubah tag bergaya key:value menjadi metafield yang benar sehingga dapat diindeks oleh Shoply dan digunakan untuk pemfilteran.

Cara kerjanya:

Setel split_tag_to_metafield_by ke karakter pemisah yang digunakan dalam tag Anda. Shoply akan membagi setiap tag berdasarkan karakter tersebut, memperlakukan sisi kiri sebagai key metafield dan sisi kanan sebagai nilainya, lalu mengindeksnya sesuai.

Sebagai contoh, jika produk Anda memiliki tag seperti:

plaintext


material:aluminum
color:matte-black
compatible-with:iPhone 15

Mengatur pemisah ke ":" akan menghasilkan metafield:

Key	Nilai
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

Metafield yang diindeks ini kemudian dapat digunakan sebagai filter facet di Shoply AI Search — sama seperti metafield bawaan Shopify.

Tag yang tidak mengandung pemisah akan diabaikan oleh pengaturan ini dan tetap menjadi tag biasa.

Contoh konfigurasi:

json


{
  "split_tag_to_metafield_by": ":"
}

Kapan menggunakan ini:

Toko Anda sudah menggunakan tag key:value untuk atribut (misalnya, dari impor massal atau aplikasi pihak ketiga)
Anda ingin menambahkan atribut yang bisa difilter tanpa membuat definisi metafield Shopify formal
Anda membutuhkan cara cepat untuk menampilkan data produk terstruktur ke Shoply tanpa memberi tag ulang pada katalog Anda

Mengontrol Tampilan Produk

Gunakan pengaturan ini untuk mengontrol informasi apa yang ditampilkan saat produk ditampilkan di chat atau antarmuka pencarian.

Untuk perubahan visual pada field yang Anda pertahankan, Anda dapat menyesuaikan styling product-card dengan CSS.

`hide_discount`

Saat diatur ke true, persentase diskon (misalnya, “-40%”) akan disembunyikan dari tampilan produk. Ini berguna jika Anda tidak ingin menonjolkan diskon kepada pelanggan.

`hide_price`

Saat diatur ke true, semua informasi harga akan disembunyikan, termasuk harga asli dan harga diskon. Gunakan ini jika Anda lebih suka pelanggan mengunjungi halaman produk untuk melihat harga, atau jika strategi harga Anda mengharuskan harga disembunyikan di antarmuka chat/pencarian.

`hide_review`

Saat diatur ke true, rating ulasan tidak akan ditampilkan pada tampilan produk. Ini berguna jika Anda tidak ingin skor ulasan memengaruhi keputusan pelanggan di antarmuka chat/pencarian.

Contoh objek JSON yang valid

Berikut adalah contoh yang sepenuhnya valid:

json


{
  "blacklist_product_fields": [
    "profit_margin",
    "inventory_level"
  ],
  "blacklist_display_filters": [
    "product_type",
    "category_name",
    "warehouse_region",
    "care_instructions"
  ],
  "blacklist_namespaces": [
    "SupplierInfo"
  ],
  "split_tag_to_metafield_by": ":",
  "hide_discount": true,
  "hide_price": false,
  "hide_review": false
}

Anda dapat menghapus item yang tidak diperlukan, atau menambahkan key metafield dan namespace Anda sendiri. Atur opsi hide_* ke true atau false sesuai preferensi Anda.