Öneriler ve ürün kataloğu

OneTrace.ru 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

1. Ürün feed'leri bloğunda Feed ekle düğmesine tıklayın.
2. Ad ve Feed URL'si (dosyanın bağlantısı) belirtin.
3. Biçim seçin: YML (Yandex), Google Merchant, CSV, JSON veya JSON Lines.
4. 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.
5. Feed parola veya token ile korunuyorsa Authorization başlığı alanını doldurun, örneğin Bearer …. Şifreli olarak saklanır.
6. 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.ru 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.

Stok

Her mağaza stok tutmaz, bu yüzden stok ayrıca açılır: Stok miktarını dikkate al anahtarı her feed'in ayarlarında, API ve mağaza eklentilerinden gelen ürünler için ise bölümün ayar kartındadır (API ve eklentilerden gelen stoku dikkate al). Varsayılan olarak kapalıdır.

• Açık — stok kaydedilir ve stoku sıfır olan ürün satıştan kalkar. Stoka dayalı işlevler, örneğin «az kaldı» yolculukları çalışır. Feed'de stok <count> (YML), g:quantity (Google) veya stock, quantity sütunundan (CSV ve JSON), API'de ise stock alanından alınır.
• Kapalı — stok kullanılmaz: ürün, mağaza sıfır stok gönderse bile feed'deki stok durumuna veya available alanına göre gösterilir.

API üzerinden yükleme

Geliştiriciler https://cdp.onetrace.ru/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.

Katalog dilleri

Web siteniz birden fazla dilde çalışıyorsa ürün çevirilerini yükleyin: böylece widget'lar, arama ve e-postalar ürün adlarını ve bağlantılarını müşterinin dilinde gösterir.

• Başka dilde feed. İkinci bir feed ekleyin (aynı dışa aktarımın başka dildeki hâli) ve bu feed için Feed dili alanını seçin. Böyle bir feed ürün oluşturmaz ve ürünleri stokta yok olarak işaretlemez: ana feed'deki aynı id'ye sahip ürünlere ad, bağlantı ve özellik çevirilerini ekler. Bu alan, projede birden fazla dil varsa görünür; bkz. Proje ayarları, tarife ve denetim.
• API üzerinden. Çevirileri ürünün ve kategorinin translations alanında gönderin, örneğin "translations": {"en": {"name": "Linen dress", "url": "https://shop.example/en/linen-dress"}}.

Dil otomatik olarak seçilir: web sitesinde izleyicinin gönderdiği ziyaretçi dili, e-postada ise e-postanın sürümünün dili kullanılır; bkz. Dil sürümleri. Bu dilde çeviri yoksa ana ad ve bağlantı gösterilir. Ürün arama, ürünü dillerin herhangi birindeki adıyla bulur. Ürün tablosunda adın yanında ürünün çevrildiği diller görünür.

Modeller için olaylar

Modeller için olaylar bloğunda hangi olayların ürünlerle ilgili eylemleri ifade ettiğini belirtin:

Varsayılan olarak olaylar tahmin ayarlarından, diğer değerler ise mağaza sektöründen 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, ölçülü sektörlerde ise pref_… (müşterinin bedeni, bkz. Mağaza sektörü) ve replenish_at (“yeniden alma zamanı” tarihi) niteliklerini yazar. Bunları segmentlerde kullanabilirsiniz, örneğin “favori kategori: ayakkabı”.

Öneri türleri

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 %}