Doğrulama ve Uygulama
Eşleşme oranı ve iki adımlı akış
Aktarım iki adımdır ve doğrulama adımı atlanamaz.
Panelde nerede
Sol menüde Product Feed, ardından sayfanın sağ üstündeki Geçmiş veri düğmesi. Kendi menü girdisi yoktur.
Adım 1 — doğrulama
validate modunda dosya okunur, her satır ayrıştırılır ve rapor üretilir. Hiçbir şey yazılmaz.
Rapor şunları içerir:
| Bölüm | Ne söyler |
|---|---|
| Okunan satır sayısı | Dosya tam okunabildi mi |
| Geçerli / hatalı satır | Kaç satır reddedilecek |
| Hata örnekleri | Hangi alanda ne sorun var (en fazla 1000 örnek) |
| Para birimleri | Beklemediğiniz bir para birimi var mı |
| Ürün kodu eşleşme oranı | En önemli çıktı |
Ürün kodu eşleşme oranı
Sipariş satırlarındaki ürün kodlarının kaçının kataloğunuzda karşılığı olduğunu ölçer.
| Oran | Anlamı | Ne yapmalı |
|---|---|---|
| %95+ | Sağlıklı | Devam edin |
| %90–95 | Kabul edilebilir | Eşleşmeyen örneklere bakın |
| %90 altı | Sorunlu | Uygulamayın |
%90 altında uygulamayın
Düşük eşleşme oranı, sipariş kodlarınızla besleme kodlarınızın farklı olduğu anlamına gelir. Bu haliyle aktarırsanız ürün seviyesindeki her sayı yanlış olur: "birlikte alınanlar" önerisi anlamsız çiftler üretir, ürün bazlı ciro eksik çıkar, en çok satanlar listesi hatalı olur.
Önce kod uyumunu düzeltin. Rapordaki eşleşmeyen kod örnekleri genellikle sorunu doğrudan gösterir — bir önek, bir sonek ya da büyük/küçük harf farkı.
Hataları okuma
Rapor, hatalı satırları alan ve mesajla listeler. Yaygın olanlar:
| Mesaj | Sebep |
|---|---|
placedAt is required | Sipariş tarihi yok |
placedAt must be an ISO-8601 timestamp | Tarih biçimi yanlış |
externalId is required | Müşteri kimliği, e-posta ve karma üçü de yok |
total is required when the order has no line items | Ne satır ne toplam var |
emailHash must be a 64-character SHA-256 hex digest | Karma biçimi hatalı |
Hata örnekleri en fazla 1000 satır için saklanır. Milyonlarca hatalı satır varsa ilk bin zaten sorunu anlatır.
Adım 2 — uygulama
Rapor temizse apply moduna geçin. Veri yazılır.
Tekrar çalıştırma güvenli
Aynı dosyayı iki kez uygulamak veri çiftlemez: kayıtlar orderId ve externalId üzerinden tekil kimliklendirilir. Yarıda kalan bir aktarımı baştan çalıştırabilirsiniz.
Sipariş tarihi
Aktarılan siparişin kayıt tarihi, placedAt değerine ayarlanır — aktarımın yapıldığı ana değil. Böylece iki yıllık geçmişiniz raporlarda gerçek tarihlerine dağılır.
Adım 3 — ısıtma
Uygulama bittikten sonra geçmiş siparişleri öneri sinyaline çevirmek için ısıtma adımını çalıştırın — bkz. Aktarım Sonrası.
İlerlemeyi izleme
Büyük aktarımlar arka planda çalışır. Durumu Background Jobs sayfasından izleyebilirsiniz — bkz. Arka Plan İşleri.
Son güncelleme: 9 Eylül 2026