Öneriler ve ürün kataloğu
OneTrace.pro her müşteri için ürün seçer: popüler ürünler, “birlikte satın alınanlar”, benzer ürünler, son görüntülenenler ve kişisel bir seçki. Öneriler web sitesinde, e-postalarda, yolculuklarda ve kampanyalarda gösterilir. Çalışması için bir ürün kataloğu ile görüntüleme, sepet ve satın alma olayları gerekir.
Bölüm İletişim → Öneriler menüsünden açılır. Bölümü projenin tüm üyeleri görüntüleyebilir; feed bağlama, ayarları değiştirme ve yeniden hesaplamayı başlatma işlemlerini ise “Sahip”, “Yönetici” ve “Müdür” yapabilir.

Ürün kataloğu
Sayfanın üstünde katalogda kaç ürün olduğu, bunlardan kaçının stokta olduğu ve kaç kategori bulunduğu görünür. Katalog boş olduğu sürece önerilecek bir şey yoktur: bir feed bağlayın veya ürünleri API üzerinden yükleyin.
Feed nasıl bağlanır
- Ürün feed'leri bloğunda Feed ekle düğmesine tıklayın.
- Ad ve Feed URL'si (dosyanın bağlantısı) belirtin.
- Biçim seçin: YML (Yandex), Google Merchant, CSV, JSON veya JSON Lines.
- Güncelleme alanında feed'in ne sıklıkla yeniden okunacağını seçin: 1, 3, 6 veya 12 saatte bir ya da günde bir.
- Feed parola veya token ile korunuyorsa Authorization başlığı alanını doldurun, örneğin
Bearer …. Şifreli olarak saklanır. - Kaydet düğmesine tıklayın. İlk içe aktarma hemen başlar.

