OneTrace.pro Yardım merkezi

Veri ambarlarına aktarım

Aktarım, proje verilerini düzenli olarak veri ambarınıza kopyalar: profiller, olaylar ve isteğe bağlı olarak mesajlar, segmentler, izinler ve ürünler. Analistleriniz bu verilerle kendi araçlarında çalışır: BI'da raporlar hazırlar, muhasebe sisteminin verileriyle birleştirir, modeller eğitir.

Ters yön, yani veri ambarınızdaki değişen satırların profillere ve olaylara okunması, veri kaynağı ile yapılır.

Bölüm Veriler → Veri ambarları menüsündedir. Veri ambarlarına aktarım “Kurumsal” tarifesinde kullanılabilir; bkz. Tarifeler.

BigQuery, S3 ve ClickHouse'a aktarımlar

Nereye aktarılabilir

Veri ambarı Veriler oraya nasıl ulaşır
S3 (AWS, Yandex Object Storage, MinIO) bucket'ınıza NDJSON.gz dosyaları
Google Cloud Storage bucket'ınıza NDJSON.gz dosyaları
BigQuery Google Cloud projesinin veri kümesindeki tablolar
Snowflake şemadaki tablolar; veriler AWS S3 bucket'ınız üzerinden aktarılır
ClickHouse sunucunuzdaki veritabanında tablolar
PostgreSQL sunucunuzdaki şemada tablolar

Önce veri ambarını Entegrasyonlar sayfasında Veri ambarları grubunda bağlayın: erişim bilgilerini girin, ardından Test et düğmesine tıklayın.

  • S3: bucket, erişim anahtarları; Yandex Object Storage ve MinIO için ayrıca API adresi.
  • Google Cloud Storage ve BigQuery: hizmet hesabı anahtarı (JSON). Cloud Storage için hesabın bucket üzerinde Storage Object User rolüne, BigQuery için BigQuery Data Editor ve BigQuery Job User rollerine sahip olması gerekir. BigQuery için ayrıca veri konumu belirtilir: EU, US veya bir bölge.
  • Snowflake: hesap, kullanıcı ve kullanıcının parolasız RSA özel anahtarı, rol, hesaplama warehouse'u ve anahtarlarıyla birlikte bir AWS S3 bucket'ı. Açık anahtarı kullanıcıya ALTER USER … SET RSA_PUBLIC_KEY komutuyla atayın.
  • ClickHouse: HTTP arayüzü adresi, örneğin https://ch.example.com:8443, kullanıcı adı ve parola.
  • PostgreSQL: sunucu, bağlantı noktası, veritabanı, kullanıcı adı, parola ve bağlantı şifrelemesi.

ClickHouse veya PostgreSQL sunucusuna internetten erişilebilmelidir: iç ağ adresleri kabul edilmez.

Aktarım nasıl oluşturulur

  1. Yeni aktarım düğmesine tıklayın.
  2. Bir ad girin ve Veri ambarı seçin; oluşturulduktan sonra değiştirilemez.
  3. Neler aktarılsın bölümünde verileri işaretleyin. Profiller ve olaylar her zaman aktarılır.
  4. Geçmiş başlangıcı alanında olayların ve mesajların ilk kez hangi tarihten itibaren aktarılacağını seçin veya alanı boş bırakın; bu durumda tüm geçmiş aktarılır. Profiller, segmentler, izinler ve ürünler eksiksiz aktarılır.
  5. Zamanlama seçin: saatte bir, 3, 6 veya 12 saatte bir ya da günde bir.
  6. Veri ambarı ayarlarını doldurun: bucket'taki klasör, BigQuery veri kümesi, Snowflake veritabanı ve şeması, ClickHouse veritabanı veya PostgreSQL şeması. Veri kümesi, veritabanı ve şema yoksa otomatik olarak oluşturulur. Tablo öneki, aynı veritabanına birden fazla aktarım yazıyorsa gerekir.
  7. Kaydet düğmesine tıklayın. İlk aktarım bir dakika içinde başlar.

Aktarım ayarları

Uzun bir geçmişin ilk aktarımı parçalar hâlinde yapılır ve birkaç saat sürebilir; tamamlanana kadar kartta İlk aktarım etiketi görünür. Sonraki çalıştırmalar yalnızca son seferden bu yana değişenleri gönderir.

