Olaylar ve olay kataloğu

Olay, müşterinin veya sistemin bir eylemidir: sayfa görüntüleme, sepete ekleme, sipariş, e-postanın açılması. Profiller, segmentler, yolculuk tetikleyicileri ve raporlar olaylardan oluşturulur. Veriler → Olaylar bölümünde projeye şu anda neyin geldiğini, Veriler → Katalog bölümünde ise genel olarak hangi olayların ve niteliklerin bulunduğunu ve nasıl adlandırıldığını görürsünüz.

Her iki bölüm de projenin tüm üyelerine açıktır. Katalogdaki etiketleri, türleri ve PII işaretlerini “Sahip”, “Yönetici” ve “Müdür” değiştirebilir.

Olaylar nereden gelir

Kaynak	Ne gönderir
Web sitesindeki izleyici	sayfa görüntülemeleri, ürünlerle ilgili eylemler, giriş; bkz. Web sitesini bağlama
Sunucunuzdan veya uygulamanızdan API	siparişler, kayıtlar, durum değişiklikleri; bkz. Sunucu entegrasyonu
İçe aktarma ve veri kaynakları	CSV, dosyalar, S3 ve Google Sheets'ten profiller; bkz. Dosya içe aktarma ve veri kaynakları
Başka bir platformdan geçiş	profil ve olay geçmişi; bkz. Diğer platformlardan geçiş
OneTrace.pro platformunun kendisi	segmentlere girişler, yolculuk adımları, mesaj gönderimleri ve açılmaları, abonelikler ve abonelikten çıkmalar

Olaylar gönderildikten sonra birkaç saniye içinde işlenir. Aynı messageId ile 24 saat içinde tekrar gelen bir olay atılır. Bir saatten daha ileri bir gelecek zamana sahip olayın zamanı, alınma zamanıyla değiştirilir. Aylık olay sayısı projenin tarifesiyle sınırlıdır; bkz. Proje ayarları, tarife ve denetim.

Olay akışı

Olaylar sayfası projenin olaylarını gerçek zamanlı olarak gösterir. Açıldığında son 7 günün son 50 olayı yüklenir; yeni olaylar kendiliğinden üstte görünür.

Bir olayı açılmış olay akışı

Neler yapabilirsiniz:

Ada göre filtreleme. Soldaki listeden bir olay seçin, örneğin order_completed; akış yalnızca bu olayı gösterir. “Tüm olaylar” filtreyi kaldırır.
Duraklatma. Duraklat düğmesi olayları rahatça incelemeniz için akışı durdurur; Devam et akışı yeniden başlatır.
Olay özellikleri. Bir satıra tıklayın; özellikler JSON biçiminde açılır.
Profile geçiş. Adın yanındaki #… numarası profil kartına götürür.

Sağda bağlantı durumu görünür: “Bağlandı”, “Bağlanıyor…” veya “Bağlantı yok”. Akış çok yoğun olduğunda olayların bir kısmı ekranda gösterilmez ve “Yüksek yük nedeniyle atlanan: N” satırı görünür. Olayların kendisi yine de kaydedilir; atlama yalnızca ekranı ilgilendirir.

Kişisel verileri görme yetkiniz yoksa olaylardaki e-posta adresleri, telefonlar ve PII özellikleri maskelenir. Ayrıntılar için Profiller makalesine bakın.

Akış, kurulumu kontrol etmek için kullanışlıdır: web sitesini yan sekmede açın, sepete bir ürün ekleyin ve olayın doğru özelliklerle geldiğinden emin olun.

Veri kataloğu

Katalog otomatik olarak doldurulur: projeye yeni bir olay, özellik veya nitelik gelir gelmez belirlenen türüyle burada görünür. Kataloğu menüden veya olaylar sayfasındaki Veri kataloğu düğmesiyle açabilirsiniz.

“Olaylar” sekmesi

Olay tablosu: Olay (ad), Etiket, Toplam (kaç kez geldiği) ve Son görülme (son gelme tarihi). Soldaki ok, olayın özelliklerinin listesini türleriyle birlikte açar, örneğin amount: number.

Veri kataloğu, “Olaylar” sekmesi

“Profil nitelikleri” sekmesi

Nitelikler müşterinin özellikleridir: e-posta, ad, şehir, tarife, doğum tarihi. Sütunlar: Anahtar, Etiket, Tür ve PII.

Veri kataloğu, “Profil nitelikleri” sekmesi

Katalog nasıl ayarlanır

Anlaşılır bir Etiket girin, örneğin order_completed için “Sipariş verdi” veya city için “Şehir”. Değişiklik hemen kaydedilir.
Nitelik için Tür değerini kontrol edin: string (metin), number (sayı), boolean (evet/hayır), datetime (tarih ve saat), list (liste), object (nesne).
Nitelik kişisel veri içeriyorsa (pasaport, adres, doğum tarihi) PII işaretini koyun.

Nasıl kullanılır:

Etiketler segment oluşturucuda anahtarın yanında görünür: “Şehir (city)”. Pazarlamacının teknik adları hatırlaması gerekmez.
Segment koşulları türe bağlıdır: sayılar için “büyüktür” ve “küçüktür”, tarihler için “önce”, “sonra” ve “son”. Tür yanlış belirlendiyse (örneğin tarih metin olarak geldiyse) düzeltin.
PII işaretli nitelikler, kişisel verileri görme yetkisi olmayanlar için maskelenir. E-posta, telefon, adlar ve adres otomatik olarak işaretlenir.

Ayrılmış olaylar

$ işaretiyle başlayan adlar OneTrace.pro için ayrılmıştır. Bu tür bir adla kendi olayınızı gönderemezsiniz; istek hata döndürür.

Olay	Ne zaman görünür
`$page`, `$identify`, `$alias`	`cdp.page()`, `cdp.identify()` çağrıları ve tanımlayıcıların birleştirilmesi
`$segment_entered`, `$segment_exited`	profil segmente girdi veya segmentten çıktı
`$journey_entered`, `$journey_completed`, `$journey_exited`, `$journey_failed`	yolculuğa katılım adımları
`$message_sent`, `$message_delivered`, `$message_failed`, `$message_skipped`, `$message_bounced`, `$message_complained`, `$message_opened`, `$message_clicked`	gönderilen mesajların akıbeti
`$subscribed`, `$unsubscribed`	mesaj izninin değişmesi

Sistem olayları akışta, katalogda ve profil geçmişinde görünür; bunlara göre de kendi olaylarınızda olduğu gibi segment koşulları oluşturabilirsiniz.

Olay adları için öneriler

Olayları Latin harfleriyle, snake_case biçiminde ve geçmiş zamanda adlandırın: order_completed, product_viewed, trial_started.
Değişen verileri ada koymayın: order_1001 değil, order_id özelliğiyle order_completed.
Tutarı para birimi içeren metin olarak değil, sayı olarak gönderin: amount: 9980.