Umami

Açıklama

**Umami** (açık kaynak, çerezsiz web ve ürün analitiği; kurum içi ya da Umami Cloud) için Gateclave entegrasyonu. Umami REST API üzerinden, API anahtarı ile çalışır. **Neler yapılabilir** - Siteler: liste, ayrıntı, veri tarih aralığı, kayıt ayarları, süzgeç değerleri; tarihli site notları - Genel bakış: özet istatistik (görüntüleme, ziyaretçi, ziyaret, hemen çıkma, süre) ve dönem karşılaştırması, aktif ziyaretçi, zaman serisi, sayfa/yönlendiren/ülke/tarayıcı/UTM gibi boyutlara göre sıralı metrikler, gerçek zamanlı görünüm - Olay ve oturum listeleri, oturum etkinlik akışı; özel olay ve oturum verisi (event/session data) analizleri - Core Web Vitals performansı ve gelir raporları - Kırılım, yolculuk, tutunma, atıf, UTM ve ısı haritası analizleri; kayıtlı huniler, hedefler, segment ve kohortlar - Oturum kayıtları (session replay), panolar, izlenen bağlantılar ve pikseller, paylaşımların denetimi - Ekipler ve üyeleri; kurum içinde kullanıcılar ve yönetici listeleri **Onaylı işlemler:** site, not, huni, hedef, segment, pano, bağlantı ve piksel oluşturma/güncelleme; ekip oluşturma ve yeniden adlandırma; kişisel pano; kayıt saklama; paylaşım güncelleme. **Yıkıcı işlemler:** her silme (site, kullanıcı, ekip, oturum, kayıtlı tanımlar, API anahtarı dahil); üyeyi ekipten çıkarma; site verisini sıfırlama; site devri; herkese açık paylaşım oluşturma. Bilerek dışarıda: API anahtarı oluşturma (anahtarı düz metin döndürür); kullanıcı oluşturma, rol/parola değiştirme, ekibe üye ekleme ya da rol yükseltme, katılım koduyla ekibe girme ve 2FA ayarları (Gateclave'in kendi erişimini genişletebilir); veri toplama uçları (`/send`, `/batch`, `/record` — sahte trafik üretir); paylaşım token'ı döndüren kısa ad ucu; base64 ZIP dönen dışa aktarma. Kiracı yoktur; ekip (teamId) bir kaynak seçimidir. Bağlayıcı hedefi kurum içinde `https://<sunucu>/api`, Umami Cloud'da `https://api.umami.is/v1` (bölge için `/v1/eu`, `/v1/us`). Cloud'da anahtar başına 15 saniyede 50 çağrı sınırı vardır; `/users` uçları yalnız kurum içinde çalışır. ## Kaynak - API belgesi: https://umami.is/docs/api (docs.umami.is API Reference, Umami v3 REST API; şema ayrıntıları: https://github.com/umami-software/umami/blob/master/src/lib/schema.ts) - Kimlik: static bearer — Umami'de Settings → API keys → Create key ile oluşturulan API anahtarı, `Authorization: Bearer <api-key>` (kurum içi ve Umami Cloud'da aynı) - Doğrulanmadı: Cloud hedefinin `https://api.umami.is/v1` (bölge `/v1/eu`, `/v1/us`) ile öneksiz araç yollarının birleşmesi ve kurum içinde `/api` önekinin hedefe yazılması; yönetici (`/admin/*`) uçlarının Cloud'da kapalı olması; `/me/api-keys` uçlarının Cloud'daki davranışı; hedef türü değerleri (path/event); kırılım `fields` ve huni `steps` sorgu parametrelerinin JSON metin biçimi; paylaşım `parameters` alanları ve `shareType` sayıları (1 site, 2 bağlantı, 3 piksel, 4 pano); `replayConfig` alanları; pano türleri ve `parameters` yapısı; oturum silmenin yalnız ilişkisel veritabanlı kurulumlarda çalışması; enum değerlerinin bir kısmı belge sayfası yerine depo şemasından alındı - Logo: https://github.com/umami-software/umami/blob/master/public/android-chrome-512x512.png

Bu sürümdeki tool'lar

Kurulumda bunların hangilerini bağlayacağınızı siz seçersiniz — seçmediğiniz tool sisteminize hiç girmez.

Uç ayrıntıları (yol, sorgu, parametreler) katalogda gösterilmez; üreticinin API yüzeyi herkese açık bir liste değildir. Kurduğunuzda kendi panelinizde tamamını görürsünüz.

Sürümler

Nasıl kurulur

Kendi Gateclave panelinizde Marketplace ekranını açın ve bu ürünün manifestini içe aktarın. Kurulum iki adımdır: bağlantı bilgisi (hedef + Vault'tan seçilen kimlik), ardından bağlanacak tool'ların seçimi. Yeni sürüm çıktığında Yükselt ile geçersiniz — bağlayıcılarınız, kimlik referanslarınız ve tool seçiminiz korunur.

Katalogdan tek tıkla kurulum ve otomatik güncelleme bildirimi bir sonraki aşamada devreye girecek.