Mengontrol Metafield Produk  yang Dapat Digunakan Shoply

Asisten Belanja AI Anda dirancang untuk membantu pelanggan dengan membaca informasi produk, 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 seharusnya tetap privat. Dalam kasus ini, Anda mungkin ingin Shoply tidak menggunakan metafield tersebut saat menjawab pertanyaan pelanggan.

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

Panduan ini menjelaskan mengapa pengaturan ini berguna dan cara mengonfigurasinya.

Di mana menemukan Pengaturan Lanjutan?

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

Pengaturan Daftar Blokir

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

blacklist_product_fields

Daftar key metafield yang persis (nama field) yang ingin Anda kecualikan. Nama field harus sama persis dengan key metafield seperti yang muncul di 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 daftar blokir, karena Shoply menggunakan metafield brand untuk menyimpan informasi vendor karena alasan kompatibilitas lama.

blacklist_display_filters

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

Ini berguna ketika sebuah metafield berisi informasi produk yang bernilai dan sebaiknya diketahui AI, tetapi tidak cocok dijadikan filter yang ditujukan untuk pelanggan.

Contoh:

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

blacklist_namespaces

Daftar namespace  lengkap yang ingin Anda abaikan oleh AI.

Contoh:

• RenterInfo

Jika sebuah metafield termasuk dalam namespace yang masuk daftar blokir, semua field dalam namespace tersebut akan dikecualikan secara otomatis.

Ini berguna ketika seluruh namespace bersifat internal atau sensitif.

Tips Memasukkan ke Daftar Blokir

Disarankan untuk dimasukkan ke daftar blokir:

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

Hindari memasukkan field berikut ke daftar blokir:

• 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 praktis untuk memberi label pada produk, tetapi tag disimpan sebagai daftar string datar dan tidak dapat digunakan sebagai filter terstruktur. Pengaturan ini memungkinkan Anda mengonversi tag bergaya key:value menjadi metafield yang tepat yang dapat diindeks dan digunakan Shoply untuk pemfilteran.

Cara kerjanya:

Atur split_tag_to_metafield_by ke karakter pemisah yang digunakan dalam tag Anda. Shoply akan memisahkan setiap tag berdasarkan karakter tersebut, memperlakukan sisi kiri sebagai key metafield dan sisi kanan sebagai nilai, lalu mengindeksnya sesuai kebutuhan.

Misalnya, jika produk Anda memiliki tag seperti:

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

Menetapkan pemisah ke ":" akan menghasilkan metafield:

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

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

Contoh konfigurasi:

{
  "split_tag_to_metafield_by": ":"
}

Kapan menggunakannya:

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

Mengontrol Tampilan Produk

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

hide_discount

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

hide_price

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

hide_review

Jika 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:

{
  "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.