Dosya içe aktarma ve veri kaynakları

Müşterileriniz zaten başka bir sistemde (CRM, muhasebe programı, tablo) kayıtlıysa onların web sitesine gelmesini beklemeniz gerekmez: bir dosya yükleyin. CSV'den profillerin tek seferlik yüklenmesini içe aktarma, URL'deki bir dosyadan, S3'ten veya Google Sheets tablosundan profillerin ve olayların düzenli yüklenmesini ise veri kaynakları yapar.

Her iki araç da “Sahip”, “Yönetici” ve “Müdür” rollerine açıktır.

CSV'den profil içe aktarma

Menüde Veriler → Profil içe aktarma sayfasını açın veya Profiller sayfasının başlığındaki Profil içe aktarma düğmesine tıklayın.

Dosya gereksinimleri

• İlk satırında sütun başlıkları olan CSV.
• Ayırıcı virgül, noktalı virgül veya sekme olabilir; otomatik algılanır.
• Boyut en fazla 20 MB.
• En az bir tanımlayıcı sütun: sisteminizdeki müşteri id'si, e-posta, telefon.

Örnek:

email;phone;first_name;city;customer_id;bonus
[email protected];+90 532 123 45 67;Ayşe;İzmir;1001;350

Nasıl yüklenir

1. CSV dosyası seçin düğmesine tıklayın ve dosyayı seçin.
2. Tabloda dosyanın sütunları, örnek değerler ve Hedef alanı görünür. Her sütun için belirtin:
   • Kimlik tanımlayıcısı: User ID, E-posta, Telefon veya Anonymous ID: profil bununla bulunur veya oluşturulur. Her tür yalnızca bir kez seçilebilir.
   • Nitelik: profil özelliği; yanına Latin harfleriyle bir anahtar girin, örneğin city veya bonus_balance.
   • Atla: sütun yüklenmez.
3. İçe aktarmayı başlat düğmesine tıklayın.

OneTrace.pro hedefi başlıklara göre kendisi önerir: email e-postaya, phone ve mobile telefona, customer_id ve user_id User ID'ye eşlenir. Diğer başlıklar küçük harfli ve alt çizgili nitelik anahtarlarına dönüşür; Türkçe karakterler ve boşluklar alt çizgiyle değiştirilir. Bu yüzden başlıkları en iyisi doğrudan first_name, last_name, city, country gibi Latin harfli anahtarlarla yazın. Başlatmadan önce önerileri kontrol edin.

İçe aktarmanın ilerleyişi

İçe aktarma arka planda çalışır: sayfada ilerleme çubuğu, durum ve “M satırdan N işlendi, hata: K” sayacı görünür. Sayfayı kapatabilirsiniz, içe aktarma devam eder. Hatalı satırlar numaralarıyla listelenir. İçe aktarma bittiğinde Profilleri aç düğmesi profil listesine götürür.

Sağdaki Geçmiş bloğunda son 20 içe aktarma yer alır: dosya, kimin ve ne zaman yüklediği, durum (“Yüklendi”, “Kuyrukta”, “İşleniyor”, “Tamamlandı”, “Hata”) ve sonuç.

Satırlar nasıl işlenir

• Bu tanımlayıcıya sahip bir profil zaten varsa profil güncellenir: yeni nitelikler eklenir, eşleşenlerin üzerine yazılır. Bir satırda iki farklı profilin tanımlayıcıları bulunursa profiller birleştirilir; bkz. Profiller.
• Boş hücreler atlanır ve bilinen değerleri silmez.
• Sayılar ve true/false sayı ve mantıksal değer olarak kaydedilir.
• Dosyadaki e-posta ve telefon hem profilin tanımlayıcısı hem de niteliği olur.
• Telefondaki boşluklar, parantezler ve tireler temizlenir. Telefonu ülke koduyla belirtin: +90 532 123 45 67. 0532… gibi bir numara yanlış kodla kaydedilir.
• Hiçbir geçerli tanımlayıcı içermeyen satır hatayla atlanır.

