Ürün önerileri
Ürün kataloğunuzdan her alıcıya uygun ürünleri seçip kampanya, otomasyon ve e-postalarda gösterin. Öneriler olay verinizden her gün hesaplanır. Karar kaydı: ADR-0063. Önce ürün kataloğu yüklenmiş…
Ürün kataloğunuzdan her alıcıya uygun ürünleri seçip kampanya, otomasyon ve e-postalarda gösterin. Öneriler olay verinizden her gün hesaplanır.
Karar kaydı: docs/adr/0063-urun-oneri-motoru.md. Önce ürün kataloğu yüklenmiş olmalıdır.
Kurulum
Dashboard → Ürün Kataloğu → Öneriler:
| Alan | Açıklama | Varsayılan |
|---|---|---|
| Görüntüleme olayları | Ürün görüntüleme sayılan olaylar, en fazla 10 | Boş |
| Satın alma olayları | Satın alma sayılan olaylar, en fazla 10 | Boş |
| Ürün kimliği özelliği | Olayda kimliği taşıyan özellik | product_id |
| Pencere | Sayılacak son gün, 7–365 | 90 |
Görüntüleme ve satın alma olaylarından en az birini girin. Kaydedince ilk hesap başlar, sonra her gün 04:50 UTC'de yenilenir.
Olayınız ürün kimliğini metin, sayı veya dizi olarak taşıyabilir:
{ "name": "purchase", "properties": { "product_id": ["A1", "B2"] } }Katalogda olmayan kimlikler ve kimliği belli olmayan kullanıcıların olayları sayılmaz.
Stratejiler
| Strateji | Ne gösterir | Sonuç yetmezse |
|---|---|---|
personalized | Kullanıcının ürünlerine benzeyenler | popular, new_arrivals |
popular | Pencere içinde en çok etkileşim alanlar (satın alma 5 kat sayılır) | new_arrivals |
trending | Son 7 günde önceki 7 güne göre artanlar | popular, new_arrivals |
similar | Verilen ürüne benzeyenler | popular, new_arrivals |
category | Verilen kategorinin en popülerleri | Yok |
recently_viewed | Kullanıcının görüntüleyip almadıkları | Yok |
new_arrivals | Kataloğa son eklenenler | Yok |
Stokta olmayan ürünler ve kullanıcının satın aldıkları çıkmaz. Benzerlik birlikte ilgilenen kullanıcılardan bulunur; bir çift için en az 2 ortak kullanıcı gerekir. Az veri varsa liste yedek kaynakla tamamlanır.
Şablonda
{% recommendations 'urunler' strategy: 'personalized' limit: 4 as liste %}
{% for urun in liste %}
{{ urun.title }} {{ urun.price_text }}
{% endfor %}{% recommendations 'urunler' strategy: 'similar' item: custom_data.product_id as benzerler %}
{% recommendations 'urunler' strategy: 'category' category: 'Ayakkabı' limit: 3 as enIyiler %}limit1–20 arası sabit sayıdır, varsayılan 4.strategytırnak içinde sabit metin olmalıdır.itemvecategorydeğişken yolu veya tırnak içinde sabit metin alır, filtre kullanılamaz.- Ürün alanları ürün kataloğu ile aynıdır.
- Push, e-posta, SMS, WhatsApp ve RCS gönderimlerinde çalışır. Uygulama içi mesajda liste boş döner.
- Önizlemede örnek ürün görünür.
E-posta bloğu
E-posta tasarımcısında Öneriler bloğunu sürükleyin; katalog, strateji ve ürün sayısını (1–6) seçin. Liste boşsa başlık dahil blok e-postada görünmez, e-posta yine gönderilir.
API
curl "https://api.pushizo.com/v1/apps/$APP_ID/catalogs/$CATALOG_ID/recommendations?strategy=personalized&external_id=musteri-1&limit=4" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"| Uç | Kapsam | Açıklama |
|---|---|---|
GET .../recommendations | analytics:read | strategy, limit, user_id, external_id, item_id, category |
GET .../recommendations/config | analytics:read | Model ve hesap durumu |
PUT .../recommendations/config | admin | Modeli ayarlar, açıksa hesabı başlatır |
POST .../recommendations/compute | admin | Hesabı kuyruğa alır (202) |
Yanıttaki source, listenin ilk ürününün geldiği kaynaktır; yedeğe düşüldüyse strategy değerinden farklıdır. Bu uçlar API anahtarı ister, tarayıcıdan veya
uygulamadan doğrudan çağrılmamalıdır.
Sınırlar ve gizlilik
- Öneriler günlüktür, gün içi davranış ertesi hesaba yansır.
- Benzerlik yalnızca davranışa bakar; başlık veya kategori kullanılmaz. Hiç etkileşim almamış ürün
new_arrivalsvecategorydışında görünmez. - Hesap en yeni 200.000 kullanıcıyı ve kullanıcı başına son 20 ürünü alır.
- Kullanıcı silinince kişisel listesi de silinir. Özelliğe erişim Dynamic Content planına bağlıdır.