SDK ve API

Browser SDK

Install, init, track, identify, queue/retry, sendBeacon, cookie behavior ve opt-out.

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

Bu özellik ne işe yarar?

Browser SDK, Testvoy içinde sdk ve api akışının karar vermeye hazır hale gelmesini sağlar. Amaç sadece ayarı bulmak değil; ekiplerin neyi neden yaptığını, sonucu nasıl okuyacağını ve hata olduğunda nereden başlayacağını bilmesidir.

Ne zaman kullanacağını bil

Ekranda hangi alanları göreceğini öğren

Başarılı olduğunu nasıl anlayacağını netleştir

Browser SDK ekran akışı
SetupQARapor
Gerçek screenshot eklendiğinde bu frame ürün ekranıyla değiştirilebilir.

Ne zaman kullanılır?

Bu rehberi, ilk kurulumda, yeni bir deney hazırlarken, rapor yorumlarken veya müşteri/ekip paylaşımı öncesinde kontrol listesi gibi kullan. Testvoy’un sade yüzeyi teknik olmayan kullanıcıyı yönlendirirken geliştiriciye de event, SDK ve güvenlik bağlamını açık bırakır.

  1. 01

    İlgili workspace ve project’i seç

  2. 02

    Bu sayfadaki checklist’i uygula

  3. 03

    Preview veya verifier ile doğrula

  4. 04

    Raporu ya da ayarı ekip içinde paylaş

Nasıl yapılır?

Testvoy’da çoğu işlem aynı mantığı izler: önce bağlamı seç, sonra kuralı veya değişikliği tanımla, son olarak QA ve rapor tarafında sonucu doğrula. Bu yapı, ürünün test çalıştırmaktan çok karar kalitesine odaklanmasını sağlar.

  • Workspace doğru mu?
  • Project key veya domain doğru mu?
  • Goal/event eşleşiyor mu?
  • Mobile ve desktop ayrı kontrol edildi mi?
  • Bot/SRM veya dropped event uyarısı var mı?
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>

Örnek kurulum: script'i head içinde title'ın hemen altına ekle

Testvoy SDK snippet'i, deney varyantlarının mümkün olduğunca erken değerlendirilebilmesi için sayfanın head alanına eklenmelidir. Pratik yerleşim: önce title, hemen altına Testvoy script'i, ardından meta description ve diğer head etiketleri. Böylece SDK sayfa yüklenirken erken başlar, ama async olduğu için render'ı bloklamaz.

  1. 01

    Testvoy app içinde Project settings > SDK setup ekranını aç

  2. 02

    Project key değerini kopyala

  3. 03

    Site template'inde head etiketini bul

  4. 04

    title etiketinin hemen altına Testvoy script'ini yapıştır

  5. 05

    PROJECT_KEY_HERE alanını gerçek project key ile değiştir

  6. 06

    Deploy et ve /docs/install/verify-installation adımlarından SDK loaded kontrolünü yap

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>

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

Browser SDK 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.