CSV ve JSON'da sütunlar adlarına göre tanınır: id, name veya title, url, image, price, old_price, currency, available, category, brand (bu sütunların Rusça adları da tanınır). Diğer sütunlar ürün özellikleri olarak kabul edilir. Ürün id'si, web sitesinin olaylarda gönderdiği id ile aynı olmalıdır; aksi halde müşterilerin eylemleri katalogla eşleşmez.
Her feed için durum (Çalışıyor veya Hata), son içe aktarma zamanı ve sonuç görünür: kaç ürün ve kategori okunduğu ve kaçının stokta yok olarak işaretlendiği. Şimdi güncelle düğmesi zamanlama dışında bir içe aktarma başlatır. Duraklat zamanlanmış içe aktarmaları durdurur (durum “Duraklatıldı”), Şimdi güncelle duraklatmayı kaldırır. Hatalı feed zamanlamaya göre yeniden denenir, hata metni altında gösterilir.
Bilmeniz gerekenler:
- Artık feed'de bulunmayan ürünler silinmez, stokta yok olarak işaretlenir: bunlara ait olay geçmişi korunur, feed'e geri dönen ürün yeniden kullanılabilir olur.
- Feed silindiğinde ürünler katalogda kalır.
Görsel kopyaları
Feed ayarlarında Ürün görsellerini depolama alanımıza kopyala seçeneğini etkinleştirebilirsiniz. Bu durumda e-postalardaki ve widget'lardaki görseller OneTrace.pro CDN'inden açılır ve web sitenizin erişilebilirliğine bağlı olmaz.
- Saniye, dakika veya saat başına En fazla indir … görsel: web sitenize yük bindirmemek için bir sınır. Varsayılan olarak saniyede 5.
- Feed'in altında kaç görselin kopyalandığı, kuyrukta olduğu ve indirilemediği görünür. Kopya henüz yoksa (veya feed'deki görsel adresi değiştiyse) orijinal görsel gösterilir.
- Kopyalar tarifenin görsel depolama sınırına sayılır. Anahtar kullanılamıyorsa kurulumunuzda görsel depolama alanı yapılandırılmamıştır.
API üzerinden yükleme
Geliştiriciler https://cdp.onetrace.pro/api/v1/products adresine istek göndererek ürün yükleyebilir ve silebilir; istek başına en fazla 1000 ürün ve kategori. “Ürün yükleme ve silme” yetkisine sahip bir gizli anahtar gerekir; bkz. API anahtarları ve Sunucu entegrasyonu.
Modeller için olaylar
Modeller için olaylar bloğunda hangi olayların ürünlerle ilgili eylemleri ifade ettiğini belirtin:
| Alan | Örnek |
|---|---|
| Ürün görüntüleme | product_viewed |
| Sepete ekleme | product_added |
| Satın alma | order_completed |
| Ürün id özelliği | product_id: olayda tek bir alan veya bu alanı içeren bir products[] dizisi |
| Satın alınanları önerme | 30, 90 veya 365 gün; sarf malzemeleri için “Tekrar öner” |
Varsayılan olarak olaylar tahmin ayarlarından alınır. Kaydet düğmesine tıkladıktan sonra modeller yeniden hesaplanır.
Modeller ve gece hesaplaması
Modeller kartı durumu (Bekliyor, Hesaplanıyor, Hazır, Katalog yok, Hata), hesaplama zamanını ve ürünler arasındaki ilişki sayısını gösterir.
Modeller her gece, ayrıca ayarlar kaydedildikten hemen sonra ve Yeniden hesapla düğmesiyle yeniden hesaplanır. Hesaplama sırasında ve hata durumunda öneriler önceki sürüme göre sunulur.
Hesaplama, ilişkilerin yanı sıra profillere favorite_category, favorite_brand ve top_products niteliklerini yazar. Bunları segmentlerde kullanabilirsiniz, örneğin “favori kategori: ayakkabı”.
Öneri türleri
| Tür | Ne gösterir | Nerede uygundur |
|---|---|---|
| Kişisel | müşterinin görüntülemelerine, sepetlerine ve satın almalarına göre, bugünkü eylemleri de dikkate alan seçki | ana sayfa, “Bunlar da ilginizi çekebilir” e-postası |
| Popüler | tüm katalogda veya bir kategoride son 30 günün en çok talep gören ürünleri | yeni ziyaretçi, boş sepet |
| Yükselen trendler | son hafta içinde ilginin arttığı ürünler | ana sayfa, “Haftanın yenilikleri” kampanyası |
| Birlikte görüntülenenler | bu ürünle birlikte görüntülenenler | ürün sayfası |
| Birlikte satın alınanlar | bu ürünle birlikte satın alınanlar | sepet, sipariş sonrası e-posta |
| Benzer | aynı kategorideki ürünler: marka, fiyat, özellikler | ürün sayfası, stokta yok |
| Son görüntülenenler | müşterinin son görüntülemeleri | terk edilen görüntüleme |
Geçmişi olmayan yeni bir ziyaretçi popüler ürünleri alır. Seçkilere yalnızca stokta olan ürünler girer.
Sonuçları kontrol etme
Sonuçları kontrol et bloğunda bir Tür seçin ve türe bağlı olarak Ürün ID'si, Kategori ID'si veya Profil ID'si belirtin. Müşterinin alacağı ürün kartlarını görmek için Göster düğmesine tıklayın.

Etki raporu
Sitedeki 30 günlük etki tablosu her tür için gösterimleri, tıklamaları, CTR'yi, satın almaları ve geliri gösterir. Müşteri bir öneriye tıkladıktan sonraki 7 gün içinde ürünü satın aldıysa satın alma sayılır; gelir katalog fiyatına göre hesaplanır. E-postalardaki önerilerin etkisi kampanya ve yolculuk raporlarında görünür.

Öneriler nerede gösterilir
- Web sitesinde: “Web sitesi” bölümündeki hazır widget'lar veya izleyici çağrısı; bkz. Web sitesinde öneri widget'ları.
- E-postalarda: e-posta oluşturucudaki Ürünler bloğu. Bu blokta Hangi ürünler, Kaç adet, sütun sayısı, Fiyatı göster ve Ürünün altındaki düğme seçilir. “Birlikte görüntülenenler”, “Birlikte satın alınanlar” ve “Benzer” türlerinde ürün, e-postayı tetikleyen olaydan alınır (Ürün id'sini içeren olay özelliği); terk edilen sepet e-postası bu şekilde oluşturulur. Uygun ürün yoksa blok e-postada gösterilmez.
- Tüm kanalların şablonlarında:
recommendations()fonksiyonu:
{% for product in recommendations('personal', 4) %}
<a href="{{ product.url }}">{{ product.name }}</a> — {{ product.price }}
{% endfor %}