Önizleme Modali — modaldaki blok önizlemesi
PreviewModal — tüm Wave-2 ayar ekranları için ortak bir modal, blokun gerçek zamanlı çalışma sonucunu gösterir. Ayar ekranlarında «Modalda Aç» butonuyla açılır.
Bunun amacı nedir
Bir bloğu (strateji, filtreler, kitle) ayarlarken, bu ayarlarla hangi ürünlerin sonuçlara gireceğini hemen anlamak istersiniz. PreviewModal, bunu bloğu sitede yayınlamadan ve admin paneli ile ön yüz arasında geçiş yapmadan kontrol etmenizi sağlar.
Sekme Temel — ürün listesi
İlk sekme — Temel. Mevcut blok ayarlarıyla API'nin döndüreceği ürünlerin tablosunu gösterir:
- Yükleme sonsuz kaydırma ile
NewBlockPreviewTablebileşeni üzerinden yapılır. - Tablo, kartların önizlemesini (isim, resim, etiket, kısa meta veriler) içerir.
- Liste, ana ekrandaki blok ayarları değiştiğinde otomatik olarak güncellenir.
Sekme İnceleme — hata ayıklama
İkinci sekme — İnceleme — hata ayıklama için gereklidir. Burada, sonuçların oluşturulması sırasında "kaputun altında" neler olduğunu görebilirsiniz:
| Alan | Anlamı |
|---|---|
| appliedAudienceRule | Mevcut sorgu için hangi kitle kuralının çalıştığını gösterir. Bakınız Kitle Filtre. |
| warnings | Hata ayıklama — örneğin, "özellik seti boş", "fallback, seçilen kategoriden ürünler buldu". |
| fallbackUsed | Bayrak: fallback yolunun (trend ürünlerin yedek gösterimi) çalıştırılıp çalıştırılmadığı. |
| contextEcho | Sorgu bağlamının yankısı — sistemin gerçekten aldığı (kullanıcı ID'si, sepet, seçilen kategoriler vb.). |
Eğer arka uç herhangi bir alan döndürmediyse — ilgili İnceleme bölümü basitçe gizlenir, hata vermez. Bu, API'nin sorunsuz bir şekilde gelişimi için yapılmıştır.
Simüle Edilmiş kullanıcı ID'si — kullanıcı adına önizleme
Önizleme alanının altında Simüle Edilmiş kullanıcı ID'si girişi bulunmaktadır. Herhangi bir kullanıcının ID'sini girin — önizleme, sanki sorgu ondan gelmiş gibi sonucu oluşturacaktır. Kullanışlıdır:
- Belirli bir müşteri için kişisel önerileri (Kişisel öneriler, Tekrar satın alma) kontrol etmek;
- "Bloğumda yanlış ürünler var" gibi bir şikayeti yeniden oluşturmak — onun ID'sini girin ve ne göreceğini görün.
Simüle Edilmiş kullanıcı ID'si belirtilmeden, önizleme kendi admin bağlamınızı kullanır ve kişiselleştirilmiş bloklar için sonuç boş veya alakasız olabilir.
blocks.preview erişim hakkı
Blok önizleme admin uç noktasına erişim, yetki ağacında ayrı bir hak olan blocks.preview ile kontrol edilir.
Bu, şunları sağlar:
- Blokları düzenleyen bir role, önizleme erişimi olmadan yetki vermek (örneğin, içerik yöneticileri için "sadece-form").
- Bazı adminlerden, İnceleme aracılığıyla açığa çıkabilecek hassas verileri gizlemek (sorgu bağlamı, parametre yankısı).
Geliştiriciler ve QA için — her zaman blocks.preview verin. İçerik yöneticileri için — yalnızca yayınlamadan önce bloğun gerçek sonuçlarını görmeleri gerekiyorsa.