Kurulum

Gauss izleyicisi tek satırla kurulur. Kurulumdan sonra sayfa görüntülemelerini, sayfada geçen süreyi, dış bağlantı ve iletişim bağlantısı tıklamalarını ve form gönderimlerini kendisi gönderir; çerez ve tarayıcı depolaması kullanmaz.

Site ID nereden alınır

Site ID, sitenin kısa kimliğidir: 8 ile 16 karakter arası, yalnızca küçük Latin harfleri ve rakamlar. Hesabınızda site eklediğinizde hazır snippet ile birlikte verilir.

Gauss paneli şu anda kapalı betada. Erişim ve Site ID almak için beta başvurusu sayfasından başvurun.

Snippet

Bu satırı sitenizin her sayfasının <head> bölümüne ekleyin ve YOUR_SITE_ID yerine kendi Site ID'nizi yazın:

<script defer data-site="YOUR_SITE_ID" src="https://collect.gausslab.io/js/gauss.js"></script>

defer özniteliği sayesinde betik sayfayla paralel indirilir ve HTML ayrıştırıldıktan sonra çalışır; sayfanın görüntülenmesini engellemez.

Yakında. Kendi alan adınız üzerinden çalışma (first-party proxy): betik ve etkinlik alımı stats.siteniz.com gibi bir adresten yapılır.

Snippet'i yalnızca bir kez ekleyin: sayfadaki iki etiket her geçişte iki görüntüleme üretir.

Site oluşturucular ve CMS'ler

Kural her yerde aynı: snippet tüm sayfaların <head> bölümüne girmelidir. Platformların menü adları sürümden sürüme değiştiği için aşağıda kesin yol değil, nereye bakılacağı yazıyor.

• WordPress — satırı tema başlığına (header.php, </head> öncesi) ekleyin ya da header'a kod ekleyen herhangi bir eklentiyi kullanın. Tema dosyasına eklenen kod tema güncellenince kaybolabilir; bu yüzden eklenti veya alt tema daha güvenlidir.
• Shopify — tema kodunda, theme.liquid dosyasında, </head> öncesine.
• Tilda, Webflow, Wix — site ayarlarında <head> için özel kod bölümü bulunur. Snippet'i oraya yapıştırın ve siteyi yeniden yayımlayın.

Site oluşturucudaki düzenleme ve önizleme modları etkinlik göndermez: bu önizlemeler bir <iframe> içinde açılır ve izleyici iframe içinde çalışmaz. Yayımlanmış sitede test edin.

SPA: React, Vue, Next.js ve diğerleri

Tek sayfalı uygulamalar için ek ayar gerekmez. İzleyici History API'yi (pushState, replaceState, popstate) izler ve adres her değiştiğinde bir page_view gönderir. Temizlenmiş adres aynı kalırsa tekrar görüntüleme gönderilmez.

Snippet'i ortak şablona bir kez eklemek yeterli: Vite veya Create React App için index.html, Next.js'te kök layout, diğer çerçevelerde app.html veya karşılığı.

Yakında. Hash yönlendirme (/#/catalog). Şu anda adresin # sonrasındaki kısmı atılır ve yalnızca hash'i değiştiren geçişler ayrı görüntüleme sayılmaz.

Content Security Policy

Siteniz Content-Security-Policy başlığı gönderiyorsa, betiğin yüklenmesi ve etkinliklerin gönderilmesi için Gauss alan adına izin verin:

script-src 'self' https://collect.gausslab.io;
connect-src 'self' https://collect.gausslab.io;

script-src, gauss.js dosyasının yüklenmesi için; connect-src, etkinlikleri taşıyan istekler için gerekir. Özel etkinlikler için satır içi kuyruk betiğini eklerseniz, her satır içi betik gibi onun da script-src içinde bir nonce veya hash'e ihtiyacı olur. data-api kullanıyorsanız o adresi connect-src içine yazın.

Yerel geliştirme

localhost, 127.*, *.local adresleri, file: ile açılan dosyalar ve otomatik tarayıcılar etkinlik göndermez. Testleriniz istatistiklere girmez, ama yerel kurulumu raporlardan doğrulamak da mümkün olmaz. Etkinlikleri yayından önce görmek için Kurulumu doğrulama sayfasına bakın.

Sonraki adımlar

• Otomatik olarak toplananlar — izleyicinin kendisi gönderdiği etkinlikler.
• Kurulumu doğrulama — etkinliklerin gittiğinden nasıl emin olunur.
• Özel etkinlikler — başvurular, kayıtlar, buton tıklamaları.
• Hangi veriler toplanır — izleyicinin ne gönderdiği ve ne göndermediği. Ziyaretçi onayının gerekip gerekmediğine site sahibi kendi avukatıyla birlikte karar verir; bkz. Ziyaretçi verileri bildirimi ve Veriler ve gizlilik.