03Başlarken
Kurulumu doğrulama
Gauss izleyicisinin çalıştığını doğrulama — konsolda hata ayıklama modu, Network sekmesindeki istekler ve etkinliklerin görünmemesinin sık nedenleri.
Kurulumu doğrudan tarayıcıda birkaç dakikada kontrol edebilirsiniz: hata ayıklama modunu açın, izleyicinin hangi etkinlikleri yazdığına ve sunucuya hangi isteklerin gittiğine bakın.
Hata ayıklama modu
Hata ayıklamayı açmanın iki yolu var:
- sayfa adresine
?gauss_debug=1ekleyin, örneğinhttps://example.com/?gauss_debug=1; - ya da snippet'e
data-debugözniteliğini ekleyin:
<script defer data-debug data-site="YOUR_SITE_ID" src="https://collect.gausslab.io/js/gauss.js"></script>Tarayıcı konsolunu açın (DevTools → Console). İzleyici her etkinliği göndermeden önce [gauss] önekiyle yazar: etkinlik adı ve sunucuya giden nesne.
[gauss] page_view {v: 1, site: "k3f9x2ab", name: "page_view", page_location: "https://example.com/", …}
[gauss] user_engagement {v: 1, site: "k3f9x2ab", name: "user_engagement", params: {engagement_time_msec: 48200, scroll_depth_pct: 75}, …}?gauss_debug=1 bayrağı cihazda hiçbir şey saklamaz: izleyici adresi sayfa yüklenirken kontrol eder, bu yüzden hata ayıklama sayfa bu parametreyle açıldığı sürece çalışır. İşiniz bitince data-debug özniteliğini kaldırmayı unutmayın.
localhost ve diğer hariç tutulan ortamlarda hata ayıklama modu etkinlikleri yine yazar, ama göndermez. Böylece özel etkinliklerinizi yayından önce kontrol edebilirsiniz.
[gauss] dropped … uyarıları hata ayıklama modu kapalıyken de her zaman yazılır: izleyici bu şekilde geçersiz adlı bir etkinliği veya fazla bir parametreyi attığını bildirir.
Network sekmesi
- DevTools → Network sekmesini açın ve sayfayı yenileyin.
- Filtreye
api/eventyazın. POST https://collect.gausslab.io/api/eventisteğini bulun.
Her etkinlik ayrı bir istektir. Gövde JSON'dur ve text/plain olarak gönderilir; bu yüzden tarayıcı CORS ön kontrol isteği yapmaz. İzleyici etkinlikleri navigator.sendBeacon ile, o yoksa keepalive seçenekli fetch ile gönderir. Chrome'da sendBeacon istekleri ping türüyle görünür.
user_engagement etkinliğini görmek için başka bir sekmeye geçip geri dönün: etkinlik sayfa gizlendiğinde gönderilir. DevTools'ta Preserve log seçeneğini açın, yoksa sayfadan ayrılırken yapılan istekler listeden kaybolur.
Etkinlikler neden görünmüyor
| Neden | Ne kontrol edilmeli |
|---|---|
| Site yerelde çalışıyor | localhost, 127.*, *.local ve file: etkinlik göndermez. Yayımlanmış sitede test edin veya hata ayıklama modunu kullanın |
| Site oluşturucu önizlemesi | düzenleyicide ve önizlemede site bir <iframe> içinde çalışır, etkinlik gitmez. Yayımlanmış sürümü açın |
| Reklam veya izleyici engelleyici | eklentileri kapatın ya da sayfayı eklentisiz bir tarayıcı profilinde açın |
| Content Security Policy | konsolda CSP ihlali hatası görünür. https://collect.gausslab.io adresini script-src ve connect-src içine ekleyin, bkz. Kurulum |
| Hatalı Site ID | biçim geçersizse izleyici başlamaz ve hiçbir şey yazmaz. Aşağıdaki kontrole bakın |
| Snippet bazı sayfalarda yok | sayfa kaynağına bakın: etiket <head> içinde olmalı |
| Snippet iki kez eklenmiş | her geçiş iki page_view üretir; tek etiket bırakın |
Site ID'yi kontrol etmek için sayfanın konsolunda şunu çalıştırın:
const id = document.querySelector('script[data-site]')?.dataset.site;
console.log(id, /^[a-z0-9]{8,16}$/.test(id || ''));Sonuç false ise data-site içinde fazladan bir karakter, boşluk veya büyük harf var: Site ID 8–16 küçük Latin harfi ve rakamdan oluşur. Sonuç true olduğu hâlde etkinlik yoksa değeri hesabınızdaki Site ID ile karşılaştırın.
Bir kontrol daha: sayfa yüklendikten sonra konsolda typeof gauss çalıştırın. İzleyici başladıysa sonuç "function" olur ve fonksiyonun q özelliği yoktur. gauss.q bir diziyse yalnızca kuyruk betiği çalışıyor, izleyicinin kendisi başlamamış demektir: betik engellenmiş veya Site ID geçersiz.
Panelde kontrol
Gauss paneli şu anda kapalı betada. Erişim için beta başvurusu sayfasından başvurun.
- İlk etkinliği bekleme ekranı. Site eklendikten sonra panel ilk etkinliği bekler ve kurulum durumunu gösterir. Durum, ilk etkinlikten en geç 10 saniye sonra güncellenir; 24 saat boyunca veri gelmezse panel bunu da gösterir.
- Canlı etkinlik akışı. Sitenin son etkinlikleri gönderildikten en geç 5 saniye sonra akışta görünür. Her etkinlik, işlendikten sonra saklandığı hâliyle JSON olarak açılır. Reddedilen etkinlikler de nedeniyle birlikte akışta görünür. Akışı owner ve admin rollerindeki üyeler görür.