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 Ayarlar → Geçmiş Veri (/dashboard/settings/data-import).
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ı |
| Kullanıcı eşleştirme | Kaç satırın e-postayla bir kullanıcıya bağlanacağı, kaç misafir profilin birleştirileceği, kaç adresin birden fazla müşteri kimliğince paylaşıldığı. Bkz. Kullanıcılar ve siparişler nasıl eşleşir |
| İletişim ve izin (kullanıcılar) | Gönderilebilir e-posta ve telefon sayısı, kanal başına verilen ve geri çekilen izin, kanıtsız ya da adressiz olduğu için kaydedilmeyen onaylar |
Ü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ış |
NO_IDENTITY | Kullanıcı satırında ne customerId ne e-posta var |
CONSENT_WITHOUT_EVIDENCE | Onayın tarihi ya da kanıtı yok — kişi aktarıldı, izin kaydedilmedi (satır reddedilmez) |
INVALID_PHONE, INVALID_EMAIL | Adres okunamadı — kişi o adres olmadan aktarıldı (satır reddedilmez) |
RESERVED_TRAIT | Selwise'in hesapladığı bir alanın adı özellik olarak gönderildi ve atıldı |
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.
Yüklenen bir dosya ya da URL için aktarım, aynı kaynak üzerinde tamamlanmış bir doğrulama olmadan başlatılamaz; sunucu bu isteği reddeder. Doğrulamayı atlayıp doğrudan aktarmak, ürün kodu eşleşme oranını hiç görmeden iki yıllık siparişi yanlış ürünlere bağlamak demektir.
Tekrar çalıştırma güvenli
Aynı dosyayı iki kez uygulamak veri çiftlemez: kayıtlar orderId ve customerId ü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 Ekim 2026