Bir format. Dört bağlantı yolu.
CSV, XML ve JSON dosyalarında aynı alan adlarını kullanın. PostgreSQL için bu sütunları sağlayan salt okunur bir view oluşturabilirsiniz.
Zorunlu alanlar
| Alan | Tür | Açıklama |
|---|---|---|
| id | Metin | Projeniz içinde benzersiz ve kalıcı ürün kimliği. |
| name | Metin | Ürün adı. |
| price | Sayı | Satış fiyatı. Ondalık ayracı nokta: 1299.90. Para sembolü eklemeyin. |
| currency | Metin | Üç harfli para birimi: TRY, USD, EUR. Farklı para birimleri arasında dönüşüm yapılmaz. |
İsteğe bağlı alanlar
| description | Ürün açıklaması; öneri kalitesi için tavsiye edilir. |
| brand / category | Marka ve kategori. |
| url / image_url | HTTPS ürün sayfası ve görsel adresi. |
| available | true / false. Belirtilmezse true. false ürünler önerilmez; bu alan stoktan bağımsız satış iznidir. |
| in_stock | true / false. Stok bilgisi; verilmezse bilinmiyor kabul edilir. Stok tükenenler, proje ayarına göre gösterilir. |
| compare_at_price | İndirim öncesi fiyat (isteğe bağlı). Satış fiyatından büyükse çizili gösterilebilir. |
| min_age / max_age | Alt ve üst yaş sınırı; boş bırakılabilir. |
| attributes | Ek özellikleri içeren JSON nesnesi. CSV’de JSON metni, XML’de alt etiketler. |
JSON örneği
{
"products": [
{
"id": "sku-001",
"name": "Mimari Model Seti",
"description": "Yetişkinler için 800 parçalı sergileme modeli.",
"price": 1299.9,
"compare_at_price": 1599.9,
"in_stock": true,
"currency": "TRY",
"available": true,
"brand": "Örnek Marka",
"category": "Maket",
"url": "https://example.com/products/sku-001",
"image_url": "https://example.com/images/sku-001.jpg",
"min_age": 18,
"max_age": null,
"attributes": {
"pieces": 800,
"color": "Krem"
}
}
]
}Aktarım davranışı
Her dosya veya kaynak, projenin tam kataloğudur. Aynı ID güncellenir, yeni ID eklenir ve son aktarımda bulunmayan ürün kaldırılır. Fiyat değişiklikleri vektörün yeniden hesaplanmasını gerektirmez; açıklama ve ürün metni değişince ilgili vektör yenilenir. Hatalı bir satır varsa aktarım uygulanmaz; raporu düzeltip tekrar yükleyin.
Dosyalar UTF-8, en fazla 20 MB ve 50.000 ürün olmalı. URL kaynakları HTTPS olmalı; özel ağ adresleri kabul edilmez. PostgreSQL bağlantısında TLS doğrulaması ve yalnızca SELECT yetkisi kullanın. Sunucunuz dış bağlantıya açık değilse dosya veya HTTPS akışı tercih edin.
Otomatik feed güncellemesi
Ürünler bölümünden HTTPS feed adresinizi ekleyin; JSON, XML veya CSV formatını seçin. Saat diliminize göre günde en fazla 6 çalışma saati veya 1, 6, 12, 24 saatlik aralık belirleyebilirsiniz. Kaynak ilk kez bağlandığında hemen aktarılır; sonraki güncellemeler planınıza göre yapılır. Planınızı sonradan düzenleyebilir, duraklatabilir veya “Şimdi güncelle” ile elle çalıştırabilirsiniz.
Her feed tam katalog olmalıdır. Fiyat, indirimli fiyat, stok ve satış izni her aktarımda yenilenir. Satışa kapatmak için available=false, stok tükendiğinde in_stock=false gönderin. Ürünü feed’den tamamen çıkarmak katalogdan kaldırır. Boş veya hatalı feed mevcut ürünleri silmez. Her proje tek otomatik kaynak kullanır.
Planlar dakikada bir kontrol edilir. Hizmetin kapalı olduğu sırada kaçırılan çalışmalar, yeniden açıldığında tek bir güncel aktarım olarak tamamlanır. Başarısız aktarım panelde görünür ve bir sonraki planlanan saatte yeniden denenir.
PostgreSQL view örneği
CREATE VIEW product_feed AS
SELECT sku::text AS id, title AS name,
description, sale_price AS price, 'TRY' AS currency,
is_active AS available
FROM products;
-- Bu view'a yalnızca SELECT yetkisi olan bir kullanıcı bağlayın.Bu örneği kendi veritabanınızın alan adlarına uyarlayın. Navlu kaynak veritabanında tablo veya view oluşturmaz.