İzleyiciyi ekleyin
Sitenizin script etiketini kurun ve olayların geldiğini kontrol edin. Toplamayı etkinleştirmeden önce onay gereksinimlerinizi gözden geçirin.
1. Kod parçanızı kopyalayın
Oturum açın, web sitenizi açın ve Settings → Installation → Scripts yoluna gidin. Kod parçanız, kendi site belirtecinizle (token) şöyle görünür. Burada gösterilen Minimal biçim seçeneklerini Installation → Dashboard bölümünden okur; Explicit biçim aynı seçenekleri script öznitelikleri olarak yazar (bkz. Kod parçası seçenekleri).
<script defer src="https://app.seean.io/k.js"
data-site="YOUR_SITE_TOKEN"
data-api="https://app.seean.io"></script>Installation bölümünde birinci taraf toplama etkinleştirilmediği sürece hem script hem de API adreslerini yukarıdaki gibi https://app.seean.io üzerinde tutun; etkinleştirildiğinde, oluşturulan <slug>-collect.seean.io ana bilgisayar adı ya da kendinize ait etkin bir özel toplama alanı her ikisi için kullanılır. Bu adresleri kullanan mevcut bir kod parçasının, Seean altyapısını güncellediğinde değişmesi gerekmez.
2. </head> öncesine yapıştırın
Ölçmek istediğiniz her sayfa için ortak HTML belgesini veya kök yerleşimi kullanın. Doğru yerleşim için platform rehberinizi izleyin. İzleyiciyi bir kez kurun: hem bir yerleşim hem de bir etiket yöneticisi kullanmak ziyaretleri iki kez sayabilir.
İzleyici, / → /pricing gibi desteklenen History API gezinmelerini izler. Sorgu dizeleri sayfa yolunun parçası değildir; data-hash="true" ayarlamadığınız sürece hash parçaları yoksayılır. Değişen bir etiketli kampanya veya süresi dolan bir oturum yine de yeni bir oturum başlatabilir ve aynı yol adını yeniden sayabilir. İzleyiciyi klasik bir harici script olarak yükleyin; uygulama paketinize içe aktarmayın veya type="module" eklemeyin.
3. Doğrulayın
Yayındaki siteyi normal bir tarayıcı sekmesinde açın, sonra eşleşen web sitesi için Settings → Installation → Setup health bölümünü kontrol edin. Last pageview received saklanan en yeni sayfa görüntülemesinin zamanını gösterir; herhangi bir sayfa görüntülemesinden önce Installation verified, yayındaki sayfanın kontrolü en son ne zaman geçtiğini gösterir. Yayındaki ana sayfada izleyiciyi, belirteci ve güvenlik politikasını incelemek için Check installation kullanın. Seean yayındaki ana sayfayı arka planda otomatik olarak da kontrol eder (web sitesinin ilk gününde her dakika); böylece kurulum, panel kapalı olsa bile kod parçası yayınlandığı anda doğrulanır. Genel bakış banner’ı bir ziyaret beklemeden kaybolur.
Bir kaynak referansı veya eski bir ziyaret, son dağıtımınızın çalıştığını kanıtlamaz. Kurulum kontrollerini kullanarak Events bölümünde yeni bir sayfa yolu ve zamanı eşleştirin. Kurulum tanılama rehberi sonuçları, izinleri ve sınırları açıklar.
Kod parçası seçenekleri
Installation → Dashboard, web sitesinin izleme seçeneklerini tutar: UTM kampanyaları (açık), hash sayfa yolları (kapalı), Web Vitals (açık), otomatik dönüşümler (yeni ve hiç yapılandırılmamış web siteleri için açık), hata ayıklama günlüğü (kapalı) ve alanlar arası ana bilgisayar adları. Save tracking options bunları kaydeder; minimal bir kod parçası bunları bir sonraki sayfa yüklemesinde uygular. Explicit kod parçası biçimi aynı seçimleri öznitelik olarak yazar:
| Öznitelik | Varsayılan | Etki |
|---|---|---|
data-conversions="true" |
ham HTML’de kapalı | Etkin otomatik dönüşüm ön ayarlarını belge başına bir kez yükler. Oluşturulan explicit kod parçaları, Auto conversions açıkken bunu içerir. |
data-hash="true" |
kapalı | location.hash değişikliklerini sayfa görüntülemesi olarak sayar ve yolu parçasıyla birlikte raporlar, örneğin /docs#install. |
data-utm="off" |
açık | utm_source, utm_medium ve utm_campaign okumayı durdurur; etiketli bir bağlantı artık yeni oturum başlatmaz. |
data-vitals="off" |
açık | Web Vitals ölçümünü tamamen atlar (performans gözlemcisi yok). |
data-debug="true" |
kapalı | Her yükü gönderilmeden önce console.debug ile yazar. Konsol yokken güvenlidir. |
data-domains="a.com,b.com" |
kapalı | Alanlar arası aktarım: listelenen ana bilgisayarlara (ve alt alanlarına) giden bağlantılar ziyaretçi kimliğini taşır ve bir açılış sayfası gelen kimliği benimser. |
Bu özniteliklerden herhangi biri bulunduğunda, o sayfa için panel seçenekleri yoksayılır. Ayrıntılar ve varsayılanlar: Script ve izleme seçenekleri.
İzleyici ne gönderir
| Alan | Nedir |
|---|---|
| path | sayfa yolu, sorgu dizesi olmadan (data-hash açıkken parçayla birlikte) |
| hostname | ölçülen web sitesi |
| referrer | tarayıcının yönlendiren URL’si; toplayıcı yalnızca ana bilgisayar adını saklar |
| timezone | ağ ucu ülke bildirmediğinde ülke için yedek |
| visitorId, sessionId | varsayılan kimlikler sunucuda web sitesi ve UTC günü başına türetilir; isteğe bağlı alanlar arası aktarım kimliği aynı gün oturum depolamasında taşır |
| campaign | varsa UTM source, medium, campaign, term ve content, data-utm="off" değilse |
| click id | açılış URL’sinde bulunan bir reklam tıklama kimliği parametresinin adı (gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid); değer hiçbir zaman okunmaz. data-utm="off" ile kapalı |
| title | document.title, ilk 200 karakter |
| uid | seean.identify(id) sonrasında kendi kullanıcı kimliğiniz; yalnızca web sitesi için Identify users etkinken saklanır |
| screen | screen.width x screen.height |
| Web Vitals | LCP, INP, CLS, FCP ve TTFB; sonraki ölçümler bir örneği güncelleyebilir. data-vitals="off" ile kapalı |
Toplayıcı ülke, bölge ve şehri isteğin ağ ucu başlıklarından okur, tarayıcı, işletim sistemi ve cihaz kategorileri için kullanıcı aracısını kullanır, tarayıcının ilk Accept-Language etiketini ziyaretçi dili olarak kaydeder ve o dilin bölgesini ülke için yedek olarak kullanabilir. IP adresi yalnızca hariç tutma kurallarıyla karşılaştırılır ve hiçbir zaman saklanmaz. UTM alanları ve tıklama kimliği adı dışındaki sorgu dizeleri hiçbir zaman toplanmaz.
Varsayılan izleme, çerez veya kalıcı tarayıcı ölçüm depolaması olmadan web sitesine özgü günlük bir sunucu karması (hash) kullanır. İsteğe bağlı alanlar arası aktarım aynı gün sessionStorage kullanır. Do Not Track, Global Privacy Control veya Hariç tutmalar bölümünde anlatılan tarayıcı vazgeçmesi için toplama durur. Onay veya vazgeçme geçerli olduğunda script yüklemesini sitenizin onay mekanizmasıyla denetleyin. Bkz. teknik gizlilik ve depolama ve onay.
Yerel geliştirme
Script etiketine data-local eklemediğiniz sürece izleyici localhost ve 127.0.0.1 adreslerini yoksayar. Test trafiği için ayrı bir Seean web sitesi/belirteci kullanın ve API adresini o sitenin kod parçasından kopyalayın. Otomatik tarayıcılar, Do Not Track, Global Privacy Control ve tarayıcı vazgeçmesi toplamayı yine durdurabilir; data-local bu kontrolleri devre dışı bırakmaz.
Bir kurulumu kaldırın veya güncelleyin
O kurulumdan gelecek toplamayı durdurmak için scripti yerleşiminden veya etiket yöneticisinden kaldırın ve değişikliği yayınlayın. Mevcut raporlar kalır. Bir sitenin izleme belirtecini döndürmek eski kod parçalarını anında geçersiz kılar; her kurulumu yeni belirteçle güncelleyin. Bkz. web sitesi ayarları.
Anlaşılmayan bir yer mi var? Destekle iletişime geçin.