Özel Alan Adları

Bazı ağlar ve tarayıcı uzantıları, üçüncü taraf analitik alan adlarına giden istekleri engeller: kurumsal filtreler, DNS düzeyinde engelleyiciler, bölgesel kısıtlamalar, gizlilik uzantıları. Kendi alt alan adınızdan sunulduğunda betik, sitenizde first-party bir istek olur ve bu ortamlarda çalışmayı sürdürür.

Özel alan adı, TRACIO edge'ine yönlendirilmiş, denetiminizdeki bir alt alan adıdır — örneğin metrics.yoursite.com. DNS ve sertifika doğrulandıktan sonra betik, paketi ve sinyal istekleri bu alt alan adından sunulur. Bir proxy çalıştırmanız gerekmez.

Etkinleştirme Nasıl Çalışır

1. Alt alan adını panelde eklersiniz ve panelin gösterdiği A kayıtlarını DNS sağlayıcınızda oluşturursunuz.
2. TRACIO kayıtları algılar ve alt alan adı için otomatik olarak bir TLS sertifikası düzenler.
3. Betiği bu alt alan adından public key'inizle yükleyen bir sayfaya yapılan ilk ziyaret, host'u etkinleştirir.

Panel bu üç aşamayı — A kayıtlarını, sertifikayı ve anahtarınızla yapılan ilk ziyareti — gösterir ve otomatik olarak yeniden denetler. Check now yeniden denetlemeyi anında zorlar.

Özel Alan Adı Kurulumu

1. Get Started bölümünü açın ve Install the SDK and send your first event adımını genişletin. İlk maddesi betiğin nereden yükleneceğini sorar: Your own subdomain seçeneğini seçin ve alt alan adını girin. Aynı sihirbaz Settings → Custom Hosts altında da bulunur.
2. Panelde gösterilen A kayıtlarını DNS sağlayıcınızda ekleyin. Alan adınız Cloudflare üzerindeyse kayıtları proxy kapalıyken ekleyin (gri bulut, yalnızca DNS): proxy açıkken Cloudflare adresleri değiştirir ve istekler TRACIO'ya ulaşmaz.
3. DNS ve Sertifika aşamaları doğrulanana kadar bekleyin. Yayılma ve sertifika düzenlenmesi birkaç dakikadan birkaç saate kadar sürer.
4. Parçacığı sayfalarınıza yerleştirin. Anahtarınızla yapılan ilk ziyaret host'u etkinleştirir.

Siteniz hâlihazırda paylaşılan alan adı üzerinden takip yapıyorsa, etiketi ancak DNS ve Sertifika aşamaları doğrulandıktan sonra değiştirin: o ana kadar betik yeni alt alan adından yüklenmez.

Parçacıklar

Betik etiketi:

<script src="https://metrics.yoursite.com/s.js?k=PUBLIC_KEY" async></script>

npm paketleri: alt alan adını endpoint olarak geçirin. SDK betiği oradan yükler ve sinyalleri oraya gönderir. endpoint ayarlandığında region seçeneği yok sayılır. Bunun için scriptUrl kullanmayın: o, public key dahil betiğin URL'sinin tamamını değiştirir.

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "PUBLIC_KEY",
  endpoint: "https://metrics.yoursite.com",
})

Framework paketleri aynı endpoint seçeneğini kabul eder — SDK sayfalarına bakın.

Sınırlar

• Denetiminizde olan ve başka hiçbir şey sunmayan bir alt alan adı kullanın — örneğin metrics.yoursite.com.
• Cloudflare üzerinde kayıtlar yalnızca DNS (gri bulut) olmalıdır.
• Başka bir çalışma alanında etkin olan bir alt alan adı eklenemez.

Sonraki Adımlar

• Hızlı Başlangıç — SDK'yı kurun ve ilk sonucunuzu okuyun
• Sorun Giderme — engellenen istekler ve çerez sorunları