Neler aktarılır

Veriler Tablolar İçerik
Profiller profiles nitelikler, tanımlayıcılar (e-posta, telefon, user_id …), ilk ve son ziyaret, birleştirme (merged_into_id) ve silme
Olaylar events tüm site, API ve sistem olayları ($message_*, $segment_* ve diğerleri), özellikler ve bağlam
Mesajlar messages kanal, konu, şablon, kampanya ve varyant, yolculuk, durum ve her durumun zamanı, alıcı
Segmentler segments, segment_members segment listesi; şu anda segmentte kimlerin olduğu, ne zaman girip çıktıkları
İzinler consents, preferences kanal ve konuya göre izinler; tercih merkezinden sıklık ve duraklatma
Ürünler products fiyatlar, stok durumu, kategoriler, özellikler ve puanlarla katalog

Olaylar tablosuna yalnızca ekleme yapılır. Diğer tablolar anahtara göre güncellenir: değişen bir profil, mesaj veya ürün önceki satırın yerini alır. Nitelikler, olay özellikleri ve bağlamı JSON biçimindedir. Zaman UTC'dir.

Tablolar otomatik olarak oluşturulur; OneTrace.pro ürününün yeni bir sürümünde bir tabloya sütun eklenirse bu sütun da eklenir.

Veri ambarlarına göre farklar:

  • S3 ve Google Cloud Storage: dosyalar events/dt=2026-10-29/ klasöründe bulunur. Güncellenen tablolarda bir anahtarın güncel satırı, updated_at değerine göre en son satırdır. Tablo şemaları _schema klasöründedir.
  • BigQuery: olaylar olay gününe göre bölümlenir ve olay adı ile profile göre kümelenir; bu sayede bir dönem için yapılan sorgular daha az veri okur.
  • ClickHouse: güncellenen tabloları FINAL ile okuyun; JSON metin olarak saklanır: değerleri JSONExtract… fonksiyonlarıyla alın.

Silinen profiller

Bir profil müşterinin talebi üzerine silindiğinde (bkz. Profiller), aktarımın sonraki çalıştırması bu profilin satırlarını veri ambarından da siler: profillerden, olaylardan, mesajlardan, segment üyeliklerinden ve izinlerden. S3 ve Google Cloud Storage'da daha önce yazılmış dosyalar değişmez: silinen profillerin listesi _erasures klasörüne konur ve bu profillerin satırlarını kendi tarafınızda sizin silmeniz gerekir.

Çalıştırmalar ve hatalar

Aktarım kartında zamanlama, son çalıştırma ve her tabloya kaç satır gönderildiği görünür. Geçmiş düğmesi son çalıştırmaları gösterir.

Aktarım çalıştırma geçmişi

  • Şimdi çalıştır: zamanlamayı beklemeden değişiklikleri hemen aktarır.
  • Duraklat: aktarımı durdurur; değişiklikler birikir ve Devam ettir düğmesinden sonra gönderilir.
  • Baştan yeniden aktar: sonraki çalıştırma, ilk seferdeki gibi tüm verileri gönderir. Veri ambarındaki tablolar temizlenmezse olaylar iki kez yer alır.

Veri ambarı geçici olarak erişilemez durumdaysa aktarım çalıştırmayı 1, 5, 15, 30 ve 60 dakika sonra yeniden dener ve kaldığı yerden devam eder: kabul edilmiş parçalar iki kez gönderilmez. Erişim iptal edildiyse veya veritabanı bulunamadıysa kartta bir hata görünür; bağlantıyı Entegrasyonlar sayfasında düzeltin, sonraki çalıştırma aktarıma devam eder.

Aktarımları kimler ayarlayabilir

Veri ambarına müşterilerin kişisel verileri gider. Bu nedenle bölümü profilleri dışa aktarma yetkisine sahip roller görür; aktarımları oluşturma, değiştirme ve çalıştırma işlemlerini ise ayrıca entegrasyonları yönetme ve kişisel verileri maskesiz görme yetkilerine sahip olanlar yapabilir. Sistem rollerinden bunlar “Sahip” ve “Yönetici” rolleridir. Ayrıntılar için Üyeler ve roller makalesine bakın.