İçe aktarma her satır için bir $identify olayı oluşturur; bu nedenle nitelik değişiklikleri, nitelik değişikliği tetikleyicili yolculukları başlatabilir. Bunu istemiyorsanız bu tür yolculukları içe aktarma süresince duraklatın.

Veri kaynakları

Kaynak, zamanlamaya göre yapılan düzenli bir içe aktarmadır. CRM'iniz veya deponuz her gece yeni bir dışa aktarım yayımlıyorsa uygundur: OneTrace.pro onu kendisi alır ve profilleri günceller ya da olay ekler.

Hazırlık

Önce Entegrasyonlar bölümünde bir bağlantı oluşturun (“Yönetici” veya “Sahip” rolü gerekir):

• URL'den dosya: HTTP(S) adresindeki bir dosya. Dosya korumalıysa yetkilendirme başlığını belirtin, örneğin Bearer ve token.
• S3'ten dosya: AWS, Yandex Object Storage, MinIO ve diğer uyumlu depolama alanlarındaki bir bucket.
• Google Sheets tablosu: Google hizmet hesabı anahtarıyla. Bu hesaba tabloyu okuma erişimi verin.

Dosya biçimleri: CSV, JSON (nesne dizisi, en fazla 50 MB) ve JSON Lines.

Kaynak nasıl oluşturulur

1. Veriler → Veri kaynakları sayfasını açın ve Yeni kaynak düğmesine tıklayın.
2. Ad girin ve Bağlantı seçin.
3. Bağlantı ayarlarını doldurun: Dosya URL'si ve Biçim, Bucket içindeki dosya yolu veya Tablo ID'si ve Aralık (örneğin Sayfa1!A:F).
4. Sütunları yükle düğmesine tıklayın; OneTrace.pro ilk satırları okur.
5. İçe aktarma türü alanında Profiller (her satır nitelikleri günceller) veya Olaylar (her satır bir olaydır) seçin.
6. Zamanlama seçin: 15 dakikada birden günde bire kadar.
7. Sütunlar tablosunda, CSV içe aktarmada olduğu gibi her sütunun hedefini belirtin.
8. Kaydet düğmesine tıklayın.

Olaylar için sütun tablosunda ayrıca Olay adı, Olay özelliği ve Olay zamanı hedefleri bulunur. Zaman sütunu zorunludur. Olay adını Olay adı alanında tüm satırlar için tek bir değer olarak (örneğin order_completed) belirtin veya adın yazılı olduğu sütunu seçin.

Kaynağın çalışması

Kaynak kartında durum (“Çalışıyor”, “Duraklatıldı”, “Hata”), zamanlama, son çalıştırma zamanı ve sonuç görünür: satır, kabul edilen, atlanan, hatalı.

• Şimdi çalıştır: zamanlama dışı bir çalıştırma. Kaynağı duraklatma ve hata durumundan da çıkarır.
• Duraklat / Devam ettir: zamanlanmış çalıştırmaları durdurur ve sürdürür.
• Geçmiş: çalıştırmaların listesi: başlangıç, nasıl başlatıldığı (“Zamanlanmış” veya “Manuel”), durum ve numaralarıyla ilk satır hataları.

Bilmeniz gerekenler

• Dosya son seferden bu yana değişmediyse çalıştırma “Değişiklik yok” durumuyla biter ve satırlar okunmaz.
• Aynı satırın bir gün içinde tekrar gelmesi kopya oluşturmaz.
• Olaylar için son yüklenen olayın zamanı hatırlanır: sonraki çalıştırmalar bundan daha yeni olmayan satırları atlar. Bu nedenle geçmiş içeren bir dosyaya yalnızca yeni satırlar ekleyebilirsiniz.
• Hatalı kaynak zamanlamaya göre yeniden denenir, hata metni kartta görünür.
• Yüklenen olaylar tarifenin aylık kotasına sayılır.
• Kaynak silindiğinde önceden yüklenmiş veriler kalır.

Mindbox ve diğer platformlardan geçmişle birlikte tek seferlik geçiş için ayrı bir araç vardır; bkz. Diğer platformlardan geçiş.