OneTrace.pro Yardım merkezi

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.

“Öneri widget’ları” sayfası: istatistikleri ve web sitesi koduyla widget listesi

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.

Widget düzenleyicisi: “Ürünler” bölümü ve önizleme

Ö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.

  1. Görselden stil düğmesine tıklayın.
  2. 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.
  3. Widget'ın varyantları varsa stilin hangisine uygulanacağını seçin.
  4. 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.

Ekran görüntüsünden stil

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

“Gösterim” bölümü: kurallar, etkinleştirme ve web sitesi kodu

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.

“Varyantlar” bölümü: farklı başlık ve görünüme sahip B varyantı

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.

Widget istatistikleri: özet, günlük grafik ve varyant karşılaştırması

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.