Doğrulama ve Uygulama

Aktarım iki adımdır ve doğrulama adımı atlanamaz: önce Check the file (Dosyayı kontrol et), rapor temizse Import for real (Gerçekten aktar).

Panelde nerede

Sol menüde Ayarlar → Geçmiş Veri (Settings → Historical Data) (/dashboard/settings/data-import). Adımların tamamı bu sayfadadır: veri kaynağı, Options, iki düğme, Check result raporu ve altta Past runs (geçmiş çalıştırmalar).

Adım 1 — doğrulama

Check the file (API'de validate) dosyayı okur, her satırı ayrıştırır ve rapor üretir. Hiçbir şey yazılmaz. Dosyayı değiştirdikten sonra Check again ile yeniden denersiniz. Yüklenen dosya ya da URL için doğrulama bir arka plan işi olarak çalışır ve sayfa bitince raporu gösterir; yapıştırılan satırlar (en fazla 1000) hemen işlenir.

Rapor şunları içerir:

Bölüm	Ne söyler
Rows read (Okunan)	Dosya tam okunabildi mi. Dosya tek bir çalıştırmanın okuyabileceğinden uzunsa "bölüp kalanını ayrı aktarın" uyarısı çıkar (URL için sınır 2 milyon satır).
Passed / Rejected (Geçen / Reddedilen)	Kaç satır geçerli, kaç satır reddedilecek
Will be created (Oluşturulacak) / Refreshed (Yenilenen) / Already here (Zaten var)	Uygulanınca kaç kaydın yeni yazılacağı, kaçının güncelleneceği, kaçının zaten aynı olduğu
Skipped (Atlanan), Duplicates in file (Dosyada tekrar eden)	Yazılmayacak satırlar ve aynı dosyada iki kez geçen kimlikler
Order dates, Currencies, Order statuses, Traits, Order value	Dosyada ne bulunduğu: tarih aralığı, beklemediğiniz bir para birimi ya da durum metni var mı
Product codes matched (Ürün kodu eşleşmesi)	En önemli çıktı; aşağıda
Kullanıcı eşleştirme	Kaç satırın e-postayla bir kullanıcıya bağlanacağı (Matched to a customer by email), kaç misafir profilin birleştirileceği (Guest profiles an apply will merge), kaç adresin birden fazla müşteri kimliğince paylaşıldığı (Addresses used by more than one customer id). Bkz. Kullanıcılar ve siparişler nasıl eşleşir
İletişim ve izin (kullanıcılar)	Sendable email / phone (gönderilebilir e-posta ve telefon), kanal başına verilen ve geri çekilen izin, Permission without evidence (kanıtsız izin), Permission without an address, Withdrawals kept (korunan geri çekmeler), Trait names not imported (atılan özellikler)

Download the row-by-row report (satır satır raporu indir) hatalı satırları line, code, field, record_id, message kolonlarıyla CSV olarak verir; hata örnekleri en fazla 1000 satır için saklanır, sayımlar ise hepsini kapsar.

Ürün kodu eşleşme oranı

Sipariş satırlarındaki ayrı ürün kodlarının kaçının kataloğunuzda (item_code ya da sku) karşılığı olduğunu ölçer; "Product codes matched 96,2% — 1.204 / 1.251" gibi yazar ve eşleşmeyen kod örneklerini listeler (Not found in the feed).

Oran	Anlamı	Ne yapmalı
%90 ve üstü	Sağlıklı	Devam edin; eşleşmeyen örneklere bir göz atın
%90 altı	Sorunlu — panel oranı uyarı rengiyle gösterir	Uygulamayın

Hataları okuma

Rapor, reddedilen satırları kod, alan ve mesajla listeler. Reddedilen satırlar aktarılmaz; uyarı satırları ise aktarılır ama bir bölümü yazılmaz.

Kod	Alan	Sebep	Etki
MALFORMED_JSON	—	Satır geçerli bir JSON nesnesi değil, ya da bir değerinde NUL karakteri (\u0000) var	Reddedilir
MISSING_ORDER_ID / ORDER_ID_TOO_LONG	orderId	Sipariş kodu yok ya da 255 karakteri aşıyor	Reddedilir
MISSING_PLACED_AT	placedAt	Sipariş tarihi yok	Reddedilir
INVALID_PLACED_AT	placedAt	ISO-8601 değil, takvimde olmayan bir gün (2024-02-30), ya da 1990'dan eski (boş tarih yerine yazılmış 1970-01-01)	Reddedilir
PLACED_AT_IN_FUTURE	placedAt	Bir günden fazla gelecekte	Reddedilir
INVALID_TOTAL	total	Ne satır ne toplam var, ya da toplam negatif	Reddedilir
AMOUNT_OUT_OF_RANGE	total, subtotal, items[n].unitPrice …	Bir tutar 99.999.999,99'u, ya da bir adet 2.147.483.647'yi aşıyor	Reddedilir
TOO_MANY_ITEMS	items	100'den fazla satır	Reddedilir
NO_IDENTITY	—	Kullanıcı satırında ne customerId ne e-posta var	Reddedilir
EXTERNAL_ID_TOO_LONG	customerId	Müşteri kimliği 64 karakteri aşıyor	Reddedilir
INVALID_EMAIL_HASH	emailHash	64 karakterlik SHA-256 değil	Reddedilir
INVALID_TRAITS / INVALID_CONSENT	traits / consent	Nesne değil (izin için optIn da true ya da false olmalı)	Reddedilir
INVALID_EMAIL / INVALID_PHONE	email / phone	Adres okunamadı	Uyarı: kişi o adres olmadan aktarılır
RESERVED_TRAIT	traits	Selwise'in kendi hesapladığı bir alanın adı kullanılmış	Uyarı: o özellik atılır
CONSENT_WITHOUT_EVIDENCE	consent.*	Onayın tarihi ya da kanıtı yok	Uyarı: kişi aktarılır, izin kaydedilmez
CONSENT_WITHOUT_ADDRESS	consent.*	E-posta izni var ama düz e-posta yok (ya da SMS izni var, telefon yok)	Uyarı: izin kaydedilmez
CONSENT_KEPT_WITHDRAWN	consent.*	Adres bu kanalda zaten abonelikten çıkmış	Uyarı: dosyadaki onay geri çekmeyi kaldırmaz
DUPLICATE_IN_SOURCE	—	Aynı kimlik dosyada birden fazla kez	Uyarı: ilki kullanılır
PROFILE_SOFT_DELETED	—	Kanalda silinmiş ya da KVKK/GDPR ile unutulmuş kullanıcı	Uyarı: kişi geri gelmez; sipariş ciro için yazılır ama kişiye bağlanmaz
CONTACT_NOT_WRITTEN	—	İletişim kaydı yazılamadı	Uyarı
WRITE_FAILED	—	Kontrolden geçen sipariş, uygulamada veritabanınca reddedildi	Yalnızca o sipariş yazılmaz; aynı partideki diğerleri yazılır

Adım 2 — uygulama

Rapor temizse Import for real (apply) düğmesi açılır. Veri yazılır; aktarım bitince Import finished raporu çıkar ve yüklediğiniz dosya Selwise'ten silinir ("The import finished and the file was deleted").

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. Yapıştırılan satırlarda bu kapı yalnızca panelde vardır (rapor yoksa düğme kapalı). 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. Gerçek yazım zamanı siparişin meta verisinde saklanır.

Yüklenen dosyanın ömrü

Yüklenen dosya müşteri verisidir: başarıyla aktarıldığı anda silinir; hiç aktarılmazsa 24 saat sonra kendiliğinden silinir; Delete file ile hemen de silebilirsiniz. Üstteki Uploaded files listesi henüz silinmemiş dosyaları (Checked ya da Not checked) gösterir ve Continue with this file ile kaldığınız yerden devam ettirir. Silinen dosyanın doğrulama ve aktarım raporları kayıtlı kalır (90 gün).

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

Dosya ve URL aktarımları arka planda çalışır; Past runs bölümü ve Arka Plan İşleri ekranı ilerlemeyi gösterir. Bir aktarım işi bir saat içinde bitmezse süre aşımından başarısız olur — dosyayı bölüp yeniden deneyin.

Boş ya da kapalı görünüyorsa

• Check the file kapalı — veri kaynağı seçilmedi: "Upload a file first", "Enter the file's address first" ya da "Paste at least one row first".
• Import for real kapalı — dosya henüz doğrulanmadı, zaten aktarıldı, ya da doğrulama raporu "çalıştırılamaz" durumda; Check the file ile yeniden kontrol edin.
• "Select a site to import data into" — üstte kanal seçili değil.
• Aktarım bitmiyor — Arka Plan İşleri ekranında işin durumuna bakın.