Kurulum

JavaScript SDK kurulumu

Testvoy Browser SDK’yı CDN üzerinden güvenli şekilde kur ve ilk event’i doğrula.

Son güncelleme: 22 Mayıs 20268-14 dkBaşlangıç ve orta seviye
Ücretsiz başla Paketleri görMetodoloji

Browser SDK ne yapar?

Browser SDK, ziyaretçiyi doğru deney varyantına atar, görsel editör değişikliklerini uygular, goal event'lerini taşır ve raporlama için gerekli deney bağlamını imzalı şekilde iletmeye yardımcı olur. Kurulumun amacı sayfaya sadece bir script eklemek değil; deney motoru, event hattı ve doğrulama ekranını birlikte çalışır hale getirmektir.

Versioned CDN path ile öngörülebilir dağıtım

Project key ile doğru proje bağlamı

Anti-flicker odaklı yükleme

Queue/retry ve sendBeacon destekli event akışı

JavaScript SDK snippet
<head>
  <title>Mağaza Adı | Online Alışveriş</title>
  <script
    async
    src="https://cdn.testvoy.com/sdk/v1/testvoy.min.js"
    data-project-key="PROJECT_KEY_HERE">
  </script>
  <meta name="description" content="Ürünleri keşfet ve güvenle satın al." />
</head>
SDK kurulum ekranı
CDNProject keyVerifier
Project key, domain match ve recent event kontrolü aynı doğrulama akışında okunur.

Snippet nereye eklenir?

Snippet'i mümkünse tüm deney yapılacak sayfalarda head alanına ekle. Async yükleme sayfanın render edilmesini bloklamaz; yine de kritik hero değişikliklerinde preview ve QA ile flicker riskini kontrol et. GTM kullanıyorsan aynı SDK'nın hem tema kodunda hem tag manager'da iki kez yüklenmediğinden emin ol.

  • Snippet tüm ilgili sayfalarda var mı?
  • Project key production projesine mi ait?
  • Staging ve production key karışmadı mı?
  • SDK iki kez yüklenmiyor mu?
  • Domain Testvoy project ayarıyla eşleşiyor mu?

Pratik senaryo

Bir growth ekibi pricing sayfasındaki CTA metnini değiştirir, signup_started ve signup_completed hedeflerini bağlar, Google Ads ve returning visitor segmentlerini ayrı okur. Sonuç olumluysa rapor linkini müşteri veya yönetimle paylaşır.

Sık yapılan hatalar

Hataların çoğu yanlış project key, fazla genel selector, eksik goal, staging/prod karışıklığı, küçük örneklemle erken karar veya mobile görünümü kontrol etmemekten çıkar.

Deneye 'test' gibi belirsiz ad vermek

Goal olmadan deney başlatmak

Sadece toplam CVR ile karar vermek

Shareable report yerine ekran görüntüsü göndermek

Sık sorulan sorular

JavaScript SDK kurulumu hangi ekipler için uygun?

Marketing, growth, product ve developer ekipleri aynı rehberi farklı derinlikte kullanabilir.

Bu işlem için developer gerekir mi?

Basit görsel değişiklikler ve rapor okuma için gerekmez; SDK, custom event, custom JS veya enterprise security konularında teknik destek faydalıdır.

Başarılı olduğunu nasıl anlarım?

Verifier, recent events, preview, QA checklist ve rapor uyarıları başarılı kurulum ve deney durumunu gösterir.

Sık hata nedir?

Yanlış project key, eksik goal, kırılgan selector, küçük örneklemle erken karar ve mobile QA eksikliği en sık görülen hatalardır.

Dokümanlar

Bu rehberi uygulamada dene

Kurulumu tamamla, ilk deneyini oluştur ve raporu Testvoy içinde temiz veriyle oku.