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, gösterim kuralları 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; diğer kullanıcılar ayarları ve istatistikleri görür ancak kaydedemez.
Widget listesi
Web sitesi → Widget’lar sayfasını açın. Her widget'ın kartında durum, 30 günlük istatistikler, varsa varyant karşılaştırması ve web sitesi kodu bulunur.

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.
Widget oluşturmak için Widget oluştur düğmesine tıklayın. Değiştirmek için widget'ın adına veya kalem simgeli düğmeye tıklayın. Her iki işlem de düzenleyici sayfasını açar.
Widget düzenleyicisi
Solda ayarlar dört bölümdedir: Ürünler, Görünüm, Gösterim ve Varyantlar. Sağda önizleme bulunur: widget'ı web sitesindeki gibi, kataloğunuzdaki gerçek ürünlerle çizer. Bir bölümde hata varsa adının yanında bir işaret görünür. Kaydet düğmesine tıklayın; değişiklikler web sitesinde sayfanın bir sonraki yüklenişinde görünür, kodu değiştirmeniz gerekmez. Kaydedilmemiş değişikliklerle sayfadan ayrılmaya çalışırsanız tarayıcı sizi uyarır.

Önizlemenin üstündeki Masaüstü / Telefon anahtarı her iki düzeni de gösterir. Web sitesinde düzen ekranın değil, ayrılan alanın genişliğine uyum sağlar: dar bir sütunda widget telefondaki gibi görünür. Kendi değerlerinizi belirtmezseniz widget yazı tipini ve metin rengini web sitesinden alır.
Ürünler
| 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, Yeniden alma zamanı |
| Kategori | popüler ve yükselen trend ürünler için: katalog kategorisinin id'si; boş bırakılırsa tüm katalog |
| Toplam ürün | 1 ile 24 arası |
| Önizleme için ürün | “Birlikte görüntülenenler”, “Birlikte satın alınanlar” ve “Benzer” için: önizlemenin oluşturulacağı ürünün id'si; boş bırakılırsa stoktaki ilk ürün |
Uygun ürün yoksa görünümü değerlendirebilmeniz için önizlemede gri yer tutucular gösterilir.
Görünüm
| Alan | Neyi belirler |
|---|---|
| Başlık | ürünlerin üstündeki metin, örneğin “Bunlar da ilginizi çekebilir” |
| Düğme | karttaki düğmenin metni, örneğin “Daha fazla bilgi”; boş bırakılırsa düğme olmaz |
| Düzen | Izgara veya kaydırmalı Karusel |
| Satır başına kart | 1 ile 8 arası |
| Fiyatı göster | kartta fiyat |
| Hazır stiller | “Web sitesindeki gibi”, “Kartlar”, “Minimal”, “Kontrast”: görünüm alanlarını doldurur, ardından bunları değiştirebilirsiniz |
| Kartta ne gösterilsin | marka, eski fiyat, indirim rozeti, kartın çerçevesi ve gölgesi |
| Görsel oranları ve Görsel | 1:1, 3:4 veya 4:3; görsel bütünüyle gösterilir ya da kenarları kırpılarak alanı doldurur |
| Renkler | vurgu, kart arka planı, görsel arka planı, metin, fiyat, düğme ve düğme metni; renk belirtilmezse web sitesindeki gibi, görsel arka planı ise beyaz |
| Metin boyutu, Başlık boyutu, Başlık | web sitesi yazı tipine göre yüzde olarak boyutlar ve başlığın hizalaması |
| Köşe yuvarlaklığı, Kartlar arası boşluk, Kart iç boşluğu | piksel cinsinden |
| Karusel okları | karuselin kenarlarındaki kaydırma düğmeleri |
| Telefon | dar ekranda satır başına kart sayısı (1 ile 3 arası) ve ayrı bir düzen, örneğin ızgara yerine karusel |
| Özel CSS | widget sınıfları için kurallar: .cdp-rec__name, .cdp-rec__price, .cdp-rec__button ve diğerleri |
Özel CSS yalnızca bu widget'ın içinde geçerlidir ve sayfanın geri kalanını değiştirmez. İçinde harici kaynak yüklenemez: @import, url() ve benzeri yapılar kaydederken reddedilir.
Projede birden fazla dil varsa başlığın üzerinde Metin dili seçicisi görünür. Varsayılan dilde Başlık ve Düğme doldurulur, diğer dillerde bunların çevirileri; boş alan varsayılan dildeki metni gösterir. Ziyaretçi başlığı ve düğmeyi kendi dilinde, yani izleyicinin profile gönderdiği dilde görür (Müşteri dili); çeviri yoksa varsayılan dilde. Fiyatlar ziyaretçinin dilinin biçiminde gösterilir.
Görselden stil
Görünüm bölümündeki Görselden stil düğmesi, ürün kartlarının olduğu bir ekran görüntüsüne göre görünüm seçer: kendi web sitenizden veya beğendiğiniz bir siteden.
- Görselden stil düğmesine tıklayın.
- Görseli sürükleyip bırakın, panodan yapıştırın (Ctrl+V) veya bir dosya seçin: 3 MB'a kadar PNG, JPEG veya WebP.
- Widget'ın varyantları varsa stilin hangisine uygulanacağını seçin.
- Stili uyarla düğmesine tıklayın.
Yapay zekâ renkleri, boyutları, köşe yuvarlaklıklarını, düzeni ve kartta gösterilecekleri doldurur; ayarlarda karşılığı olmayanları Özel CSS alanına ekler. Her değer elle girişteki gibi kontrol edilir, uygun olmayanlar atılır. Sonuç bir taslaktır: önizlemeye bakıp kaydedin ya da Geri al düğmesine tıklayın.

