Prabaca blok — jendela prabaca blok
Prabaca blok — jendela prabaca yang menunjukkan hasil kerja blok secara real-time. Ini sama di layar pengaturan blok rekomendasi dan dinamis dan dibuka dengan tombol «Buka dalam modal».
Mengapa ini diperlukan
Ketika Anda mengatur blok (strategi, filter, audiens) — Anda ingin segera memahami produk apa yang akan muncul dengan pengaturan tersebut. Prabaca blok memungkinkan Anda memeriksa ini tanpa menerbitkan blok di situs, tanpa keluar dari admin.
Tab Dasar — daftar produk
Jendela terdiri dari tiga tab: Dasar | Penjelasan | Investigasi.
Tab pertama — Dasar. Menampilkan tabel produk yang akan muncul di blok dengan pengaturan saat ini:
- Produk dimuat secara otomatis saat menggulir tabel ke bawah.
- Di tabel — prabaca kartu (nama, gambar, penanda, metadata singkat).
- Untuk blok Produk serupa, prabaca dibangun berdasarkan blok yang disimpan — di layar ada petunjuk "Prabaca dihasilkan berdasarkan blok yang disimpan — perubahan formulir akan diterapkan setelah disimpan". Untuk melihat hasil perubahan, simpan blok terlebih dahulu.
Tab Penjelasan — mengapa produk ada di hasil
Tab kedua — Penjelasan. Ini menjawab pertanyaan "mengapa produk ini muncul di blok": di bawah setiap kartu produk ditampilkan lencana dengan alasan pemilihan — misalnya, "Dipesan bersama", "Atribut cocok", "Kategori yang sama", "Dalam peringkat tren", "Dilihat", "Digantikan sebagai populer".
Lencana diurutkan berdasarkan makna: pertama penggantian hasil (fallback ke produk populer), kemudian pemilihan (mengapa produk ini ada di sini), kemudian peringkat (mengapa ia berada di posisi ini) dan terakhir penurunan (misalnya, "Lebih rendah — perbedaan harga" — produk diturunkan karena perbedaan harga).
Penjelasan menjelaskan hasil untuk setiap produk — apa yang berfungsi untuk kartu tertentu. Investigasi menunjukkan gambaran untuk seluruh permintaan — aturan audiens mana yang diterapkan, peringatan apa yang diberikan sistem, apakah fallback diaktifkan. Jika tidak ada alasan pemilihan, tab akan menampilkan pesan seperti "Tidak ada data untuk penjelasan" — ini normal, misalnya untuk prabaca kosong.
Tab Investigasi — diagnosis
Tab ketiga — Investigasi — diperlukan untuk debugging. Di sini terlihat apa yang terjadi "di balik layar" saat membentuk hasil:
| Bagian di layar | Apa artinya |
|---|---|
| Aturan audiens diterapkan | Aturan audiens mana yang diterapkan untuk permintaan saat ini. Lihat Filter Audiens. |
| Peringatan | Diagnosis — misalnya, "set atribut kosong", "fallback memilih produk tidak dari kategori yang dipilih". |
| Fallback digunakan | Bendera: apakah jalur fallback diaktifkan (penampilan cadangan produk tren). |
| Konteks permintaan | Konteks permintaan — apa yang diterima sistem saat membangun prabaca (ID pengguna, keranjang, kategori yang dipilih, dll.). |
Jika tidak ada data untuk bagian tertentu, bagian ini tidak ditampilkan di tab Investigasi — ini bukan kesalahan.
Simulasi pengguna (ID) — prabaca "atas nama" pengguna
Di layar pengaturan blok di bagian Konteks untuk prabaca ditentukan konteks untuk prabaca. Bidang ini tergantung pada jenis blok:
| Jenis blok | Bidang konteks prabaca |
|---|---|
| Trending, Baru dilihat, Rekomendasi pribadi, Pembelian ulang | Simulasi pengguna (ID) |
| Pelengkap keranjang, Serupa keranjang | Uji keranjang (ID produk) |
| Serupa daftar keinginan | Uji daftar keinginan (ID produk) |
| Sering dipesan, Produk serupa (mode otomatis) | Uji ID produk |
Untuk blok yang dipersonalisasi, bidang ini adalah Simulasi pengguna (ID) (dalam diagnosis tab Investigasi, nilai ini disebut sebagai simulatedUserId). Masukkan ID pengguna mana pun — prabaca akan membangun hasil seolah-olah permintaan datang dari dia. Berguna untuk:
- Memeriksa rekomendasi pribadi (Rekomendasi pribadi, Pembelian ulang) untuk klien tertentu;
- Merekonstruksi keluhan seperti "saya tidak melihat produk yang tepat di blok" — masukkan ID-nya dan lihat apa yang akan dia lihat.
Tanpa menyebutkan Simulasi pengguna (ID), prabaca menggunakan konteks admin Anda sendiri, dan untuk blok yang dipersonalisasi, hasilnya bisa kosong atau tidak relevan.
Hak akses blocks.preview
Akses ke prabaca blok dikendalikan oleh hak terpisah blocks.preview di pohon hak.
Ini memungkinkan:
- Memberikan peran yang mengedit blok, tanpa akses ke prabaca (misalnya, untuk manajer konten "hanya-form").
- Menyembunyikan data sensitif dari beberapa admin yang dapat terungkap melalui Investigasi (bagian Konteks permintaan).
Berikan blocks.preview kepada mereka yang mengatur dan memeriksa hasil blok. Kepada manajer konten — hanya jika mereka perlu melihat hasil aktual blok sebelum publikasi.