Web sitesinde öneri widget'ları
Widget, web sitesinde hazır bir ürün bloğudur: ana sayfada “Bunlar da ilginizi çekebilir”, ürün sayfasında “Birlikte satın alınanlar”, sepette “Son görüntülenenler”. Widget'ı OneTrace.pro içinde ayarlarsınız ve web sitesine kısa bir kodu yalnızca bir kez eklersiniz. Sonrasında tür, görünüm ve etkinleştirme web sitesinde değişiklik yapmadan değiştirilir.
Çalışması için kurulu bir izleyici (Web sitesini bağlama), bir ürün kataloğu ve görüntüleme, sepet ve satın alma olayları (Öneriler ve ürün kataloğu) gerekir. Widget'ları “Sahip”, “Yönetici” ve “Müdür” oluşturabilir ve değiştirebilir.
Widget nasıl oluşturulur
- İletişim → Web sitesi bölümünü açın ve Widget'lar sekmesine geçin.
- Widget oluştur düğmesine tıklayın.
- Soldaki ayarları doldurun; sağda önizleme hemen görünür.
- Kaydet düğmesine tıklayın.

Ayarlar
| Alan | Neyi belirler |
|---|---|
| Ad | widget'ın adı; yalnızca yönetim panelinde görünür |
| Ne gösterilsin | öneri türü: Kişisel, Popüler, Yükselen trendler, Birlikte görüntülenenler, Birlikte satın alınanlar, Benzer, Son görüntülenenler |
| Kategori | popüler ve yükselen trend ürünler için: katalog kategorisinin id'si; boş bırakılırsa tüm katalog |
| Başlık | ürünlerin üstündeki metin, örneğin “Bunlar da ilginizi çekebilir” |
| Düzen | Izgara veya kaydırmalı Karusel |
| Satır başına kart | 1 ile 8 arası |
| Toplam ürün | 1 ile 24 arası |
| Vurgu rengi | fiyat ve düğme rengi; belirtilmezse web sitesinin metin rengi |
| Köşe yuvarlaklığı | görsellerin ve düğmenin köşeleri, 0 ile 32 px arası |
| Düğme | düğme metni, örneğin “Daha fazla bilgi”; boş bırakılırsa düğme olmaz |
| Fiyatı göster | kartta fiyat ve eski fiyat |
Önizleme
Önizleme, widget'ı web sitesindeki gibi, kataloğunuzdaki gerçek ürünlerle çizer. “Birlikte görüntülenenler” ve benzer türler için örnek olarak stoktaki ilk ürün alınır; id'si önizlemenin üstünde belirtilir. Uygun ürün yoksa görünümü değerlendirebilmeniz için gri yer tutucular gösterilir. Masaüstü / Telefon anahtarı alanı telefon genişliğine daraltır.

Web sitesinde düzen ekranın değil, ayrılan alanın genişliğine uyum sağlar: dar bir sütunda ve telefonda kartlar satır başına iki tane olacak şekilde dizilir. Widget, yazı tipini ve metin rengini web sitesinden alır.
Web sitesi kodu
Listedeki her widget'ın bir Web sitesi kodu bloğu vardır. Bu kodu sayfa şablonunda bloğun görünmesi gereken yere ekleyin:
<div data-cdp-widget="a1b2c3d4e5f6" data-item="SKU-1"></div>
Öznitelikler:
data-item: sayfadaki ürünün id'si veya virgülle ayrılmış sepet ürünleri:data-item="SKU-1,SKU-7". “Birlikte görüntülenenler”, “Birlikte satın alınanlar” ve “Benzer” türleri için zorunludur; değeri sayfa şablonundan ekleyin.data-category: farklı sayfalarda farklı kategoriler gerekiyorsa popüler ürünler için kategori id'si.data-exclude: gösterilmemesi gereken ürünlerin virgülle ayrılmış id'leri, örneğin zaten sepette olanlar.
Kişisel ve son görüntülenen ürünler ziyaretçiye göre seçilir, bunlar için data-item gerekmez.
Uygun ürün yoksa sayfadaki alan boş kalır; sayfa düzeni bozulmaz.
Etkinleştirme ve devre dışı bırakma
Widget kartındaki Web sitesinde göster anahtarı widget'ı web sitesinde değişiklik yapmadan kapatır: durum “Duraklatıldı” olur ve sayfadaki blok temizlenir. Yeniden açtığınızda ürünler geri gelir. Çöp kutusu simgeli düğme widget'ı tamamen siler: web sitesinde artık gösterilmez.
Kalem simgeli düğme Widget'ı düzenle penceresini açar. Değişiklikler web sitesinde sayfanın bir sonraki yüklenişinde görünür, kodu değiştirmeniz gerekmez.
İstatistikler
Widget adının altında 30 günlük istatistikler bulunur:
| Gösterge | Nasıl hesaplanır |
|---|---|
| Gösterimler | widget en az yarısı kadar ziyaretçinin görüş alanına girdi. Bloğa kadar kaydırılmadan yapılan sayfa yüklemesi sayılmaz; bu yüzden sayfanın altındaki bir widget'ın CTR'si gerçeği yansıtır |
| Tıklamalar | ürün kartlarına tıklamalar |
| CTR | tıklamaların gösterimlere bölümü |
| Satın almalar | aynı müşterinin, ürüne tıkladıktan sonraki 7 gün içinde o ürünü satın alması |
| Gelir | bu satın almaların toplamı |
Önerilerin web sitesindeki türlere göre genel etkisi Öneriler bölümündedir.
Tek sayfalı web siteleri
İzleyici widget'ları sayfa yüklendikten sonra, yeni öğeler göründüğünde ve data-item değiştiğinde kendisi bulur. Bu nedenle React, Vue ve benzeri teknolojilerle yapılmış sitelerde özniteliği değiştirmek yeterlidir; blok yeniden çizilir.
Ürünlerin öznitelikler değişmeden güncellenmesi gerekiyorsa (örneğin sepet değiştikten sonra) şunu çağırın:
cdp.widgets({ force: true });
Widget yerine kendi kodunuz
Geliştiriciler öneri bloğunu yönetim panelinde ayar yapmadan koddan oluşturabilir:
window.addEventListener('load', () => {
cdp.renderRecommendations('#recs', {
type: 'viewed_with', item: 'SKU-1', title: 'Birlikte görüntülenenler', layout: 'carousel', columns: 4,
});
});
Blok widget ile aynı görünür; gösterimler ve tıklamalar kendiliğinden sayılır. İzleyici yüklenmeden önce de çağırabilirsiniz: çağrı kuyrukta bekler. Öğenin sayfada zaten bulunması gerekir; bu yüzden örnekteki çağrı load olayını bekler. Boş sonuç öğeyi temizler. Renk, köşe yuvarlaklığı ve düğmeyi yönetim panelindeki widget'ta ayarlamak daha kolaydır.