Belgeler

Nasıl çalışır

Gurulu'nun yaptığı hemen her şeyi dört fikir açıklar. Bunlar oturduğunda ürünün geri kalanı yalnızca onların dikkatli bir uygulaması olur.

1. Evren Çekirdeği — ilk günden zorunlu

Gurulu'daki her olay, her satır, her uç aynı alan kümesini taşır. İlk alımdan itibaren. "O sütunu sonra ekleriz" diye bir şey yok. Çekirdek zorunludur.

Zorunlu alanlar:

  • tenant_id — hesabın
  • workspace_id — hesabının içindeki proje
  • anonymous_id ya da person_id — bunu kim tetikledi
  • session_id — ait olduğu ziyaret
  • source_context — nereden geldi: cihaz, tarayıcı, ülke, yönlendiren, kaynak alan adı, UTM
  • confidence — kimlikten ne kadar eminiz
  • consent_state — kullanıcının neye izin verdiği, GCM v2 kategorisine göre
  • health_status — bu olay doğrulama kapısını geçti mi

Bu neden önemli: kullandığımız her analitik platformu zaman içinde alan büyütür. Tarayıcıya göre kırılım almak istediğinde geçmiş olaylarının yarısında o alan yoktur. Evren Çekirdeği, aklına gelebilecek her sorgunun gönderdiğin HER olayda çalışmasını garanti eder — ilki dahil.

Arayüz aşamalı gelir. Verinin şekli sonradan genişlemez.

2. Üç olay sınıfı, asla karışmaz

Olaylar tek bir torba değildir. Üç sınıf vardır ve sisteme girdikleri andan itibaren ayrı tutulurlar.

| Sınıf | Nedir | Nereden gelir | Ne işe yarar | |---|---|---|---| | Etkileşim | Tıklama, sayfa görüntüleme, kaydırma, öfke tıklaması. | Tarayıcı otomatik yakalama. | Davranış. Huniler. Kayıt. Sağlık. | | Niyet | Sepete ekleme. Ödemeye başlama. Başvuruya başlama. Taahhütsüz bir niyet sinyali. | Tarayıcı ya da sunucu. | Kitle kurma. Tahminler. | | Sonuç | Satın alma, kayıt, para hareketi olayı. Asıl önemli olan şey. | Yalnız sunucu. | Atıf. Gelir. Gerçeğin kaynağı. |

Sonuçlar yalnızca senin sunucundan tetiklenir. Tarayıcı bize bir satın almanın gerçekleştiğini söyleyemez — sunucun söyleyebilir. Atıf sayılarına güvenilebilmesinin tek yolu budur.

3. Dört kanal, dört rol, asla karışmaz

Bir olayın Gurulu'ya ulaşmasının tam olarak dört yolu vardır ve her kanalın katı bir rolü vardır:

  • Tarayıcı betiği (@gurulu/web). Sayfayı gözler. Etkileşimleri otomatik yakalar. Sonuç göndermez.
  • Playground. Canlı siten üstünde görsel bir kurucu. Mühendis olmayan birinin bir düğmeyi işaret edip "bu kayıt" demesini sağlar. Kayda bir kural ekler — olay yaratmaz.
  • Sunucu SDK'sı (@gurulu/web identify ve track, artı @gurulu/node). Backend'inden tanımlanmış olayları ve doğrulanmış sonuçları gönderir. Para hareketi buradan gönderilir.
  • Ajan, CLI, MCP sunucusu (@gurulu/cli artı @gurulu/mcp-server). Kayıt farkında. AI editörün kaydı okur ve olay adının bet.placed değil bet_placed olduğunu bilir. Ajan asla olay uydurmaz.

Kanallar katı tutulduğunda iki şey olmayı bırakır: tarayıcıdan gelen güvenilmez sonuçlar ve kod tabanı boyunca olay adı kayması.

4. Olay bir sözleşmedir

Kayıt, olay adları ve şekilleri için gerçeğin kaynağıdır. Bundan üç şey çıkar:

  • Olay anahtarları snake_casetir. Kayıt ^[a-z0-9_]+$ desenini dayatır. bet_placed kabul edilir. bet.placed ve betPlaced reddedilir.
  • SDK serbest metin göndermez. Tipler kayıttan üretilir. Kayıt signup_completedı bilmiyorsa kodun derlenmez.
  • Her olay alımda bir doğrulama kapısından geçer. Dört sonuç mümkündür: kabul, uyarı, karantina, ret. Karar ve gerekçesi kaydedilir.

CI'da kayma pull request'i düşürür. Bozuk olay panoda üç hafta sonra değil, PR incelemesinde yakalanır.

5. Müşterinin tanımladığı atıf

Atıf modelini senin yerine biz seçmeyiz. Bir politika tanımlarsın: ilk temas, son temas, doğrusal, zamanla azalan, konum tabanlı ya da veri odaklı. Geri bakış penceresini sen seçersin. Kanalların nasıl ağırlıklandırılacağını sen seçersin.

Her sonuç bir köken izi taşır. Herhangi bir kredi için şunu sorabilirsin: hangi temas noktaları dikkate alındı, hangileri dışlandı, bu model neden uygulandı ve alternatif modeller neye kredi verirdi.

Bir satışın neden ücretli yerine organik aramaya yazıldığını bilmek istiyorsan cevap veritabanındadır. Kara kutu değildir.

6. Kimlik, açıklanabilir

Kimlik motoru, yedi adımlık kanıt uyuştuğunda iki kaydı birleştirir. Her birleştirme:

  • Geri alınabilir. Birleştirme defteri yalnızca ekleme yapılan bir defterdir. Ayırmak tek bir yazmadır.
  • Güven puanlıdır. Her birleştirmenin bir düzeyi vardır — yüksek, orta, düşük — ve bir sinyal listesi.
  • Denetlenebilir. İki kaydın ne zaman, hangi kanıtla ve hangi kanalda birleştiğini görebilirsin.

İnanarak güvendiğin şeffaf olmayan bir "kullanıcı grafiği" yok. Okuyabildiğin bir defter var.

7. Varsayılan gizlilik

Bölge varsayılanı AB'dir. Ücretsiz katman da ücretli katmanlarla aynı AB ikametgâhını alır. İzin durumu her olayda Google Consent Mode v2 kategorileriyle yakalanır ve boru hattı, kullanıcının izin verdiğine göre alt akış hedeflerini filtreler. DSR dışa aktarma ve unutulma talepleri 60 saniyelik SLA kuyruğunda koşar.

İhtiyacımız olmayanı yakalamayız. Hassas yüzeyler — ödeme sayfaları, KYC, hesap ayarları — kayıtta varsayılan olarak maskelenir. Yakalamayı genişletebilirsin; varsayılan dardır.

Sırada ne var

Belgelere dön