Ürün kataloğu

Ürünlerinizi bir kez yükleyip kampanyalarda, otomasyonlarda ve e-posta tasarımlarında kullanın. Karar kaydı: docs/adr/0061-urun-katalogu.md.

Veri yüklemeBağlantıyı kopyala

Dashboard → Ürün Kataloğu veya public API:

curl -X POST https://api.pushizo.example/v1/apps/$APP_ID/catalogs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"urunler","currency":"TRY"}'

curl -X POST https://api.pushizo.example/v1/apps/$APP_ID/catalogs/$CATALOG_ID/items/upload \
  -H "Authorization: Bearer $API_KEY" -F file=@urunler.csv

curl -X PUT https://api.pushizo.example/v1/apps/$APP_ID/catalogs/$CATALOG_ID/items \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"items":[{"id":"SKU1","title":"Kalem","price":49.9,"url":"https://ornek.com/kalem","in_stock":true}]}'

id,title,description,image_url,url,price,sale_price,category,in_stock,renk
SKU1,Kalem,Mavi tükenmez,https://ornek.com/kalem.jpg,https://ornek.com/kalem,49.90,39.90,Kırtasiye,true,mavi

• id ve title zorunludur. url ve image_url yalnızca https olur.
• Bilinmeyen sütunlar özellik olur: {{ urun.attributes.renk }}.
• Yükleme upsert yapar: aynı kimlik güncellenir ve satırdaki boş alanlar temizlenir, dosyada olmayan ürüne dokunulmaz. Ürün silmek için DELETE …/items/{itemId}.
• Sınırlar: app başına 20 katalog, katalog başına 1.000.000 ürün, yüklemede 100.000 satır ve 20 MB, istekte 1000 ürün.

Şablonda kullanımBağlantıyı kopyala

{% catalog_item 'urunler' id: custom_data.product_id as urun %}
{% if urun and urun.in_stock %}{{ urun.title }}: {{ urun.price_text }}{% endif %}

{% catalog_items 'urunler' ids: user.tags.son_urunler as urunler %}
{% for u in urunler %}{{ u.title }} {% endfor %}

• Alanlar: id, title, description, image_url, url, price, sale_price, currency, category, brand, in_stock, attributes.
• price_text ve sale_price_text alıcının dilinde para birimiyle biçimlenir.
• ids dizi veya virgüllü metin olabilir, en fazla 50 kimlik okunur.
• Ürün bulunamazsa urun boştur; her zaman {% if %} kullanın.
• Kimlik {% for %} içindeki yerel değişkene bağlıysa gönderimden önce yüklenemez ve boş döner.
• Push, e-posta, SMS, WhatsApp ve RCS gönderimlerinde çalışır. Uygulama içi mesajda etiket boş döner.

E-posta bloğuBağlantıyı kopyala

E-posta tasarımcısında Ürün bloğunu sürükleyin; katalog adını ve ürün kaynağını seçin. Blok görsel, başlık, açıklama, fiyat ve düğme üretir. Ürün bulunamazsa veya stokta değilse blok e-postada görünmez, e-posta yine gönderilir. Önizlemede örnek ürün gösterilir.