Görsel saklanmaz. Stil seçimi gerçek kullanıma göre proje bakiyesinden ödenir; bakiye yetmiyorsa veya yapay zekâ tarifeye dahil değilse düğme kullanılamaz ve altında nedeni yazılır.
Gösterim

| Alan | Neyi belirler |
|---|---|
| Web sitesinde göster | listedeki gibi widget'ı açar veya kapatır |
| Yalnızca şu sayfalarda ve Şu sayfalar hariç | alan adı olmadan sayfa adresleri, her satıra bir tane; * herhangi bir karakter demektir, örneğin /catalog/*. Boş bırakılırsa tüm sayfalarda |
| Cihazlar | tümü, yalnızca bilgisayarlar veya yalnızca telefonlar |
| Ziyaretçiler | tümü, yalnızca yeni veya yalnızca geri dönen ziyaretçiler |
| Yalnızca segment üyelerine ve Segment üyeleri hariç | ziyaretçinin segmentleri; üyelik her gösterimde profile göre kontrol edilir |
Kuralları, widget her yüklendiğinde sunucu kontrol eder. Kurallara uymayan durumda sayfadaki alan boş kalır ve sayfa düzeni bozulmaz. Kurallar abonelik formlarındakiyle aynıdır.
Web sitesi kodu da buradadır; aşağıda anlatılmıştır.
Varyantlar
Varyantlar, hangi başlığın, öneri türünün veya görünümün daha fazla tıklama ve satın alma getirdiğini test etmenizi sağlar. Widget'ın ana ayarları A varyantıdır. Varyant ekle düğmesine tıklayın; en fazla üç varyant ekleyebilirsiniz: B, C ve D. Her birinde şunları değiştirebilirsiniz:
- öneri türü: Ne gösterilsin;
- çevirileriyle birlikte Başlık ve Düğme;
- düzen ve tüm görünüm ayarları.
Boş alanlar A varyantından alınır.

Ziyaretçiler varyantlar arasında eşit dağıtılır ve her ziyaretçi her zaman aynı varyantı görür. Önizlemenin üstündeki seçici, seçilen varyantı gösterir. Karşılaştırma sonuçları düzenleyicinin altındaki istatistiklerde bulunur.
Web sitenizde görüntüleyin
Önizlemenin üstündeki Web sitenizde görüntüleyin düğmesi, web sitenizin bir sayfasını widget'ın kaydedilmiş hâliyle açar. Widget kodunun bulunduğu sayfanın adresini girin, bir varyant seçin ve Aç düğmesine tıklayın.
Bu şekilde widget kapalı olsa veya sayfa gösterim kurallarına uymasa bile görünür. Bu moddaki gösterimler ve tıklamalar istatistiklere girmez. Bağlantı bir gün geçerlidir; sekme açık kaldığı sürece görüntüleme modu web sitesindeki sayfalar arasında gezinirken de korunur. Kaydedilmemiş değişiklikler web sitesinde görünmez; önce kaydedin.
Web sitesi kodu
Widget'ın kodu listedeki kartında ve düzenleyicinin Gösterim bölümünde bulunur. 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.
İstatistikler
Düzenleyicinin altında widget'ın 7, 30 veya 90 günlük istatistikleri bulunur: özet, günlük grafik ve varyant karşılaştırması. Grafiğin üstünden göstergeyi seçin: gösterimler, tıklamalar, CTR veya gelir. Widget'ın varyantları varsa grafikte her birinin kendi çizgisi olur.

| 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ı; grafikte ilk tıklamanın gününde |
| Gelir | bu satın almaların toplamı |
Günler UTC'ye göre hesaplanır. Web sitenizde görüntüleme modundaki gösterimler ve tıklamalar sayılmaz.
Varyant tablosunda her varyantın gösterimleri, tıklamaları, CTR'si, satın almaları ve geliri yer alır. Altında, gösterim başına tıklamalara ve satın almalara göre bir sonuç bulunur: hangi varyantın daha iyi olduğu ve buna güvenmek için yeterli veri olup olmadığı. Veri az olduğu sürece sonuç bunu açıkça belirtir; varyantı rastlantısal bir farka göre seçmek yerine bekleyin.
Ö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. Görünüm, yönetim panelindeki widget'larla aynı seçeneklerle ayarlanır, örneğin imageRatio: '4:3', imageFit: 'cover', imageBackground: 'transparent', background: '#111827', textColor: '#f9fafb'; imageBackground bir renk veya transparent olur. Gösterim kuralları ve varyantlar yalnızca yönetim panelindeki widget'larda kullanılabilir.